doc/dbus-specification.xml: mention the reserved o.fd.DBus.Local interface

and the corresponding /o/fd/DBus/Local object path; describe them as reserved
and forbid using them in a sent message, mentioning that in the reference
implementation this will cause the connection to be dropped.
Patch approved by Havoc.

diff --git a/ChangeLog b/ChangeLog
index 5e112ff..454b092 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2007-05-04  Simon McVittie <simon.mcvittie@collabora.co.uk>
+
+       * doc/dbus-specification.xml: mention the reserved o.fd.DBus.Local
+       interface and the corresponding /o/fd/DBus/Local object path;
+       describe them as reserved and forbid using them in a sent message,
+       mentioning that in the reference implementation this will cause the
+       connection to be dropped. Patch approved by Havoc.
+
 2007-04-28  Ralf Habacker <ralf.habacker@freenet.de>
 
        * cmake/: don't install test applications and service files,

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 77b7e69..71c267e 100644 (file)
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -921,8 +921,13 @@
                   <entry>1</entry>
                   <entry><literal>OBJECT_PATH</literal></entry>
                   <entry><literal>METHOD_CALL</literal>, <literal>SIGNAL</literal></entry>
-                  <entry>The object to send a call to, 
+                  <entry>The object to send a call to,
                     or the object a signal is emitted from.
+                    The special path
+                    <literal>/org/freedesktop/DBus/Local</literal> is reserved;
+                    implementations should not send messages with this path,
+                    and the reference implementation of the bus daemon will
+                    disconnect any application that attempts to do so.
                   </entry>
                 </row>
                 <row>
@@ -934,6 +939,12 @@
                     The interface to invoke a method call on, or 
                     that a signal is emitted from. Optional for 
                     method calls, required for signals.
+                    The special interface
+                    <literal>org.freedesktop.DBus.Local</literal> is reserved;
+                    implementations should not send messages with this
+                    interface, and the reference implementation of the bus
+                    daemon will disconnect any application that attempts to
+                    do so.
                   </entry>
                 </row>
                 <row>