-simplifying logic some

1 files changed, 16 insertions, 1 deletions

diff --git a/src/fs/gnunet-fs-gtk-anonymity_spin_buttons.h b/src/fs/gnunet-fs-gtk-anonymity_spin_buttons.h
index 0d4e2dac..7847904a 100644
--- a/src/fs/gnunet-fs-gtk-anonymity_spin_buttons.h
+++ b/src/fs/gnunet-fs-gtk-anonymity_spin_buttons.h
@@ -19,7 +19,7 @@
 */
 
 /**
- * @file src/fs/gnunet-fs-gtk-anonymtiy_spin_buttons.c
+ * @file src/fs/gnunet-fs-gtk-anonymtiy_spin_buttons.h
  * @author Christian Grothoff
  * @brief operations to manage user's anonymity level selections
  */
@@ -30,11 +30,26 @@
 #include <gdk/gdk.h>
 
 
+/**
+ * Obtain the numeric anonymity level selected by a GtkComboBox.
+ *
+ * @param builder builder for looking up widgets
+ * @param combo_name name of the GtkComboBox with the anonymity selection
+ * @param p_level where to store the anonymity level
+ * @return TRUE on success, FALSE on failure
+ */
 gboolean
 GNUNET_GTK_get_selected_anonymity_level (GtkBuilder * builder,
                                          gchar * combo_name, guint * p_level);
 
 
+/**
+ * Obtain the numeric anonymity level selected by a GtkComboBox.
+ *
+ * @param combo the GtkComboBox with the anonymity selection
+ * @param p_level where to store the anonymity level
+ * @return TRUE on success, FALSE on failure
+ */
 gboolean
 GNUNET_GTK_get_selected_anonymity_combo_level (GtkComboBox *combo, guint *p_level);