[evolution-data-server] Update libedataserverui API documentation.



commit c138ed493376f1e5bd35f1bfd688f7eb5863d022
Author: Matthew Barnes <mbarnes redhat com>
Date:   Fri Nov 2 13:28:05 2012 -0400

    Update libedataserverui API documentation.

 .../libedataserverui/libedataserverui-sections.txt |    2 +
 libedataserverui/e-name-selector-dialog.c          |   49 ++++++++++----------
 libedataserverui/e-name-selector-dialog.h          |    6 +-
 3 files changed, 30 insertions(+), 27 deletions(-)
---
diff --git a/docs/reference/libedataserverui/libedataserverui-sections.txt b/docs/reference/libedataserverui/libedataserverui-sections.txt
index cf5906a..7c5e089 100644
--- a/docs/reference/libedataserverui/libedataserverui-sections.txt
+++ b/docs/reference/libedataserverui/libedataserverui-sections.txt
@@ -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
diff --git a/libedataserverui/e-name-selector-dialog.c b/libedataserverui/e-name-selector-dialog.c
index aa3a939..3ebfcbc 100644
--- a/libedataserverui/e-name-selector-dialog.c
+++ b/libedataserverui/e-name-selector-dialog.c
@@ -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));
 }
+
diff --git a/libedataserverui/e-name-selector-dialog.h b/libedataserverui/e-name-selector-dialog.h
index e670517..3d1e28c 100644
--- a/libedataserverui/e-name-selector-dialog.h
+++ b/libedataserverui/e-name-selector-dialog.h
@@ -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
 



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