From: Simon McVittie Date: Thu, 7 Apr 2011 12:12:02 +0000 (+0100) Subject: re-word description of arg0namespace X-Git-Tag: dbus-1.5.0~2^2~9 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=36cc4c547cb21d8f754ba4b4ee4c1c4204fd84ce;p=thirdparty%2Fdbus.git 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. --- diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index 746d893a1..ad731c9e9 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -3765,14 +3765,18 @@ arg0namespace - Like a bus name or interface name, except that the string may contain only - one element, and may end with a trailing period + Like a bus name, except that the string is not + required to contain a '.' (period) 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. + 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. + 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.