From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Tue, 12 Apr 2022 13:33:05 +0000 (+0200)
Subject: man: add "internal" to "reference counter"
X-Git-Tag: v251-rc2~136^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=52e30c6f8169cd9c96cb2a62a9792bda79dcdf8f;p=thirdparty%2Fsystemd.git

man: add "internal" to "reference counter"
---

diff --git a/man/sd_bus_message_new.xml b/man/sd_bus_message_new.xml
index 4907c5a7559..c56df615a6b 100644
--- a/man/sd_bus_message_new.xml
+++ b/man/sd_bus_message_new.xml
@@ -99,14 +99,13 @@
     <citerefentry><refentrytitle>sd_bus_message_set_allow_interactive_authorization</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
     </para>
 
-    <para><function>sd_bus_message_ref()</function> increases the reference counter of
+    <para><function>sd_bus_message_ref()</function> increases the internal reference counter of
     <parameter>m</parameter> by one.</para>
 
-    <para><function>sd_bus_message_unref()</function> decreases the reference counter of
+    <para><function>sd_bus_message_unref()</function> decreases the internal reference counter of
     <parameter>m</parameter> by one. Once the reference count has dropped to zero, message object is
-    destroyed and cannot be used anymore, so further calls to
-    <function>sd_bus_message_ref()</function> or <function>sd_bus_message_unref()</function> are
-    illegal.</para>
+    destroyed and cannot be used anymore, so further calls to <function>sd_bus_message_ref()</function> or
+    <function>sd_bus_message_unref()</function> are illegal.</para>
 
     <para><function>sd_bus_message_unrefp()</function> is similar to
     <function>sd_bus_message_unref()</function> but takes a pointer to a
diff --git a/man/sd_bus_slot_ref.xml b/man/sd_bus_slot_ref.xml
index c200bc4a5a9..8ada3cbcf1c 100644
--- a/man/sd_bus_slot_ref.xml
+++ b/man/sd_bus_slot_ref.xml
@@ -46,10 +46,10 @@
   <refsect1>
     <title>Description</title>
 
-    <para><function>sd_bus_slot_ref()</function> increases the reference counter of
+    <para><function>sd_bus_slot_ref()</function> increases the internal reference counter of
     <parameter>slot</parameter> by one.</para>
 
-    <para><function>sd_bus_slot_unref()</function> decreases the reference counter of
+    <para><function>sd_bus_slot_unref()</function> decreases the internal reference counter of
     <parameter>slot</parameter> by one. Once the reference count has dropped to zero, slot object is
     destroyed and cannot be used anymore, so further calls to <function>sd_bus_slot_ref()</function>
     or <function>sd_bus_slot_unref()</function> are illegal.</para>
diff --git a/man/sd_device_ref.xml b/man/sd_device_ref.xml
index b7ed4d985cb..c2ba6b15711 100644
--- a/man/sd_device_ref.xml
+++ b/man/sd_device_ref.xml
@@ -42,10 +42,10 @@
       </funcprototype>
     </funcsynopsis>
 
-    <para><function>sd_device_ref()</function> increases the reference counter of
+    <para><function>sd_device_ref()</function> increases the internal reference counter of
     <parameter>device</parameter> by one.</para>
 
-    <para><function>sd_device_unref()</function> decreases the reference counter of
+    <para><function>sd_device_unref()</function> decreases the internal reference counter of
     <parameter>device</parameter> by one. Once the reference count has dropped to zero,
     <parameter>device</parameter> is destroyed and cannot be used anymore, so further calls to
     <function>sd_device_ref()</function> or <function>sd_device_unref()</function> are illegal.</para>
diff --git a/man/sd_event_source_unref.xml b/man/sd_event_source_unref.xml
index a7699e35478..b626e4cf4a7 100644
--- a/man/sd_event_source_unref.xml
+++ b/man/sd_event_source_unref.xml
@@ -59,16 +59,13 @@
   <refsect1>
     <title>Description</title>
 
-    <para><function>sd_event_source_unref()</function> may be used to
-    decrement by one the reference counter of the event source object
-    specified as <parameter>source</parameter>. The reference counter
-    is initially set to one, when the event source is created with calls
-    such as
-    <citerefentry><refentrytitle>sd_event_add_io</refentrytitle><manvolnum>3</manvolnum></citerefentry>
-    or
+    <para><function>sd_event_source_unref()</function> may be used to decrement by one the internal reference
+    counter of the event source object specified as <parameter>source</parameter>. The reference counter is
+    initially set to one, when the event source is created with calls such as
+    <citerefentry><refentrytitle>sd_event_add_io</refentrytitle><manvolnum>3</manvolnum></citerefentry> or
     <citerefentry><refentrytitle>sd_event_add_time</refentrytitle><manvolnum>3</manvolnum></citerefentry>. When
-    the reference counter reaches zero it is removed from its event loop
-    object and destroyed.</para>
+    the reference counter reaches zero, the object is detached from the event loop object and destroyed.
+    </para>
 
     <para><function>sd_event_source_unrefp()</function> is similar to
     <function>sd_event_source_unref()</function> but takes a pointer to a
@@ -78,9 +75,8 @@
     Variable Attribute</ulink>. Note that this function is defined as
     inline function.</para>
 
-    <para><function>sd_event_source_ref()</function> may be used
-    to increase by one the reference counter of the event source object
-    specified as <parameter>source</parameter>.</para>
+    <para><function>sd_event_source_ref()</function> may be used to increase by one the internal reference
+    counter of the event source object specified as <parameter>source</parameter>.</para>
 
     <para><function>sd_event_source_unref()</function>,
     <function>sd_bus_creds_unrefp()</function> and