From 36cc4c547cb21d8f754ba4b4ee4c1c4204fd84ce Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Thu, 7 Apr 2011 13:12:02 +0100 Subject: [PATCH 2/7] 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. --- 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 746d893..ad731c9 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. -- 1.7.4.1