[empathy] Documented public functions in empathy-roster-model

[Guillaume Desmottes <gdesmott src gnome org>]

commit e0542a641adc30e04255b1eb561bbcd6e0b17da2
Author: Laurent Contzen <lcontzen gmail com>
Date:   Sat Aug 4 12:12:30 2012 +0200

    Documented public functions in empathy-roster-model

 libempathy-gtk/empathy-roster-model.c |   18 ++++++++++++++++++
 1 files changed, 18 insertions(+), 0 deletions(-)
---
diff --git a/libempathy-gtk/empathy-roster-model.c b/libempathy-gtk/empathy-roster-model.c
index d8671f2..80a82bf 100644
--- a/libempathy-gtk/empathy-roster-model.c
+++ b/libempathy-gtk/empathy-roster-model.c
@@ -90,6 +90,14 @@ empathy_roster_model_fire_groups_changed (EmpathyRosterModel *self,
 
 /***** Public *****/
 
+/**
+ * empathy_roster_model_get_individuals:
+ * @self: a #EmpathyRosterModel
+ *
+ * Returns all the individuals stored by @self.
+ *
+ * Returns: (transfer container): a #GList of #FolksIndividual
+ */
 GList *
 empathy_roster_model_get_individuals (EmpathyRosterModel *self)
 {
@@ -103,6 +111,16 @@ empathy_roster_model_get_individuals (EmpathyRosterModel *self)
   return (* iface->get_individuals) (self);
 }
 
+/**
+ * empathy_roster_model_get_groups_for_individual:
+ * @self: a #EmpathyRosterModel
+ * @individual: a #FolksIndidivual
+ *
+ * Returns the groups of which @individual is a member of.
+ *
+ * Returns: (transfer container): a #GList of (const gchar *) representing the
+ * groups of @individual
+ */
 GList *
 empathy_roster_model_get_groups_for_individual (EmpathyRosterModel *self,
     FolksIndividual *individual)