diff options
| author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2008-01-22 10:47:47 +0000 |
|---|---|---|
| committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2008-01-22 10:47:47 +0000 |
| commit | 373523a5626d0feea1e2c0d1d7ad13418d0c34c7 (patch) | |
| tree | f082355f9d0f151b6657bad89ebe7220d887cd3f /spec/Connection_Interface_Avatars.xml | |
| parent | be8c089988d2d266a9aa3cb23a15df3e4e766717 (diff) | |
| download | telepathy-glib-373523a5626d0feea1e2c0d1d7ad13418d0c34c7.tar.gz | |
Sync spec 0.17.1 into spec/ directory
20080122104747-53eee-01ad0ba410367e6d8cfcfccdb4f6ab078e80d4c5.gz
Diffstat (limited to 'spec/Connection_Interface_Avatars.xml')
| -rw-r--r-- | spec/Connection_Interface_Avatars.xml | 13 |
1 files changed, 8 insertions, 5 deletions
diff --git a/spec/Connection_Interface_Avatars.xml b/spec/Connection_Interface_Avatars.xml index ee780b9c2..33f6f6856 100644 --- a/spec/Connection_Interface_Avatars.xml +++ b/spec/Connection_Interface_Avatars.xml @@ -154,8 +154,11 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</ <tp:docstring> Get the unique tokens for the given contacts' avatars. These tokens can be persisted across connections, and should be used by the client - to check whether the avatars have been updated. A empty token means - that no avatar is set for the given contact. + to check whether the avatars have been updated. A CM must always have + the tokens for the self handle if one is set (even if it is set to no + avatar). Otherwise, only tokens that are already known or that can be + discovered without retrieving the complete avatar are returned. An + empty token means the given contact has no avatar. </tp:docstring> <tp:possible-errors> <tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/> @@ -266,9 +269,9 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</ a changed token implies the contact's avatar has changed, but the strings should otherwise be considered opaque by clients.</p> - <p>A client should use GetAvatarTokens to request the tokens for the avatars - of all the contacts it is interested in when it connects. The avatars can - then be retreived using RequestAvatar for the corresponding contact. + <p>A client should use GetKnownAvatarTokens to request the tokens for the + avatars of all the contacts it is interested in when it connects. The + avatars can then be requested using RequestAvatars for the contacts. Clients should bind to the AvatarChanged signal and request a new copy of the avatar when a contacts' avatar token changes. Clients should cache the token and data of each contact's avatar between connections, to avoid |