diff options
-rw-r--r-- | doc/dbus-specification.xml | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index dd4aa6a0..eafd8154 100644 --- 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> |