Documented public functions in empathy-roster-model

diff --git a/libempathy-gtk/empathy-roster-model.c b/libempathy-gtk/empathy-roster-model.c
index d8671f2799cd096a5fdfe40726943d53d26fb3d3..80a82bf1d5740976ad2b4510059d6f07b5b9a648 100644 (file)
--- 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)