diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index a61218cd..c20a6bbe 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -7632,8 +7632,6 @@
Metadata from the first three arguments is stored by the message
bus, but not interpreted; software that interacts with the
container manager can use this metadata.
-
The method call may fail with the error
org.freedesktop.DBus.Error.LimitsExceeded
if the caller provides more metadata than the message bus
@@ -7857,6 +7855,7 @@
The opaque object path that was returned from the
AddServer method, identifying a
container instance.
+ This output parameter is produced by the message bus.
@@ -7868,6 +7867,8 @@
documented for
GetConnectionCredentials.
+ This output parameter is produced by the message bus
+ and is appropriate to use in trust decisions.
@@ -7879,6 +7880,8 @@
AddServer method, such as
org.flatpak or
io.snapcraft.
+ This output parameter is controlled by the creator
+ of the container instance.
@@ -7888,6 +7891,8 @@
Some unique identifier for an application or container,
whose meaning is defined by the maintainers of the
container type.
+ This output parameter is controlled by the creator
+ of the container instance.
@@ -7897,6 +7902,8 @@
Metadata describing the application or container, with the
keys and values defined by the maintainers of the container
type.
+ This output parameter is controlled by the creator
+ of the container instance.
@@ -7914,6 +7921,15 @@
org.freedesktop.DBus.Error.NameHasNoOwner error
is returned instead.
+
+ Several of the output parameters are controlled by the creator of
+ the container instance.
+ On a bus that accepts connections from multiple clients at
+ different privilege levels, it is not appropriate to trust those
+ output parameters or use them in trust decisions unless the
+ process identified by the creator parameter
+ is trusted.
+
@@ -7956,6 +7972,8 @@
documented for
GetConnectionCredentials.
+ This output parameter is produced by the message bus
+ and is appropriate to use in trust decisions.
@@ -7967,6 +7985,8 @@
AddServer method, such as
org.flatpak or
io.snapcraft.
+ This output parameter is controlled by the creator
+ of the container instance.
@@ -7976,6 +7996,8 @@
Some unique identifier for an application or container,
whose meaning is defined by the maintainers of the
container type.
+ This output parameter is controlled by the creator
+ of the container instance.
@@ -7985,6 +8007,8 @@
Metadata describing the application or container, with the
keys and values defined by the maintainers of the container
type.
+ This output parameter is controlled by the creator
+ of the container instance.
@@ -7999,6 +8023,12 @@
org.freedesktop.DBus.Error.NotContainer error
is returned.
+
+ Several of the output parameters are controlled by the creator of
+ the container instance.
+ See
+ for more details.
+