[empathy] Add documentation for EmpathyProfileChooser.



commit efc083f8db0c2116e05be9d894a0dbac39a5d433
Author: Jonny Lamb <jonny lamb collabora co uk>
Date:   Thu Apr 23 01:02:46 2009 +0100

    Add documentation for EmpathyProfileChooser.
    
    Signed-off-by: Jonny Lamb <jonny lamb collabora co uk>
---
 libempathy-gtk/empathy-profile-chooser.c |   33 ++++++++++++++++++++++++++++++
 1 files changed, 33 insertions(+), 0 deletions(-)

diff --git a/libempathy-gtk/empathy-profile-chooser.c b/libempathy-gtk/empathy-profile-chooser.c
index 897e383..4959561 100644
--- a/libempathy-gtk/empathy-profile-chooser.c
+++ b/libempathy-gtk/empathy-profile-chooser.c
@@ -30,6 +30,16 @@
 #include "empathy-profile-chooser.h"
 #include "empathy-ui-utils.h"
 
+/**
+ * SECTION:empathy-profile-chooser
+ * @title: EmpathyProfileChooser
+ * @short_description: A widget used to choose from a list of profiles
+ * @include: libempathy-gtk/empathy-account-chooser.h
+ *
+ * #EmpathyProfileChooser is a widget which provides a chooser of available
+ * profiles.
+ */
+
 enum {
 	COL_ICON,
 	COL_LABEL,
@@ -37,6 +47,14 @@ enum {
 	COL_COUNT
 };
 
+/**
+ * empathy_profile_chooser_dup_selected:
+ * @widget: an #EmpathyProfileChooser
+ *
+ * Returns a new reference to the selected #McProfile in @widget.
+ *
+ * Return value: a new reference to the selected #McProfile
+ */
 McProfile*
 empathy_profile_chooser_dup_selected (GtkWidget *widget)
 {
@@ -54,6 +72,14 @@ empathy_profile_chooser_dup_selected (GtkWidget *widget)
 	return profile;
 }
 
+/**
+ * empathy_profile_chooser_n_profiles:
+ * @widget: an #EmpathyProfileChooser
+ *
+ * Returns the number of profiles in @widget.
+ *
+ * Return value: the number of profiles in @widget
+ */
 gint
 empathy_profile_chooser_n_profiles (GtkWidget *widget)
 {
@@ -115,6 +141,13 @@ profile_chooser_sort_func (GtkTreeModel *model,
 	return cmp;
 }
 
+/**
+ * empathy_profile_chooser_new:
+ *
+ * Creates a new #EmpathyProfileChooser widget.
+ *
+ * Return value: a new #EmpathyProfileChooser widget
+ */
 GtkWidget *
 empathy_profile_chooser_new (void)
 {



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]