gir: More missing annotations

Especially need to watch out with forgetting `(array)` and `(out)`
annotations, as they can really give a different API in certain (if not
most) bindings.

libgimp/gimpbrushselect.h

@@ -27,7 +27,18 @@
 
 G_BEGIN_DECLS
 
-
+/**
+ * GimpRunBrushCallback:
+ * @brush_name: Name of the brush
+ * @opacity: Opacity
+ * @spacing: Spacing
+ * @paint_mode: Paint mode
+ * @width: width
+ * @height: height
+ * @mask_data: (array): Mask data
+ * @dialog_closing: Dialog closing?
+ * @user_data: (closure): user data
+ */
 typedef void (* GimpRunBrushCallback)   (const gchar          *brush_name,
                                          gdouble               opacity,
                                          gint                  spacing,

libgimp/gimpdrawable.c

@@ -87,7 +87,7 @@ gimp_drawable_get_by_id (gint32 drawable_id)
  * Retrieves thumbnail data for the drawable identified by @drawable.
  * The thumbnail will be not larger than the requested size.
  *
- * Returns: (transfer full) (nullable): thumbnail data or %NULL if
+ * Returns: (transfer full) (array) (nullable): thumbnail data or %NULL if
  *          @drawable is invalid.
  **/
 guchar *
@@ -172,7 +172,7 @@ gimp_drawable_get_thumbnail (GimpDrawable           *drawable,
  * Retrieves thumbnail data for the drawable identified by @drawable.
  * The thumbnail will be not larger than the requested size.
  *
- * Returns: (transfer full) (nullable): thumbnail data or %NULL if
+ * Returns: (transfer full) (array) (nullable): thumbnail data or %NULL if
  *          @drawable is invalid.
  **/
 guchar *

libgimp/gimpimage.c

@@ -388,7 +388,7 @@ gimp_image_set_colormap (GimpImage    *image,
  * are returned in RGB[A] or GRAY[A] format. The bpp return value
  * gives the number of bytes per pixel in the image.
  *
- * Returns: (transfer full): the thumbnail data.
+ * Returns: (array) (transfer full): the thumbnail data.
  **/
 guchar *
 gimp_image_get_thumbnail_data (GimpImage *image,

libgimp/gimppatternselect.h

@@ -27,7 +27,15 @@
 
 G_BEGIN_DECLS
 
-
+/**
+ * GimpRunPatternCallback:
+ * @width: width
+ * @height: height
+ * @bpp: bytes per pixel
+ * @mask_data: (array): Mask data
+ * @dialog_closing: Dialog closing?
+ * @user_data: (closure): user data
+ */
 typedef void (* GimpRunPatternCallback)   (const gchar  *pattern_name,
                                            gint          width,
                                            gint          height,

libgimp/gimpzoompreview.c

@@ -884,8 +884,8 @@ gimp_zoom_preview_get_factor (GimpZoomPreview *preview)
  * This function also allow to get the current width, height and bpp of the
  * #GimpZoomPreview.
  *
- * Returns: (array): newly allocated data that should be released using g_free()
- *                   when it is not any longer needed
+ * Returns: (transfer full) (array): newly allocated data that should be
+ *          released using g_free() when it is not any longer needed
  *
  * Since: 2.4
  */

libgimpbase/gimpchecks.c

@@ -41,8 +41,8 @@
 /**
  * gimp_checks_get_shades:
  * @type:  the checkerboard type
- * @light: return location for the light shade
- * @dark:  return location for the dark shade
+ * @light: (out) (optional): return location for the light shade
+ * @dark:  (out) (optional): return location for the dark shade
  *
  * Retrieves the actual shades of gray to use when drawing a
  * checkerboard for a certain #GimpCheckType.

libgimpconfig/gimpscanner.c

@@ -465,7 +465,7 @@ gimp_scanner_parse_string_no_validate (GimpScanner  *scanner,
  * @scanner: A #GimpScanner created by gimp_scanner_new_file() or
  *           gimp_scanner_new_string()
  * @length: Length of the data to parse
- * @dest: (out): Return location for the parsed data
+ * @dest: (out) (array): Return location for the parsed data
  *
  * Returns: %TRUE on success
  *