summaryrefslogtreecommitdiff
path: root/spec/Connection_Interface_Addressing.xml
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2012-02-20 15:09:37 +0000
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2012-02-20 15:09:37 +0000
commit89ebc5c794da4b2312ea299764f58de2bf037343 (patch)
treedfc4a454edb0b05e9b29b4ab001ce51f56b1565f /spec/Connection_Interface_Addressing.xml
parent71a38001a7e094f2a55bdc6c49665467b94c0dee (diff)
downloadtelepathy-glib-89ebc5c794da4b2312ea299764f58de2bf037343.tar.gz
Further update spec, to 0.25.2
Code changes: * Generate code for Chan.T.Call1, Conn.I.Addressing1, Chan.I.CaptchaAuthentication1, and document them * Adapt Call1 CM and test for Direction argument to AddContent * Add CaptchaNotSupported error
Diffstat (limited to 'spec/Connection_Interface_Addressing.xml')
-rw-r--r--spec/Connection_Interface_Addressing.xml27
1 files changed, 16 insertions, 11 deletions
diff --git a/spec/Connection_Interface_Addressing.xml b/spec/Connection_Interface_Addressing.xml
index fe3783c2e..129e6716d 100644
--- a/spec/Connection_Interface_Addressing.xml
+++ b/spec/Connection_Interface_Addressing.xml
@@ -1,6 +1,6 @@
<?xml version="1.0" ?>
<node name="/Connection_Interface_Addressing" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
- <tp:copyright> Copyright (C) 2010 Collabora Limited </tp:copyright>
+ <tp:copyright> Copyright (C) 2010-2012 Collabora Limited </tp:copyright>
<tp:license xmlns="http://www.w3.org/1999/xhtml">
<p>This library is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published by
@@ -16,14 +16,10 @@
along with this library; if not, write to the Free Software Foundation,
Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
</tp:license>
- <interface name="org.freedesktop.Telepathy.Connection.Interface.Addressing1"
- tp:causes-havoc="experimental">
+ <interface name="org.freedesktop.Telepathy.Connection.Interface.Addressing1">
<tp:requires interface="org.freedesktop.Telepathy.Connection"/>
<tp:requires interface="org.freedesktop.Telepathy.Connection.Interface.Contacts"/>
- <tp:added version="0.19.12">(as draft)</tp:added>
- <tp:changed version="0.25.1">Both methods now return two dictionaries.</tp:changed>
- <tp:changed version="0.25.UNRELEASED">Replaced DRAFT with a version number
- (still keeping the causes-havoc annotation)</tp:changed>
+ <tp:added version="0.25.2">(as stable API)</tp:added>
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>This interface deals with the multiple address types that can
refer to the same contact, such as vCard fields and URIs.</p>
@@ -203,11 +199,20 @@
<tp:mapping name="VCard_Field_Address_Map" array-name="">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>A mapping of vCard fields and addresses that repreent
- the given contact.</p>
+ <p>A mapping of vCard fields and addresses equivalent to a
+ particular contact's protocol identifier. For instance,
+ on XMPP this would contain <code>x-jabber</code> for all
+ contacts, and <code>x-facebook-id</code> for contacts on
+ Facebook's server.</p>
</tp:docstring>
- <tp:member type="s" name="VCard_Field"/>
- <tp:member type="s" name="Address"/>
+ <tp:member type="s" name="VCard_Field">
+ <tp:docstring>A vCard field, such as
+ <code>x-jabber</code>.</tp:docstring>
+ </tp:member>
+ <tp:member type="s" name="Address">
+ <tp:docstring>The value of that vCard field for the
+ contact.</tp:docstring>
+ </tp:member>
</tp:mapping>
<tp:contact-attribute name="addresses" type="a{ss}"