[gtk/matthiasc/for-master: 1/6] stack: Cosmetic documentation fixes



commit 1ba588547612882bdf1c5267615ae290eed668dd
Author: Matthias Clasen <mclasen redhat com>
Date:   Sun Jun 28 08:06:17 2020 -0400

    stack: Cosmetic documentation fixes
    
    Fix parameter mismatches.

 gtk/gtkstack.c | 16 +++++++++-------
 gtk/gtkstack.h |  2 +-
 2 files changed, 10 insertions(+), 8 deletions(-)
---
diff --git a/gtk/gtkstack.c b/gtk/gtkstack.c
index b37769dac5..423676fc1e 100644
--- a/gtk/gtkstack.c
+++ b/gtk/gtkstack.c
@@ -1504,16 +1504,16 @@ gtk_stack_get_child_by_name (GtkStack    *stack,
 
 /**
  * gtk_stack_page_get_child:
- * @page: a #GtkStackPage
+ * @self: a #GtkStackPage
  *
- * Returns the stack child to which @page belongs.
+ * Returns the stack child to which @self belongs.
  *
- * Returns: (transfer none): the child to which @page belongs
+ * Returns: (transfer none): the child to which @self belongs
  */
 GtkWidget *
-gtk_stack_page_get_child (GtkStackPage *page)
+gtk_stack_page_get_child (GtkStackPage *self)
 {
-  return page->widget;
+  return self->widget;
 }
 
 /**
@@ -2456,11 +2456,13 @@ gtk_stack_get_pages (GtkStack *stack)
 
 /**
  * gtk_stack_page_get_visible:
- * @page: a #GtkStackPage
+ * @self: a #GtkStackPage
  *
  * Returns whether @page is visible in its #GtkStack.
  * This is independent from the #GtkWidget:visible value of its
  * #GtkWidget.
+ *
+ * Returns: %TRUE if @page is visible
  */
 gboolean
 gtk_stack_page_get_visible (GtkStackPage *self)
@@ -2472,7 +2474,7 @@ gtk_stack_page_get_visible (GtkStackPage *self)
 
 /**
  * gtk_stack_page_set_visible:
- * @page: a #GtkStackPage
+ * @self: a #GtkStackPage
  * @visible: The new property value
  *
  * Sets the new value of the #GtkStackPage:visible property
diff --git a/gtk/gtkstack.h b/gtk/gtkstack.h
index 57ccf26e86..fd797c93a2 100644
--- a/gtk/gtkstack.h
+++ b/gtk/gtkstack.h
@@ -73,7 +73,7 @@ typedef enum {
 GDK_AVAILABLE_IN_ALL
 GType                  gtk_stack_page_get_type            (void) G_GNUC_CONST;
 GDK_AVAILABLE_IN_ALL
-GtkWidget *            gtk_stack_page_get_child           (GtkStackPage           *page);
+GtkWidget *            gtk_stack_page_get_child           (GtkStackPage           *self);
 GDK_AVAILABLE_IN_ALL
 gboolean               gtk_stack_page_get_visible         (GtkStackPage           *self);
 GDK_AVAILABLE_IN_ALL


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