[Bug 23301] Uniformize the spec to use Identifier everywhere

[bugzilla-daemon at freedesktop.org]

http://bugs.freedesktop.org/show_bug.cgi?id=23301


Simon McVittie <simon.mcvittie at collabora.co.uk> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |ASSIGNED




--- Comment #1 from Simon McVittie <simon.mcvittie at collabora.co.uk>  2009-08-14 06:42:57 PST ---
Looks good, except for a couple of places where I think it's not sufficiently
obvious what we're referring to:

> --- a/spec/Channel_Type_Text.xml
> +++ b/spec/Channel_Type_Text.xml
> @@ -419,8 +419,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
>      </tp:property>
>      <tp:property name="name" type="s">
>        <tp:docstring>
> -      A human-visible name for the channel, if it differs from the string
> -      version of the channel's handle.
> +      A human-visible name for the channel, if it differs from the channel's
> +      identifier.

"... from the channel's <tp:dbus-ref namespace="...">TargetID</tp:dbus-ref>",
please. (Hyperlinking an appropriate property is more important than using 100%
consistent terminology, IMO, and "ID" is just an abbreviation for identifier
here anyway.)

> --- a/spec/Connection_Interface_Aliasing.xml
> +++ b/spec/Connection_Interface_Aliasing.xml
> @@ -119,9 +119,9 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
>        </arg>
>        <tp:docstring>
>          Request the value of several contacts' aliases at once. This SHOULD
> -        only return cached aliases, falling back on the handle name if none > is
> -        present. Also if there was no cached alias, a request SHOULD be started
> -        of which the result is later signalled by
> +        only return cached aliases, falling back on the contact identifier if

"... on the contact identifier (i.e. the string corresponding to the handle)",
please.


-- 
Configure bugmail: http://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.