Update libedataserverui API documentation.
authorMatthew Barnes <mbarnes@redhat.com>
Fri, 2 Nov 2012 17:28:05 +0000 (13:28 -0400)
committerMatthew Barnes <mbarnes@redhat.com>
Fri, 2 Nov 2012 17:28:05 +0000 (13:28 -0400)
docs/reference/libedataserverui/libedataserverui-sections.txt
libedataserverui/e-name-selector-dialog.c
libedataserverui/e-name-selector-dialog.h

index cf5906a..7c5e089 100644 (file)
@@ -225,6 +225,8 @@ e_name_selector_dialog_peek_model
 e_name_selector_dialog_set_model
 e_name_selector_dialog_set_destination_index
 e_name_selector_dialog_set_scrolling_policy
+e_name_selector_dialog_get_section_visible
+e_name_selector_dialog_set_section_visible
 <SUBSECTION Standard>
 E_NAME_SELECTOR_DIALOG
 E_IS_NAME_SELECTOR_DIALOG
index aa3a939..3ebfcbc 100644 (file)
@@ -1754,59 +1754,60 @@ e_name_selector_dialog_set_scrolling_policy (ENameSelectorDialog *name_selector_
 }
 
 /**
- * e_name_selector_dialog_set_section_visible:
+ * e_name_selector_dialog_get_section_visible:
  * @name_selector_dialog: an #ENameSelectorDialog
  * @name: name of the section
- * @visible: whether to show or hide the section
  *
- * Shows or hides section named @name in the dialog.
+ * Returns: whether section named @name is visible in the dialog.
  *
  * Since: 3.8
  **/
-void
-e_name_selector_dialog_set_section_visible (ENameSelectorDialog *name_selector_dialog,
-                                            const gchar *name,
-                                            gboolean visible)
+gboolean
+e_name_selector_dialog_get_section_visible (ENameSelectorDialog *name_selector_dialog,
+                                            const gchar *name)
 {
        Section *section;
        gint index;
 
-       g_return_if_fail (E_IS_NAME_SELECTOR_DIALOG (name_selector_dialog));
-       g_return_if_fail (name != NULL);
+       g_return_val_if_fail (E_IS_NAME_SELECTOR_DIALOG (name_selector_dialog), FALSE);
+       g_return_val_if_fail (name != NULL, FALSE);
 
        index = find_section_by_name (name_selector_dialog, name);
-       g_return_if_fail (index != -1);
+       g_return_val_if_fail (index != -1, FALSE);
 
        section = &g_array_index (name_selector_dialog->priv->sections, Section, index);
-
-       if (visible)
-               gtk_widget_show (GTK_WIDGET (section->section_box));
-       else
-               gtk_widget_hide (GTK_WIDGET (section->section_box));
+       return gtk_widget_get_visible (GTK_WIDGET (section->section_box));
 }
 
 /**
- * e_name_selector_dialog_get_section_visible:
+ * e_name_selector_dialog_set_section_visible:
  * @name_selector_dialog: an #ENameSelectorDialog
  * @name: name of the section
+ * @visible: whether to show or hide the section
  *
- * Returns: whether section named @name is visible in the dialog.
+ * Shows or hides section named @name in the dialog.
  *
  * Since: 3.8
  **/
-gboolean
-e_name_selector_dialog_get_section_visible (ENameSelectorDialog *name_selector_dialog,
-                                            const gchar *name)
+void
+e_name_selector_dialog_set_section_visible (ENameSelectorDialog *name_selector_dialog,
+                                            const gchar *name,
+                                            gboolean visible)
 {
        Section *section;
        gint index;
 
-       g_return_val_if_fail (E_IS_NAME_SELECTOR_DIALOG (name_selector_dialog), FALSE);
-       g_return_val_if_fail (name != NULL, FALSE);
+       g_return_if_fail (E_IS_NAME_SELECTOR_DIALOG (name_selector_dialog));
+       g_return_if_fail (name != NULL);
 
        index = find_section_by_name (name_selector_dialog, name);
-       g_return_val_if_fail (index != -1, FALSE);
+       g_return_if_fail (index != -1);
 
        section = &g_array_index (name_selector_dialog->priv->sections, Section, index);
-       return gtk_widget_get_visible (GTK_WIDGET (section->section_box));
+
+       if (visible)
+               gtk_widget_show (GTK_WIDGET (section->section_box));
+       else
+               gtk_widget_hide (GTK_WIDGET (section->section_box));
 }
+
index e670517..3d1e28c 100644 (file)
@@ -87,13 +87,13 @@ void                e_name_selector_dialog_set_scrolling_policy
                                                (ENameSelectorDialog *name_selector_dialog,
                                                 GtkPolicyType hscrollbar_policy,
                                                 GtkPolicyType vscrollbar_policy);
+gboolean       e_name_selector_dialog_get_section_visible
+                                               (ENameSelectorDialog *name_selector_dialog,
+                                                const gchar *name);
 void           e_name_selector_dialog_set_section_visible
                                                (ENameSelectorDialog *name_selector_dialog,
                                                 const gchar *name,
                                                 gboolean visible);
-gboolean       e_name_selector_dialog_get_section_visible
-                                               (ENameSelectorDialog *name_selector_dialog,
-                                                const gchar *name);
 
 G_END_DECLS