[gtk+] CenterBox: Add missing nullable annotations



commit cbe53fec07737fc33e5e0d61cb710aaa57d30eda
Author: Daniel Boles <dboles src gnome org>
Date:   Sat Aug 5 18:56:01 2017 +0100

    CenterBox: Add missing nullable annotations
    
    https://bugzilla.gnome.org/show_bug.cgi?id=785280

 gtk/gtkcenterbox.c |   26 +++++++++++++-------------
 1 files changed, 13 insertions(+), 13 deletions(-)
---
diff --git a/gtk/gtkcenterbox.c b/gtk/gtkcenterbox.c
index c5fca1c..2637598 100644
--- a/gtk/gtkcenterbox.c
+++ b/gtk/gtkcenterbox.c
@@ -721,9 +721,9 @@ gtk_center_box_new (void)
 /**
  * gtk_center_box_set_start_widget:
  * @self: a #GtkCenterBox
- * @child: the child
+ * @child: (nullable): the new start widget, or %NULL
  *
- * Sets the start widget.
+ * Sets the start widget. To remove the existing start widget, pass %NULL.
  *
  * Since: 3.92
  */
@@ -744,15 +744,15 @@ gtk_center_box_set_start_widget (GtkCenterBox *self,
 /**
  * gtk_center_box_set_center_widget:
  * @self: a #GtkCenterBox
- * @child: the child
+ * @child: (nullable): the new center widget, or %NULL
  *
- * Sets the center widget.
+ * Sets the center widget. To remove the existing center widget, pas %NULL.
  *
  * Since: 3.92
  */
 void
 gtk_center_box_set_center_widget (GtkCenterBox *self,
-                                 GtkWidget     *child)
+                                  GtkWidget    *child)
 {
   if (self->center_widget)
     gtk_widget_unparent (self->center_widget);
@@ -767,9 +767,9 @@ gtk_center_box_set_center_widget (GtkCenterBox *self,
 /**
  * gtk_center_box_set_end_widget:
  * @self: a #GtkCenterBox
- * @child: the child
+ * @child: (nullable): the new end widget, or %NULL
  *
- * Sets the end widget.
+ * Sets the end widget. To remove the existing end widget, pass %NULL.
  *
  * Since: 3.92
  */
@@ -791,9 +791,9 @@ gtk_center_box_set_end_widget (GtkCenterBox *self,
  * gtk_center_box_get_start_widget:
  * @self: a #GtkCenterBox
  *
- * Gets the start widget.
+ * Gets the start widget, or %NULL if there is none.
  *
- * Returns: (transfer none): the start widget.
+ * Returns: (transfer none) (nullable): the start widget.
  *
  * Since: 3.92
  */
@@ -807,9 +807,9 @@ gtk_center_box_get_start_widget (GtkCenterBox *self)
  * gtk_center_box_get_center_widget:
  * @self: a #GtkCenterBox
  *
- * Gets the center widget.
+ * Gets the center widget, or %NULL if there is none.
  *
- * Returns: (transfer none): the center widget.
+ * Returns: (transfer none) (nullable): the center widget.
  *
  * Since: 3.92
  */
@@ -823,9 +823,9 @@ gtk_center_box_get_center_widget (GtkCenterBox *self)
  * gtk_center_box_get_end_widget:
  * @self: a #GtkCenterBox
  *
- * Gets the end widget.
+ * Gets the end widget, or %NULL if there is none.
  *
- * Returns: (transfer none): the end widget.
+ * Returns: (transfer none) (nullable): the end widget.
  *
  * Since: 3.92
  */


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