From: Matt Johnston <matt@codeconstruct.com.au>
Date: Tue, 15 Jun 2021 03:49:26 +0000 (+0800)
Subject: man: fix sd_bus_add_node_enumerator() ret_nodes
X-Git-Tag: v249-rc1~15
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e65357b6585629ee2138e53d02face3914621a2e;p=thirdparty%2Fsystemd.git

man: fix sd_bus_add_node_enumerator() ret_nodes

ret_nodes is NULL terminated, the return value isn't a count.
---

diff --git a/man/sd_bus_add_node_enumerator.xml b/man/sd_bus_add_node_enumerator.xml
index da3989ef94b..c6beb1dcd1b 100644
--- a/man/sd_bus_add_node_enumerator.xml
+++ b/man/sd_bus_add_node_enumerator.xml
@@ -58,8 +58,9 @@
 
     <para><parameter>callback</parameter> is called with the path and userdata pointer registered
     with <function>sd_bus_add_node_enumerator()</function>. When called, it should store all the
-    child object paths of the given path prefix in <parameter>ret_nodes</parameter> and return the
-    number of child objects under the given prefix. If an error occurs, it can either return a
+    child object paths of the given path prefix in <parameter>ret_nodes</parameter> with a NULL
+    terminator item. The callback should return a non-negative value on success.
+    If an error occurs, it can either return a
     negative integer, set <parameter>ret_error</parameter> to a non-empty error or do both. Any
     errors returned by the callback are encoded as D-Bus errors and sent back to the caller. Errors
     in <parameter>ret_error</parameter> take priority over negative return values.</para>