aboutsummaryrefslogtreecommitdiffstats
path: root/libempathy/empathy-utils.c
diff options
context:
space:
mode:
authorTravis Reitter <treitter@gmail.com>2010-07-09 02:11:55 +0800
committerTravis Reitter <treitter@gmail.com>2010-07-21 07:12:36 +0800
commit151eb2b90cb579c7d538d0e3735e2d6157c57839 (patch)
treec134c098922d495fcec29ee4fdcd1a803efd6441 /libempathy/empathy-utils.c
parentebea339331d9c7a8eb69c125bd261ab60b3781eb (diff)
downloadgsoc2013-empathy-151eb2b90cb579c7d538d0e3735e2d6157c57839.tar
gsoc2013-empathy-151eb2b90cb579c7d538d0e3735e2d6157c57839.tar.gz
gsoc2013-empathy-151eb2b90cb579c7d538d0e3735e2d6157c57839.tar.bz2
gsoc2013-empathy-151eb2b90cb579c7d538d0e3735e2d6157c57839.tar.lz
gsoc2013-empathy-151eb2b90cb579c7d538d0e3735e2d6157c57839.tar.xz
gsoc2013-empathy-151eb2b90cb579c7d538d0e3735e2d6157c57839.tar.zst
gsoc2013-empathy-151eb2b90cb579c7d538d0e3735e2d6157c57839.zip
Add comments for the new Individual/Contact utility functions.
Diffstat (limited to 'libempathy/empathy-utils.c')
-rw-r--r--libempathy/empathy-utils.c10
1 files changed, 10 insertions, 0 deletions
diff --git a/libempathy/empathy-utils.c b/libempathy/empathy-utils.c
index ddf56f708..62e595c13 100644
--- a/libempathy/empathy-utils.c
+++ b/libempathy/empathy-utils.c
@@ -564,12 +564,14 @@ empathy_connect_new_account (TpAccount *account,
}
}
+/* Translate Folks' general presence type to the Tp presence type */
TpConnectionPresenceType
empathy_folks_presence_type_to_tp (FolksPresenceType type)
{
return (TpConnectionPresenceType) type;
}
+/* Returns TRUE if the given Individual contains a TpContact */
gboolean
empathy_folks_individual_contains_contact (FolksIndividual *individual)
{
@@ -597,6 +599,10 @@ empathy_folks_individual_contains_contact (FolksIndividual *individual)
/* TODO: this needs to be eliminated (and replaced in some cases with user
* prompts) when we break the assumption that FolksIndividuals are 1:1 with
* TpContacts */
+
+/* Retrieve the EmpathyContact corresponding to the first TpContact contained
+ * within the given Individual. Note that this is a temporary convenience. See
+ * the TODO above. */
EmpathyContact *
empathy_contact_from_folks_individual (FolksIndividual *individual)
{
@@ -623,6 +629,10 @@ empathy_contact_from_folks_individual (FolksIndividual *individual)
}
/* TODO: This also needs to be eliminated, and is horrifically slow. */
+
+/* Retrieve the first Individual containing a TpContact that corresponds to the
+ * given EmpathyContact. Note that this is a temporary convenience. See
+ * the TODO above. */
FolksIndividual *
folks_individual_from_empathy_contact (EmpathyContact *contact)
{