From e600d78e41511e8fbaf20cc1c2d3ddac97cbf3e0 Mon Sep 17 00:00:00 2001
From: Simon McVittie <simon.mcvittie@collabora.co.uk>
Date: Fri, 4 May 2007 10:28:12 +0000
Subject: [PATCH] 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.

---
 ChangeLog                  |  8 ++++++++
 doc/dbus-specification.xml | 13 ++++++++++++-
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/ChangeLog b/ChangeLog
index 5e112ff..454b092 100644
--- 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
--- 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>
-- 
2.7.4