]> git.ipfire.org Git - thirdparty/dbus.git/commitdiff
re-word description of arg0namespace
authorSimon McVittie <simon.mcvittie@collabora.co.uk>
Thu, 7 Apr 2011 12:12:02 +0000 (13:12 +0100)
committerSimon McVittie <simon.mcvittie@collabora.co.uk>
Thu, 7 Apr 2011 12:12:02 +0000 (13:12 +0100)
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

index 746d893a11c5fcfe77325cfc1c01fbce17f7bf14..ad731c9e93f00aa2797c566477be6724b793a865 100644 (file)
                 </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>