diff options
author | Xavier Claessens <xavier.claessens@collabora.co.uk> | 2012-02-15 11:15:23 +0100 |
---|---|---|
committer | Xavier Claessens <xavier.claessens@collabora.co.uk> | 2012-02-15 11:22:57 +0100 |
commit | 71a38001a7e094f2a55bdc6c49665467b94c0dee (patch) | |
tree | 924c6cf4fa65749f0c31d280e028026f6bec5d4e /spec/Connection_Interface_Contact_List.xml | |
parent | 455e07e61e9a3e357c7ed29051dc22d84348516c (diff) | |
download | telepathy-glib-71a38001a7e094f2a55bdc6c49665467b94c0dee.tar.gz |
Update to latest spec
Diffstat (limited to 'spec/Connection_Interface_Contact_List.xml')
-rw-r--r-- | spec/Connection_Interface_Contact_List.xml | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/spec/Connection_Interface_Contact_List.xml b/spec/Connection_Interface_Contact_List.xml index 033c64d1d..66834da97 100644 --- a/spec/Connection_Interface_Contact_List.xml +++ b/spec/Connection_Interface_Contact_List.xml @@ -841,6 +841,35 @@ </tp:docstring> </property> + <property name="DownloadAtConnection" type="b" access="read" + tp:name-for-bindings="Download_At_Connection" + tp:is-connection-parameter='yes'> + <tp:added version="0.UNRELEASED"/> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>If true, the contact list is automatically downloaded at + connection. If false, the contact list is only downloaded + when requested explicitely with + <tp:member-ref>Download</tp:member-ref>.</p> + + <tp:rationale> + <p>Downloading the contact list uses bandwidth and is not always + necessary or desired. For example, a client could cache the + contact list from previous connections and accept less regular + updates, it could get the contact list from an out-of-band + protocol-specific way, or it could not need the contact list at + all.</p> + </tp:rationale> + + <p>Connection managers MUST default to true.</p> + + <tp:rationale> + <p>If a connection manager starts supporting this property but + defaults to false, it would break all existing clients that don't + call <tp:member-ref>Download</tp:member-ref>.</p> + </tp:rationale> + </tp:docstring> + </property> + <method name="AuthorizePublication" tp:name-for-bindings="Authorize_Publication"> <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> @@ -1080,6 +1109,21 @@ </tp:possible-errors> </method> + <method name="Download" tp:name-for-bindings="Download"> + <tp:added version="0.UNRELEASED"/> + <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> + <p>Download the contact list from the server. If + <tp:member-ref>DownloadAtConnection</tp:member-ref> is true, + Download does nothing.</p> + </tp:docstring> + + <tp:possible-errors> + <tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/> + <tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/> + <tp:error name="org.freedesktop.Telepathy.Error.NotImplemented"/> + </tp:possible-errors> + </method> + </interface> </node> <!-- vim:set sw=2 sts=2 et ft=xml: --> |