summaryrefslogtreecommitdiff
path: root/man/sd_bus_get_n_queued_read.xml
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2018-02-28 10:53:18 +0100
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2018-02-28 10:54:37 +0100
commit34fd5f69dd10a8bc096c797b80c946613321cefd (patch)
tree86a9754c43b055ce90fc7f105004e306586d7e12 /man/sd_bus_get_n_queued_read.xml
parente0a085811de1d1976c019afcfc2e4e74f590cc9f (diff)
downloadsystemd-34fd5f69dd10a8bc096c797b80c946613321cefd.tar.gz
man: shorten/reword a bit in sd_bus_get_n_queued_read
In particular: - drop "when it is non-zero" to avoid implying that it can be called if the queue is not empty. - "has been created" sounds like something happened in parallel, but what we really mean is that *this* particular object *was* created in a certain way.
Diffstat (limited to 'man/sd_bus_get_n_queued_read.xml')
-rw-r--r--man/sd_bus_get_n_queued_read.xml16
1 files changed, 8 insertions, 8 deletions
diff --git a/man/sd_bus_get_n_queued_read.xml b/man/sd_bus_get_n_queued_read.xml
index b39e87f8dd..32be403fc5 100644
--- a/man/sd_bus_get_n_queued_read.xml
+++ b/man/sd_bus_get_n_queued_read.xml
@@ -75,18 +75,18 @@
<para>
<function>sd_bus_get_n_queued_read()</function> may be used to query the number of bus messages in the read queue
of a bus connection object. The read queue contains all messages read from the transport medium (e.g. network
- socket) but not yet processed locally. The function expects two arguments: the bus object to query the number of
- queued messages of, and a pointer to a 64bit counter variable to write the current queue size to. Use
- <function>sd_bus_process()</function> in order to process queued messages, i.e. to reduce the size of the read
- queue (as well as, in fact, the write queue, see below) when it is non-zero.
+ socket) but not yet processed locally. The function expects two arguments: the bus object to query, and a pointer
+ to a 64bit counter variable to write the current queue size to. Use <function>sd_bus_process()</function> in
+ order to process queued messages, i.e. to reduce the size of the read queue (as well as, in fact, the write
+ queue, see below).
</para>
<para>
- Similar, <function>sd_bus_get_n_queued_write()</function> may be used to query the number of currently pending
+ Similarly, <function>sd_bus_get_n_queued_write()</function> may be used to query the number of currently pending
bus messages in the write queue of a bus connection object. The write queue contains all messages enqueued into
the connection with a call such as <function>sd_bus_send()</function> but not yet written to the transport
- medium. The expected arguments are similar to the ones of <function>sd_bus_get_n_queued_read()</function>. Here
- too, use <function>sd_bus_process()</function> to reduce the size of the write queue. Alternatively, use
+ medium. The expected arguments are similar to <function>sd_bus_get_n_queued_read()</function>. Here too, use
+ <function>sd_bus_process()</function> to reduce the size of the write queue. Alternatively, use
<function>sd_bus_flush()</function> to synchronously write out any pending bus messages until the write queue is
empty.
</para>
@@ -108,7 +108,7 @@
<varlistentry>
<term><constant>-ECHILD</constant></term>
- <listitem><para>The bus connection has been created in a different process.</para></listitem>
+ <listitem><para>The bus connection was created in a different process.</para></listitem>
</varlistentry>
</variablelist>