summaryrefslogtreecommitdiff
path: root/spec/Connection_Interface_Contacts.xml
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2010-03-31 16:17:43 +0100
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2010-03-31 16:17:43 +0100
commit9820b5d2ecadcc9020e29e000f640ce9ea2bf070 (patch)
tree30425e2bb0f5fa40a5b6b425e93c8e9e3074cc3d /spec/Connection_Interface_Contacts.xml
parentafb2cfe61051c5cb62249df9231cf4b51e7d6c2d (diff)
downloadtelepathy-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.xml28
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>