From 44a0fe04add5e633ffb9ee2be869adde435f4d12 Mon Sep 17 00:00:00 2001 From: Mikhail Zabaluev Date: Wed, 24 Feb 2010 18:15:24 +0200 Subject: Improved documentation to TpContactsMixinFillContactAttributesFunc --- telepathy-glib/contacts-mixin.h | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) (limited to 'telepathy-glib/contacts-mixin.h') diff --git a/telepathy-glib/contacts-mixin.h b/telepathy-glib/contacts-mixin.h index 2aad0cc99..24276416b 100644 --- a/telepathy-glib/contacts-mixin.h +++ b/telepathy-glib/contacts-mixin.h @@ -35,13 +35,15 @@ typedef struct _TpContactsMixinPrivate TpContactsMixinPrivate; /** * TpContactsMixinFillContactAttributesFunc: - * @obj: An object implementing the presence interface with this mixin - * @contacts: The contacts for which attributes are requested + * @obj: An object implementing the Contacts interface with this mixin + * @contacts: The contact handles for which attributes are requested * @attributes_hash: hash of handle => hash of attributes, containing all the * contacts in the contacts array * - * This function is called to add attributes of contacts - * + * This function is called to supply contact attributes pertaining to + * a particular interface, for a list of contacts. + * All the handles in @contacts are guaranteed to be valid and + * referenced. */ typedef void (*TpContactsMixinFillContactAttributesFunc) (GObject *obj, const GArray *contacts, GHashTable *attributes_hash); -- cgit v1.2.1