Add missing (closure) GIR annotations
authorRobert Ancell <robert.ancell@canonical.com>
Mon, 13 Jan 2020 01:26:50 +0000 (14:26 +1300)
committerRobert Ancell <robert.ancell@canonical.com>
Mon, 13 Jan 2020 01:26:50 +0000 (14:26 +1300)
19 files changed:
gdk/gdkcontentproviderimpl.c
gdk/wayland/gdksurface-wayland.c
gtk/gtkfilterlistmodel.c
gtk/gtkflowbox.c
gtk/gtkfontchooser.c
gtk/gtklistbox.c
gtk/gtkmaplistmodel.c
gtk/gtkmenubutton.c
gtk/gtkprintjob.c
gtk/gtkprintsettings.c
gtk/gtkscale.c
gtk/gtksortlistmodel.c
gtk/gtktextiter.c
gtk/gtktreelistmodel.c
gtk/gtktreemodel.c
gtk/gtktreesortable.c
gtk/gtktreeview.c
gtk/gtkwidget.c
modules/printbackends/gtkcupssecretsutils.c

index ebea1356a3d37fef4b2a1260d324021fbea59fbd..c114e8c3b2081520e16ddf6ff09003beb908784c 100644 (file)
@@ -348,7 +348,7 @@ gdk_content_provider_callback_init (GdkContentProviderCallback *content)
  * gdk_content_provider_new_for_callback:
  * @type: the type that the callback provides
  * @func: callback to populate a #GValue
- * @data: data that gets passed to @func
+ * @data: (closure): data that gets passed to @func
  *
  * Create a content provider that provides data that is provided via a callback.
  *
index c24091c607e378e5513c8d6f6e6c1e766656a0fd..7aa8125048928c3e7f8f7ced567d21ec5ded2f20 100644 (file)
@@ -4109,7 +4109,7 @@ gdk_wayland_surface_is_exported (GdkSurface *surface)
  * gdk_wayland_surface_export_handle:
  * @surface: the #GdkSurface to obtain a handle for
  * @callback: callback to call with the handle
- * @user_data: user data for @callback
+ * @user_data: (closure): user data for @callback
  * @destroy_func: destroy notify for @user_data
  *
  * Asynchronously obtains a handle for a surface that can be passed
index 493c893f327e64c1b1affa323d99117d73d43f09..2f5c4dae6dc17f22bfe1cbdc5fb387b5845666ff 100644 (file)
@@ -458,7 +458,7 @@ gtk_filter_list_model_augment (GtkRbTree *filter,
  * gtk_filter_list_model_new:
  * @model: the model to sort
  * @filter_func: (allow-none): filter function or %NULL to not filter items
- * @user_data: user data passed to @filter_func
+ * @user_data: (closure): user data passed to @filter_func
  * @user_destroy: destroy notifier for @user_data
  *
  * Creates a new #GtkFilterListModel that will filter @model using the given
@@ -511,7 +511,7 @@ gtk_filter_list_model_new_for_type (GType item_type)
  * gtk_filter_list_model_set_filter_func:
  * @self: a #GtkFilterListModel
  * @filter_func: (allow-none): filter function or %NULL to not filter items
- * @user_data: user data passed to @filter_func
+ * @user_data: (closure): user data passed to @filter_func
  * @user_destroy: destroy notifier for @user_data
  *
  * Sets the function used to filter items. The function will be called for every
index d5141c4440dd215daf945b7ff6d7933b07fc3619..b662946f358a999b8ac4439a73ffd04985922b2e 100644 (file)
@@ -4045,7 +4045,7 @@ gtk_flow_box_check_model_compat (GtkFlowBox *box)
  * @box: a #GtkFlowBox
  * @model: (allow-none): the #GListModel to be bound to @box
  * @create_widget_func: a function that creates widgets for items
- * @user_data: user data passed to @create_widget_func
+ * @user_data: (closure): user data passed to @create_widget_func
  * @user_data_free_func: function for freeing @user_data
  *
  * Binds @model to @box.
index f7e0d20167d2452607f280d699bf3780aa4411fa..35fddc0f56fb798634de22413be43e1e0fd8f5e3 100644 (file)
@@ -407,7 +407,7 @@ gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser,
  * gtk_font_chooser_set_filter_func:
  * @fontchooser: a #GtkFontChooser
  * @filter: (allow-none): a #GtkFontFilterFunc, or %NULL
- * @user_data: data to pass to @filter
+ * @user_data: (closure): data to pass to @filter
  * @destroy: function to call to free @data when it is no longer needed
  *
  * Adds a filter function that decides which fonts to display
index 68ddfe083dc341d97714c3ac15d27a4e3e0da7eb..681c33f3aac94305d95bb87dfcdcb8a8da62abf5 100644 (file)
@@ -3581,7 +3581,7 @@ gtk_list_box_check_model_compat (GtkListBox *box)
  * @model: (nullable): the #GListModel to be bound to @box
  * @create_widget_func: (nullable): a function that creates widgets for items
  *   or %NULL in case you also passed %NULL as @model
- * @user_data: user data passed to @create_widget_func
+ * @user_data: (closure): user data passed to @create_widget_func
  * @user_data_free_func: function for freeing @user_data
  *
  * Binds @model to @box.
index 7d998d89ff800a993eadcfc985431cbb3e050c70..d30c3eb7a0b8848727d613926972e0dbd84eea9d 100644 (file)
@@ -424,7 +424,7 @@ gtk_map_list_model_augment (GtkRbTree *map,
  * @item_type: the #GType to use as the model's item type
  * @model: (allow-none): The model to map or %NULL for none
  * @map_func: (allow-none): map function or %NULL to not map items
- * @user_data: user data passed to @map_func
+ * @user_data: (closure): user data passed to @map_func
  * @user_destroy: destroy notifier for @user_data
  *
  * Creates a new #GtkMapListModel for the given arguments.
@@ -501,7 +501,7 @@ gtk_map_list_model_init_items (GtkMapListModel *self)
  * gtk_map_list_model_set_map_func:
  * @self: a #GtkMapListModel
  * @map_func: (allow-none): map function or %NULL to not map items
- * @user_data: user data passed to @map_func
+ * @user_data: (closure): user data passed to @map_func
  * @user_destroy: destroy notifier for @user_data
  *
  * Sets the function used to map items. The function will be called whenever
index 34278862875fd59e73350e1fa0cb9f425cc5a9e0..3e0a31a391815aa9f566ed7c7e1396bffca6386a 100644 (file)
@@ -1035,7 +1035,7 @@ gtk_menu_button_add_child (GtkMenuButton *menu_button,
  * @func: (nullable): function to call when a popuop is about to
  *   be shown, but none has been provided via other means, or %NULL
  *   to reset to default behavior.
- * @user_data: (nullable): user data to pass to @callback
+ * @user_data: (closure): user data to pass to @func.
  * @destroy_notify: (nullable): destroy notify for @user_data
  *
  * Sets @func to be called when a popup is about to be shown.
index 451d442a3f0366fdef542578f419048af3081397..f6288364ca245a34db57227a99f17328a699540e 100644 (file)
@@ -693,7 +693,7 @@ gtk_print_job_get_property (GObject    *object,
  * gtk_print_job_send:
  * @job: a GtkPrintJob
  * @callback: function to call when the job completes or an error occurs
- * @user_data: user data that gets passed to @callback
+ * @user_data: (closure): user data that gets passed to @callback
  * @dnotify: destroy notify for @user_data
  * 
  * Sends the print job off to the printer.  
index 65104bcd19ed959cb98a522b8279585b5b5aea4d..5195f525367c2bb72681fe12d7546fd7444d2f86 100644 (file)
@@ -460,7 +460,7 @@ gtk_print_settings_set_int (GtkPrintSettings *settings,
  * gtk_print_settings_foreach:
  * @settings: a #GtkPrintSettings
  * @func: (scope call): the function to call
- * @user_data: user data for @func
+ * @user_data: (closure): user data for @func
  *
  * Calls @func for each key-value pair of @settings.
  */
index 4d434ff968ffeba57a28e6599aadc0dc72f4eb3a..918ecb3bbb9b3d661450eaa98cb2952e22342317 100644 (file)
@@ -2047,7 +2047,7 @@ gtk_scale_buildable_custom_finished (GtkBuildable *buildable,
  * gtk_scale_set_format_value_func:
  * @scale: a #GtkScale
  * @func: (nullable): function that formats the value
- * @user_data: (nullable): user data to pass to @func
+ * @user_data: (closure): user data to pass to @func
  * @destroy_notify: (nullable): destroy function for @user_data
  *
  * @func allows you to change how the scale value is displayed. The given
index 4a3b09dde3bb76efcb09b28bc5814dced3789f79..ac82bb146a7a4f5f596352844cceeb706dd39508 100644 (file)
@@ -353,7 +353,7 @@ gtk_sort_list_model_init (GtkSortListModel *self)
  * gtk_sort_list_model_new:
  * @model: the model to sort
  * @sort_func: (allow-none): sort function or %NULL to not sort items
- * @user_data: user data passed to @sort_func
+ * @user_data: (closure): user data passed to @sort_func
  * @user_destroy: destroy notifier for @user_data
  *
  * Creates a new sort list model that uses the @sort_func to sort @model.
@@ -417,7 +417,7 @@ gtk_sort_list_model_create_sequences (GtkSortListModel *self)
  * gtk_sort_list_model_set_sort_func:
  * @self: a #GtkSortListModel
  * @sort_func: (allow-none): sort function or %NULL to not sort items
- * @user_data: user data passed to @sort_func
+ * @user_data: (closure): user data passed to @sort_func
  * @user_destroy: destroy notifier for @user_data
  *
  * Sets the function used to sort items. The function will be called for every
index 357b31a8a7abfa6fee5f5f0ce8cba5d4e8955bfb..c031c98fa182a8262f31240533264f45d7738d16 100644 (file)
@@ -4326,7 +4326,7 @@ matches_pred (GtkTextIter *iter,
  * gtk_text_iter_forward_find_char:
  * @iter: a #GtkTextIter
  * @pred: (scope call): a function to be called on each character
- * @user_data: user data for @pred
+ * @user_data: (closure): user data for @pred
  * @limit: (allow-none): search limit, or %NULL for none 
  * 
  * Advances @iter, calling @pred on each character. If
@@ -4364,7 +4364,7 @@ gtk_text_iter_forward_find_char (GtkTextIter         *iter,
  * gtk_text_iter_backward_find_char:
  * @iter: a #GtkTextIter
  * @pred: (scope call): function to be called on each character
- * @user_data: user data for @pred
+ * @user_data: (closure): user data for @pred
  * @limit: (allow-none): search limit, or %NULL for none
  * 
  * Same as gtk_text_iter_forward_find_char(), but goes backward from @iter.
index 597de53c6f21cacf8842c57be86c9f0137687f5d..1f22e2391e1674f9b65d1819ea967a42da25f2d1 100644 (file)
@@ -749,7 +749,7 @@ gtk_tree_list_model_init (GtkTreeListModel *self)
  * @autoexpand: %TRUE to set the autoexpand property and expand the @root model
  * @create_func: Function to call to create the #GListModel for the children
  *     of an item
- * @user_data: Data to pass to @create_func
+ * @user_data: (closure): Data to pass to @create_func
  * @user_destroy: Function to call to free @user_data
  *
  * Creates a new empty #GtkTreeListModel displaying @root with all rows collapsed.
index e6c73aae2903c3685fadfca61a82a97ef035bb4e..226791ab5aac71f4f7a4b27bb2f4fc438045ca98 100644 (file)
@@ -2008,7 +2008,7 @@ gtk_tree_model_foreach_helper (GtkTreeModel            *model,
  * gtk_tree_model_foreach:
  * @model: a #GtkTreeModel
  * @func: (scope call): a function to be called on each row
- * @user_data: user data to passed to @func
+ * @user_data: (closure): user data to passed to @func
  *
  * Calls func on each node in model in a depth-first fashion.
  *
index 4b3dac43ebaaaf1b4de6c8b32fa16240e456e478..0a2c010253e45fdb5f6c257903c5b4e813462175 100644 (file)
@@ -175,7 +175,7 @@ gtk_tree_sortable_set_sort_column_id (GtkTreeSortable  *sortable,
  * @sortable: A #GtkTreeSortable
  * @sort_column_id: the sort column id to set the function for
  * @sort_func: The comparison function
- * @user_data: (allow-none): User data to pass to @sort_func, or %NULL
+ * @user_data: (closure): User data to pass to @sort_func, or %NULL
  * @destroy: (allow-none): Destroy notifier of @user_data, or %NULL
  * 
  * Sets the comparison function used when sorting to be @sort_func. If the
@@ -207,7 +207,7 @@ gtk_tree_sortable_set_sort_func (GtkTreeSortable        *sortable,
  * gtk_tree_sortable_set_default_sort_func:
  * @sortable: A #GtkTreeSortable
  * @sort_func: The comparison function
- * @user_data: (allow-none): User data to pass to @sort_func, or %NULL
+ * @user_data: (closure): User data to pass to @sort_func, or %NULL
  * @destroy: (allow-none): Destroy notifier of @user_data, or %NULL
  * 
  * Sets the default comparison function used when sorting to be @sort_func.  
index e700bbbd91d98dea1d26569100301f0890fb3b0d..56124d6296129f5e6829a452ff4166e787d7cf5a 100644 (file)
@@ -11145,7 +11145,7 @@ gtk_tree_view_get_expander_column (GtkTreeView *tree_view)
  * gtk_tree_view_set_column_drag_function:
  * @tree_view: A #GtkTreeView.
  * @func: (allow-none): A function to determine which columns are reorderable, or %NULL.
- * @user_data: (allow-none): User data to be passed to @func, or %NULL
+ * @user_data: (closure): User data to be passed to @func, or %NULL
  * @destroy: (allow-none): Destroy notifier for @user_data, or %NULL
  *
  * Sets a user function for determining where a column may be dropped when
index 76de31262ad9257fb9b5c8dd95301262df2c58aa..aaf201b5476baf58e3aa18d1bdf0c3ee62edc7bc 100644 (file)
@@ -3094,7 +3094,7 @@ static guint tick_callback_id;
  * gtk_widget_add_tick_callback:
  * @widget: a #GtkWidget
  * @callback: function to call for updating animations
- * @user_data: data to pass to @callback
+ * @user_data: (closure): data to pass to @callback
  * @notify: function to call to free @user_data when the callback is removed.
  *
  * Queues an animation frame update and adds a callback to be called
@@ -3419,7 +3419,7 @@ ensure_surface_transform_data (GtkWidget *widget)
  * gtk_widget_add_surface_transform_changed_callback:
  * @widget: a #GtkWidget
  * @callback: a function to call when the surface transform changes
- * @user_data: data to pass to @callback
+ * @user_data: (closure): data to pass to @callback
  * @notify: function to call to free @user_data when the callback is removed
  *
  * Invokes the callback whenever the surface relative transform of the widget
index 925f7d561c05d5147997b68fa70f8173ce4038b9..8b78c97f0641e08c5962d11794340f4cca3eb867 100644 (file)
@@ -942,7 +942,7 @@ cleanup_task_data (gpointer data)
  * @source_object: Source object for this task
  * @cancellable: Cancellable to cancel this task
  * @callback: Callback to call once the query is finished
- * @user_data: The user_data passed to the callback
+ * @user_data: (closure): The user_data passed to the callback
  * @printer_uri: URI of the printer
  * @auth_info_required: Info required for authentication
  *