From: igo95862 <igo95862@yandex.ru>
Date: Fri, 27 Nov 2020 13:51:18 +0000 (+0300)
Subject: man: Speicfy exact return values of sd_bus_message_enter_container
X-Git-Tag: v248-rc1~619
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;ds=sidebyside;h=1edc1f1b626446a20db405d041cd70ed3d52c632;p=thirdparty%2Fsystemd.git

man: Speicfy exact return values of sd_bus_message_enter_container
---

diff --git a/man/sd_bus_message_open_container.xml b/man/sd_bus_message_open_container.xml
index 27b953ecc19..89c75f0e91e 100644
--- a/man/sd_bus_message_open_container.xml
+++ b/man/sd_bus_message_open_container.xml
@@ -100,8 +100,13 @@
   <refsect1>
     <title>Return Value</title>
 
-    <para>On success, these functions return a non-negative integer. On failure, they return a negative
-    errno-style error code.</para>
+    <para>On success, these functions return a non-negative integer.
+    <function>sd_bus_message_open_container()</function> and <function>sd_bus_message_close_container()</function>
+    return 0.
+    <function>sd_bus_message_enter_container()</function> returns 1 if it successfully opened a new container, and 0 if
+    that was not possible because the end of the currently open container or message was reached.
+    <function>sd_bus_message_exit_container()</function> returns 1 on success.
+    On failure, all of these functions return a negative errno-style error code.</para>
 
     <refsect2>
       <title>Errors</title>