diff --git a/spec/Connection_Interface_Addressing.xml b/spec/Connection_Interface_Addressing.xml index 9e01c18..db8155f 100644 --- a/spec/Connection_Interface_Addressing.xml +++ b/spec/Connection_Interface_Addressing.xml @@ -76,7 +76,18 @@ - + +

A mapping from requested vCard addresses to the corresponding + contact handles.

+ +

Requested addresses that are not valid or understood for this protocol + MUST be omitted from the mapping.

+
+
+ +

A dictionary mapping the contact handles to contact attributes. @@ -86,14 +97,12 @@ the attribute should either be omitted from the result or replaced with a default value.

-

Requested addresses that cannot be satisfied MUST be ommitted - from the mapping.

+

Requested addresses that are not valid or understood for this protocol + MUST be omitted from the mapping.

Each contact's attributes will always include at least the identifier that would be obtained by inspecting the handle - (org.freedesktop.Telepathy.Connection/contact-id), - and the vCard field used for requesting the contact in - org.freedesktop.Telepathy.Connection.Interface.ContactInfo/info. + (org.freedesktop.Telepathy.Connection/contact-id).

@@ -143,7 +152,17 @@ - + +

A mapping of requested URIs to the corresponding contact handles.

+ +

Requested URIs that are not valid or understood for this protocol + MUST be omitted from the mapping.

+
+
+ +

A dictionary mapping the contact handles to contact attributes. @@ -153,8 +172,8 @@ the attribute should either be omitted from the result or replaced with a default value.

-

Requested URIs that cannot be satisfied MUST be ommitted - from the mapping.

+

Requested URIs that are not valid or understood for this protocol + MUST be omitted from the mapping.

Each contact's attributes will always include at least the identifier that would be obtained by inspecting the handle @@ -201,57 +220,25 @@ - - -

The contact's address, as it was requested - through GetContactsByVCardField. This - attribute MUST be ommitted if the contact was not retrieved - through GetContactsByVCardField.

- -

When retrieving more than one contact - through GetContactsByVCardField, - there needs to be a way to map the given contact back o the - original request.

-
-
- - - - -

The contact's URI, as it was requested through - GetContactsByURI. This - attribute MUST be ommitted if the contact was not retrieved - through GetContactsByURI.

- -

When retrieving more than one contact - through GetContactsByURI, - there needs to be a way to map the given contact back o the - original request.

-
-
-
- - + - The address that has been requested by + A map from URIs/vCard addresses to the corresponding handle. + + + + + + The URI or vCard address that has been requested by GetContactsByVCardField or GetContactsByURI. - - - - - The vCard field used in GetContactsByVCardField. - - - - The address that was requested. + + + A nonzero handle. - - +