Add clarification to spec about UpdateActivationEnvironment

UpdateActivationEnvironment takes a a{ss}.  This means only
valid UTF-8 can be used.  Environment variables are normally
ascii, but in theory have no specific encoding to them.  This
means that certain valid environment variables can't be sent
to the bus for updating its activation environment.

This commit just adds a note to the spec explaining this
restriction.

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 71574c0c183f6de645316f4f5499f6af2d16f454..250f6b848a223a7d9e1b66ac3a31331a6f05120b 100644 (file)
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -3992,6 +3992,9 @@
         <para>
           Some bus instances, such as the standard system bus, may disable access to this method for some or all callers.
         </para>
+        <para>
+          Note, both the environment variable names and values must be valid UTF-8.  There's no way to update the activation environment with data that is invalid UTF-8.
+        </para>
 
       </sect3>