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 71574c0..250f6b8 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>