[gtk/ebassi/for-master: 2/2] Annotate more functions returning GListModel



commit 555230ec9c6018fe17765e85377b9cfba3dce64e
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Mon Apr 27 14:46:23 2020 +0100

    Annotate more functions returning GListModel
    
    Now that we can have an element-type annotation, we should use it where
    needed.

 gtk/gtkassistant.c        | 2 +-
 gtk/gtkconstraintlayout.c | 8 ++++----
 gtk/gtknotebook.c         | 3 ++-
 gtk/gtkwidget.c           | 6 ++++--
 4 files changed, 11 insertions(+), 8 deletions(-)
---
diff --git a/gtk/gtkassistant.c b/gtk/gtkassistant.c
index 91e9dcfef7..c0b00dbf8f 100644
--- a/gtk/gtkassistant.c
+++ b/gtk/gtkassistant.c
@@ -2481,7 +2481,7 @@ gtk_assistant_pages_new (GtkAssistant *assistant)
  * 
  * Gets a list model of the assistant pages.
  *
- * Returns: (transfer full): A list model of the pages.
+ * Returns: (transfer full) (attributes element-type=GtkAssistantPage): A list model of the pages.
  */
 GListModel *
 gtk_assistant_get_pages (GtkAssistant *assistant)
diff --git a/gtk/gtkconstraintlayout.c b/gtk/gtkconstraintlayout.c
index 7f012da0c6..91f1e13c03 100644
--- a/gtk/gtkconstraintlayout.c
+++ b/gtk/gtkconstraintlayout.c
@@ -2172,8 +2172,8 @@ gtk_constraint_layout_add_constraints_from_description (GtkConstraintLayout *lay
  * Applications should try hard to avoid calling this function
  * because of the slowdowns.
  *
- * Returns: (transfer full): a #GListModel tracking @layout's
- *     constraints 
+ * Returns: (transfer full) (attributes element-type=GtkConstraint): a
+ *   #GListModel tracking @layout's constraints
  */
 GListModel *
 gtk_constraint_layout_observe_constraints (GtkConstraintLayout *layout)
@@ -2212,8 +2212,8 @@ gtk_constraint_layout_observe_constraints (GtkConstraintLayout *layout)
  * Applications should try hard to avoid calling this function
  * because of the slowdowns.
  *
- * Returns: (transfer full): a #GListModel tracking @layout's
- *     guides
+ * Returns: (transfer full) (attributes element-type=GtkConstraintGuide): a
+ *   #GListModel tracking @layout's guides
  */
 GListModel *
 gtk_constraint_layout_observe_guides (GtkConstraintLayout *layout)
diff --git a/gtk/gtknotebook.c b/gtk/gtknotebook.c
index 3a22d028c8..a594e7974d 100644
--- a/gtk/gtknotebook.c
+++ b/gtk/gtknotebook.c
@@ -7190,7 +7190,8 @@ gtk_notebook_pages_new (GtkNotebook *notebook)
  * Returns a #GListModel that contains the pages of the notebook,
  * and can be used to keep an up-to-date view.
  * 
- * Returns: (transfer full): a #GListModel for the notebook's children
+ * Returns: (transfer full) (attributes element-type=GtkNotebookPage): a
+ *   #GListModel for the notebook's children
  */
 GListModel *
 gtk_notebook_get_pages (GtkNotebook *notebook)
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index cf5499b8d4..eb8357231a 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -11677,7 +11677,8 @@ gtk_widget_child_observer_destroyed (gpointer widget)
  * Applications should try hard to avoid calling this function because of
  * the slowdowns.
  *
- * Returns: (transfer full): a #GListModel tracking @widget's children
+ * Returns: (transfer full) (attributes element-type=GtkWidget): a #GListModel
+ *   tracking @widget's children
  **/
 GListModel *
 gtk_widget_observe_children (GtkWidget *widget)
@@ -11749,7 +11750,8 @@ gtk_widget_controller_list_get_item (gpointer item,
  * Applications should try hard to avoid calling this function because of
  * the slowdowns.
  *
- * Returns: (transfer full): a #GListModel tracking @widget's controllers
+ * Returns: (transfer full) (attributes element-type=GtkEventController): a
+ *   #GListModel tracking @widget's controllers
  **/
 GListModel *
 gtk_widget_observe_controllers (GtkWidget *widget)


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