diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2011-04-07 13:12:02 +0100 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2011-04-07 13:12:02 +0100 |
commit | 36cc4c547cb21d8f754ba4b4ee4c1c4204fd84ce (patch) | |
tree | e287bdf9a137001e3ed04903b6672a2ca62e69f9 | |
parent | 08b251f0bcf4a6fd6d87598b9f6e420aab21fe4f (diff) | |
download | dbus-36cc4c547cb21d8f754ba4b4ee4c1c4204fd84ce.tar.gz |
re-word description of arg0namespace
It's unclear at first reading whether "may contain only one element"
means "elements >= 1, as an exception to the usual rule that
elements >= 2" (which is what was intended), or "elements == 1".
"Like a bus name or interface name" is a little ambiguous because they
have different syntactic restrictions: specifically allow any valid bus
name, which also allows all interface names.
-rw-r--r-- | doc/dbus-specification.xml | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index 746d893a..ad731c9e 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -3765,14 +3765,18 @@ </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>Like a bus name, except that the string is not + required to contain a '.' (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>Because every valid interface name is also a valid + bus name, this can also be used for messages whose + first argument is an interface name.</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> |