diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2010-03-31 16:17:43 +0100 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2010-03-31 16:17:43 +0100 |
commit | 9820b5d2ecadcc9020e29e000f640ce9ea2bf070 (patch) | |
tree | 30425e2bb0f5fa40a5b6b425e93c8e9e3074cc3d /spec/Connection_Interface_Contacts.xml | |
parent | afb2cfe61051c5cb62249df9231cf4b51e7d6c2d (diff) | |
download | telepathy-glib-9820b5d2ecadcc9020e29e000f640ce9ea2bf070.tar.gz |
Update spec to 0.19.2
Diffstat (limited to 'spec/Connection_Interface_Contacts.xml')
-rw-r--r-- | spec/Connection_Interface_Contacts.xml | 28 |
1 files changed, 15 insertions, 13 deletions
diff --git a/spec/Connection_Interface_Contacts.xml b/spec/Connection_Interface_Contacts.xml index 92c80c801..c6d9a5b70 100644 --- a/spec/Connection_Interface_Contacts.xml +++ b/spec/Connection_Interface_Contacts.xml @@ -111,16 +111,18 @@ interfaces, whose values can be obtained without additional network activity, will be in the reply.</p> - <p>It is an error to request interfaces that are not supported by - this Connection (i.e. mentioned in the + <p>Connection managers SHOULD ignore interfaces requested which they + do not support (i.e. those not mentioned in the <tp:member-ref>ContactAttributeInterfaces</tp:member-ref> - property).</p> + property.)</p> <tp:rationale> - <p>This makes it possible to distinguish between interfaces for - which the Connection has nothing to say (e.g. we don't know the - avatar tokens of any of the contacts, so we omitted them all), - and interfaces for which this API isn't supported.</p> + <p>This simplifies client-side code. Clients which care may + distinguish between unsupported interfaces (e.g. this Connection + does not support Avatars), and interfaces on which no information + is known for these contacts (e.g. we don't know the avatar tokens + of any of the contacts, so we omitted them all) by inspecting + <tp:member-ref>ContactAttributeInterfaces</tp:member-ref>.</p> </tp:rationale> <p>Attributes from the interface @@ -141,6 +143,12 @@ attributes. </tp:rationale> </tp:docstring> + <tp:changed version="UNRELEASED"> + requesting information for interfaces not mentioned in + <tp:member-ref>ContactAttributeInterfaces</tp:member-ref> is no + longer an error. Be aware that older connection managers may still + consider this an error. + </tp:changed> </arg> <arg direction="in" name="Hold" type="b"> @@ -173,12 +181,6 @@ <tp:possible-errors> <tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/> - <tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument"> - <tp:docstring> - One of the requested interfaces is not supported (mentioned in - <tp:member-ref>ContactAttributeInterfaces</tp:member-ref>). - </tp:docstring> - </tp:error> </tp:possible-errors> </method> </interface> |