diff --git a/man/sd_bus_message_open_container.xml b/man/sd_bus_message_open_container.xml
index 5a65518719..64fda41b12 100644
--- a/man/sd_bus_message_open_container.xml
+++ b/man/sd_bus_message_open_container.xml
@@ -80,7 +80,7 @@
m itself if there is no parent container.
sd_bus_message_enter_container() enters the next container of the message
- m. It behaves mostly the same as
+ m for reading. It behaves mostly the same as
sd_bus_message_open_container(). Entering a container allows reading its contents
with
sd_bus_message_read3
@@ -89,7 +89,12 @@
sd_bus_message_exit_container() exits the scope of the last container entered
with sd_bus_message_enter_container(). It behaves mostly the same as
- sd_bus_message_close_container().
+ sd_bus_message_close_container(). Note that
+ sd_bus_message_exit_container() may only be called after iterating through all
+ members of the container, i.e. reading or skipping them. Use
+ sd_bus_message_skip3
+ to skip over felds of a container in order to be able to exit the container with
+ sd_bus_message_exit_container() without reading all members.
@@ -128,6 +133,13 @@
Memory allocation failed.
+
+
+ -EBUSY
+
+ sd_bus_message_exit_container() was called but there are
+ unread members left in the container.
+
@@ -158,6 +170,7 @@
sd-bus3,
sd_bus_message_append3,
sd_bus_message_read3,
+ sd_bus_message_skip3,
The D-Bus specification