diff options
author | Will Thompson <will.thompson@collabora.co.uk> | 2010-11-21 16:51:51 +0000 |
---|---|---|
committer | Will Thompson <will.thompson@collabora.co.uk> | 2010-11-23 10:58:06 +0000 |
commit | 610549a679ac2efd7b4e0f15eed62a282240c57c (patch) | |
tree | cf203142f65218cc766562e34c8698492c384f6c | |
parent | 613ecbfba04965bf48f78c3afbb9a99144cb6036 (diff) |
Define arg0namespace in the specificationarg0namespace
-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> |