Attachment 45375 Details for Bug 24317 – re-word description of arg0namespace

[patch] re-word description of arg0namespace

0002-re-word-description-of-arg0namespace.patch (text/plain), 2.16 KB, created by Simon McVittie on 2011-04-07 07:28:43 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Simon McVittie

Created: 2011-04-07 07:28:43 UTC

Size: 2.16 KB

patch

obsolete

>From 36cc4c547cb21d8f754ba4b4ee4c1c4204fd84ce Mon Sep 17 00:00:00 2001
>From: Simon McVittie <simon.mcvittie@collabora.co.uk>
>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 @@
>                 </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>
>-- 
>1.7.4.1
>

Actions: View | Splinter Review

Attachments on bug 24317: 45374 | 45375 | 45379 | 45383

Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.