From 1edc1f1b626446a20db405d041cd70ed3d52c632 Mon Sep 17 00:00:00 2001
From: igo95862 <igo95862@yandex.ru>
Date: Fri, 27 Nov 2020 16:51:18 +0300
Subject: [PATCH] man: Speicfy exact return values of
 sd_bus_message_enter_container

---
 man/sd_bus_message_open_container.xml | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/man/sd_bus_message_open_container.xml b/man/sd_bus_message_open_container.xml
index 27b953ecc1..89c75f0e91 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>