Define arg0namespace in the specification

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index dd4aa6a..eafd815 100644 (file)
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -3628,6 +3628,38 @@
                       notified in both cases.</para>
                   </entry>
                 </row>
+                <row>
+                  <entry><literal>arg0namespace</literal></entry>
+                  <entry>Like a bus name or interface name, except that the string may contain only
+                    one element, and may end with a trailing period</entry>
+                  <entry>
+                    <para>Match messages whose first argument is of type STRING, and is a bus name
+                      or interface name within the specified namespace. This is primarily intended
+                      for watching name owner changes for a group of related bus names, rather than
+                      for a single name or all name changes.</para>
+
+                    <para>If the value has a trailing period, then only bus names or interface names
+                      within that namespace are matched. If it has no trailing period, an exact
+                      match is also allowed.</para>
+
+                    <para>For example, the match rule
+                      <literal>member='NameOwnerChanged',arg0namespace='com.example.backend'</literal>
+                      matches name owner changes for bus names such as
+                      <literal>com.example.backend.foo</literal>,
+                      <literal>com.example.backend.foo.bar</literal>, and
+                      <literal>com.example.backend</literal> itself.</para>
+
+                    <para>On the other hand, the match rule
+                      <literal>member='NameOwnerChanged',arg0namespace='com.example.backend.'</literal>
+                      (with a trailing period in the namespace) matches owner changes for
+                      <literal>com.example.backend.foo</literal> and
+                      <literal>com.example.backend.foo.bar</literal>, but not for
+                      <literal>com.example.backend</literal>.
+                    </para>
+
+                    <para>See also <xref linkend='bus-messages-name-owner-changed'/>.</para>
+                  </entry>
+                </row>
               </tbody>
             </tgroup>
           </informaltable>