[gimp] gir: Add (closure) tags

[Niels De Graef <nielsdg src gnome org>]

commit 83d6764e0ed81d51fd239cdd31bad3710539cb33
Author: Niels De Graef <niels degraef barco com>
Date:   Mon May 4 21:31:30 2020 +0200

    gir: Add (closure) tags

 libgimp/gimpimagecombobox.h            |  6 +++++-
 libgimp/gimpimageprocedure.h           |  2 +-
 libgimp/gimpitemcombobox.c             |  4 ++--
 libgimp/gimpitemcombobox.h             |  7 ++++++-
 libgimp/gimploadprocedure.h            |  2 +-
 libgimp/gimpprocedure.h                |  2 +-
 libgimp/gimpsaveprocedure.h            |  2 +-
 libgimp/gimpthumbnailprocedure.h       |  2 +-
 libgimpcolor/gimpadaptivesupersample.h | 21 +++++++++++++++++++++
 libgimpwidgets/gimphelpui.c            |  2 +-
 libgimpwidgets/gimpintcombobox.h       |  5 +++++
 libgimpwidgets/gimpquerybox.h          | 10 +++++-----
 libgimpwidgets/gimpwidgetstypes.h      |  2 +-
 13 files changed, 51 insertions(+), 16 deletions(-)
---
diff --git a/libgimp/gimpimagecombobox.h b/libgimp/gimpimagecombobox.h
index 44a9db37e7..f5716220ce 100644
--- a/libgimp/gimpimagecombobox.h
+++ b/libgimp/gimpimagecombobox.h
@@ -30,7 +30,11 @@ G_BEGIN_DECLS
 
 /* For information look into the C source or the html documentation */
 
-
+/**
+ * GimpImageConstraintFunc:
+ * @image:
+ * @data: (closure):
+ */
 typedef gboolean (* GimpImageConstraintFunc) (GimpImage *image,
                                               gpointer   data);
 
diff --git a/libgimp/gimpimageprocedure.h b/libgimp/gimpimageprocedure.h
index 89f08064ed..f57f26dcb7 100644
--- a/libgimp/gimpimageprocedure.h
+++ b/libgimp/gimpimageprocedure.h
@@ -36,7 +36,7 @@ G_BEGIN_DECLS
  * @image:     the #GimpImage.
  * @drawable:  the #GimpDrawable.
  * @args:      the @procedure's remaining arguments.
- * @run_data:  the run_data given in gimp_image_procedure_new().
+ * @run_data: (closure): the run_data given in gimp_image_procedure_new().
  *
  * The image function is run during the lifetime of the GIMP session,
  * each time a plug-in image procedure is called.
diff --git a/libgimp/gimpitemcombobox.c b/libgimp/gimpitemcombobox.c
index 3931a18ff2..bde7abff0f 100644
--- a/libgimp/gimpitemcombobox.c
+++ b/libgimp/gimpitemcombobox.c
@@ -167,8 +167,8 @@ gimp_drawable_combo_box_init (GimpDrawableComboBox *combo_box)
 
 /**
  * gimp_drawable_combo_box_new:
- * @constraint:   a #GimpItemConstraintFunc or %NULL
- * @data  :       a pointer that is passed to @constraint
+ * @constraint: (nullable):   a #GimpItemConstraintFunc or %NULL
+ * @data: (closure):  a pointer that is passed to @constraint
  * @data_destroy: Destroy function for @data
  *
  * Creates a new #GimpIntComboBox filled with all currently opened
diff --git a/libgimp/gimpitemcombobox.h b/libgimp/gimpitemcombobox.h
index 2f44609082..bb71edc25e 100644
--- a/libgimp/gimpitemcombobox.h
+++ b/libgimp/gimpitemcombobox.h
@@ -54,7 +54,12 @@ GType       gimp_channel_combo_box_get_type  (void) G_GNUC_CONST;
 GType       gimp_layer_combo_box_get_type    (void) G_GNUC_CONST;
 GType       gimp_vectors_combo_box_get_type  (void) G_GNUC_CONST;
 
-
+/**
+ * GimpItemConstraintFunc:
+ * @image:
+ * @item:
+ * @data: (closure):
+ */
 typedef gboolean (* GimpItemConstraintFunc) (GimpImage *image,
                                              GimpItem  *item,
                                              gpointer   data);
diff --git a/libgimp/gimploadprocedure.h b/libgimp/gimploadprocedure.h
index 9528297d99..51d8e77968 100644
--- a/libgimp/gimploadprocedure.h
+++ b/libgimp/gimploadprocedure.h
@@ -35,7 +35,7 @@ G_BEGIN_DECLS
  * @run_mode:    the #GimpRunMode.
  * @file:        the #GFile to load from.
  * @args:        the @procedure's remaining arguments.
- * @run_data:    the run_data given in gimp_load_procedure_new().
+ * @run_data: (closure): the run_data given in gimp_load_procedure_new().
  *
  * The load function is run during the lifetime of the GIMP session,
  * each time a plug-in load procedure is called.
diff --git a/libgimp/gimpprocedure.h b/libgimp/gimpprocedure.h
index 72b26e25b5..fe53d913dd 100644
--- a/libgimp/gimpprocedure.h
+++ b/libgimp/gimpprocedure.h
@@ -35,7 +35,7 @@ G_BEGIN_DECLS
  * GimpRunFunc:
  * @procedure: the #GimpProcedure that runs.
  * @args:      the @procedure's arguments.
- * @run_data:  the run_data given in gimp_procedure_new().
+ * @run_data: (closure): the run_data given in gimp_procedure_new().
  *
  * The run function is run during the lifetime of the GIMP session,
  * each time a plug-in procedure is called.
diff --git a/libgimp/gimpsaveprocedure.h b/libgimp/gimpsaveprocedure.h
index e8c07f3d4f..e38ec3595f 100644
--- a/libgimp/gimpsaveprocedure.h
+++ b/libgimp/gimpsaveprocedure.h
@@ -37,7 +37,7 @@ G_BEGIN_DECLS
  * @drawable:    the drawable to save.
  * @file:        the #GFile to save to.
  * @args:        the @procedure's remaining arguments.
- * @run_data:    the run_data given in gimp_save_procedure_new().
+ * @run_data: (closure): the run_data given in gimp_save_procedure_new().
  *
  * The save function is run during the lifetime of the GIMP session,
  * each time a plug-in save procedure is called.
diff --git a/libgimp/gimpthumbnailprocedure.h b/libgimp/gimpthumbnailprocedure.h
index 89b8399ffe..c00d349323 100644
--- a/libgimp/gimpthumbnailprocedure.h
+++ b/libgimp/gimpthumbnailprocedure.h
@@ -35,7 +35,7 @@ G_BEGIN_DECLS
  * @file:        the #GFile to load the thumbnail from.
  * @size:        the requested thumbnail size.
  * @args:        the @procedure's remaining arguments.
- * @run_data:    the run_data given in gimp_thumbnail_procedure_new().
+ * @run_data: (closure): the run_data given in gimp_thumbnail_procedure_new().
  *
  * The thumbnail function is run during the lifetime of the GIMP session,
  * each time a plug-in thumbnail procedure is called.
diff --git a/libgimpcolor/gimpadaptivesupersample.h b/libgimpcolor/gimpadaptivesupersample.h
index 9cb2f823c7..dee0644fb1 100644
--- a/libgimpcolor/gimpadaptivesupersample.h
+++ b/libgimpcolor/gimpadaptivesupersample.h
@@ -28,14 +28,35 @@ G_BEGIN_DECLS
 /* For information look into the C source or the html documentation */
 
 
+/**
+ * GimpRenderFunc:
+ * @x:
+ * @y:
+ * @color:
+ * @data: (closure):
+ */
 typedef void (* GimpRenderFunc)   (gdouble   x,
                                    gdouble   y,
                                    GimpRGB  *color,
                                    gpointer  data);
+/**
+ * GimpPutPixelFunc:
+ * @x:
+ * @y:
+ * @color:
+ * @data: (closure):
+ */
 typedef void (* GimpPutPixelFunc) (gint      x,
                                    gint      y,
                                    GimpRGB  *color,
                                    gpointer  data);
+/**
+ * GimpProgressFunc:
+ * @min:
+ * @max:
+ * @current:
+ * @data: (closure):
+ */
 typedef void (* GimpProgressFunc) (gint      min,
                                    gint      max,
                                    gint      current,
diff --git a/libgimpwidgets/gimphelpui.c b/libgimpwidgets/gimphelpui.c
index e42195b547..f25547ae48 100644
--- a/libgimpwidgets/gimphelpui.c
+++ b/libgimpwidgets/gimphelpui.c
@@ -82,7 +82,7 @@ static gboolean   gimp_context_help_idle_show_help  (gpointer        data);
 /**
  * gimp_standard_help_func:
  * @help_id:   A unique help identifier.
- * @help_data: The @help_data passed to gimp_help_connect().
+ * @help_data: (closure): The @help_data passed to gimp_help_connect().
  *
  * This is the standard GIMP help function which does nothing but calling
  * gimp_help(). It is the right function to use in almost all cases.
diff --git a/libgimpwidgets/gimpintcombobox.h b/libgimpwidgets/gimpintcombobox.h
index 04c990f020..e05703db4a 100644
--- a/libgimpwidgets/gimpintcombobox.h
+++ b/libgimpwidgets/gimpintcombobox.h
@@ -63,6 +63,11 @@ struct _GimpIntComboBoxClass
 };
 
 
+/**
+ * GimpIntSensitivityFunc:
+ * @value:
+ * @data: (closure):
+ */
 typedef  gboolean (* GimpIntSensitivityFunc) (gint      value,
                                               gpointer  data);
 
diff --git a/libgimpwidgets/gimpquerybox.h b/libgimpwidgets/gimpquerybox.h
index 4b69439c63..7f31aa59d9 100644
--- a/libgimpwidgets/gimpquerybox.h
+++ b/libgimpwidgets/gimpquerybox.h
@@ -35,7 +35,7 @@ G_BEGIN_DECLS
  * GimpQueryStringCallback:
  * @query_box: The query box.
  * @string:    The entered string.
- * @data:      The user data.
+ * @data: (closure): user data.
  *
  * Note that you must not g_free() the passed string.
  **/
@@ -47,7 +47,7 @@ typedef void (* GimpQueryStringCallback)  (GtkWidget   *query_box,
  * GimpQueryIntCallback:
  * @query_box: The query box.
  * @value:     The entered integer value.
- * @data:      The user data.
+ * @data: (closure): user data.
  *
  * The callback for an int query box.
  **/
@@ -59,7 +59,7 @@ typedef void (* GimpQueryIntCallback)     (GtkWidget   *query_box,
  * GimpQueryDoubleCallback:
  * @query_box: The query box.
  * @value:     The entered double value.
- * @data:      The user data.
+ * @data: (closure): user data.
  *
  * The callback for a double query box.
  **/
@@ -72,7 +72,7 @@ typedef void (* GimpQueryDoubleCallback)  (GtkWidget   *query_box,
  * @query_box: The query box.
  * @size:      The entered size in pixels.
  * @unit:      The selected unit from the #GimpUnitMenu.
- * @data:      The user data.
+ * @data: (closure): user data.
  *
  * The callback for a size query box.
  **/
@@ -85,7 +85,7 @@ typedef void (* GimpQuerySizeCallback)    (GtkWidget   *query_box,
  * GimpQueryBooleanCallback:
  * @query_box: The query box.
  * @value:     The entered boolean value.
- * @data:      The user data.
+ * @data: (closure): user data.
  *
  * The callback for a boolean query box.
  **/
diff --git a/libgimpwidgets/gimpwidgetstypes.h b/libgimpwidgets/gimpwidgetstypes.h
index 0fea008b97..2b92882eaa 100644
--- a/libgimpwidgets/gimpwidgetstypes.h
+++ b/libgimpwidgets/gimpwidgetstypes.h
@@ -82,7 +82,7 @@ typedef struct _GimpZoomModel                 GimpZoomModel;
 /**
  * GimpHelpFunc:
  * @help_id:   the help ID
- * @help_data: the help user data
+ * @help_data: (closure): the help user data
  *
  * This is the prototype for all functions you pass as @help_func to
  * the various GIMP dialog constructors like gimp_dialog_new(),