[gimp] gir: Mark more (out) annotations

[Niels De Graef <nielsdg src gnome org>]

commit 4b6362c0bdff41245b5461f1534649b23ffb6503
Author: Niels De Graef <nielsdegraef gmail com>
Date:   Fri May 8 17:11:14 2020 +0200

    gir: Mark more (out) annotations

 libgimpwidgets/gimpintcombobox.c  |  2 +-
 libgimpwidgets/gimppageselector.c |  6 +++---
 libgimpwidgets/gimppreview.c      | 24 +++++++++++++++++++-----
 3 files changed, 23 insertions(+), 9 deletions(-)
---
diff --git a/libgimpwidgets/gimpintcombobox.c b/libgimpwidgets/gimpintcombobox.c
index c300d751d1..d865ef2170 100644
--- a/libgimpwidgets/gimpintcombobox.c
+++ b/libgimpwidgets/gimpintcombobox.c
@@ -463,7 +463,7 @@ gimp_int_combo_box_set_active (GimpIntComboBox *combo_box,
 /**
  * gimp_int_combo_box_get_active:
  * @combo_box: a #GimpIntComboBox
- * @value:     return location for the integer value
+ * @value: (out): return location for the integer value
  *
  * Retrieves the value of the selected (active) item in the @combo_box.
  *
diff --git a/libgimpwidgets/gimppageselector.c b/libgimpwidgets/gimppageselector.c
index a37daadf41..4e16d3023b 100644
--- a/libgimpwidgets/gimppageselector.c
+++ b/libgimpwidgets/gimppageselector.c
@@ -856,10 +856,10 @@ gimp_page_selector_page_is_selected (GimpPageSelector *selector,
 /**
  * gimp_page_selector_get_selected_pages:
  * @selector: Pointer to a #GimpPageSelector.
- * @n_selected_pages: Returns the number of selected pages.
+ * @n_selected_pages: (out): Returns the number of selected pages.
  *
- * Returns: A sorted array of page numbers of selected pages. Use g_free() if
- *          you don't need the array any longer.
+ * Returns: (array length=n_selected_pages): A sorted array of page numbers of
+ *          selected pages. Use g_free() if you don't need the array any longer
  *
  * Since: 2.4
  **/
diff --git a/libgimpwidgets/gimppreview.c b/libgimpwidgets/gimppreview.c
index 4b0ae0df0f..7b1df2a7cb 100644
--- a/libgimpwidgets/gimppreview.c
+++ b/libgimpwidgets/gimppreview.c
@@ -617,6 +617,14 @@ gimp_preview_set_bounds (GimpPreview *preview,
                                   ymax - ymin);
 }
 
+/**
+ * gimp_preview_get_bounds:
+ * @preview: A #GimpPreview:
+ * @xmin: (out) (optional): Lower bound for x
+ * @ymin: (out) (optional): Lower bound for y
+ * @xmax: (out) (optional): Higher bound for x
+ * @ymax: (out) (optional): Higher bound for y
+ */
 void
 gimp_preview_get_bounds (GimpPreview *preview,
                          gint        *xmin,
@@ -691,6 +699,12 @@ gimp_preview_set_offsets (GimpPreview *preview,
   priv->yoff = yoff;
 }
 
+/**
+ * gimp_preview_get_offsets:
+ * @preview: A #GimpPreview:
+ * @xoff: (out) (optional): X offset
+ * @yoff: (out) (optional): Y offset
+ */
 void
 gimp_preview_get_offsets (GimpPreview *preview,
                           gint        *xoff,
@@ -734,8 +748,8 @@ gimp_preview_get_position (GimpPreview *preview,
  * @preview: a #GimpPreview widget
  * @src_x:   horizontal position on the previewed image
  * @src_y:   vertical position on the previewed image
- * @dest_x:  returns the transformed horizontal position
- * @dest_y:  returns the transformed vertical position
+ * @dest_x: (out): returns the transformed horizontal position
+ * @dest_y: (out): returns the transformed vertical position
  *
  * Transforms from image to widget coordinates.
  *
@@ -760,8 +774,8 @@ gimp_preview_transform (GimpPreview *preview,
  * @preview: a #GimpPreview widget
  * @src_x:   horizontal position relative to the preview area's origin
  * @src_y:   vertical position relative to  preview area's origin
- * @dest_x:  returns the untransformed horizontal position
- * @dest_y:  returns the untransformed vertical position
+ * @dest_x: (out): returns the untransformed horizontal position
+ * @dest_y: (out): returns the untransformed vertical position
  *
  * Transforms from widget to image coordinates.
  *
@@ -859,7 +873,7 @@ gimp_preview_draw (GimpPreview *preview)
 /**
  * gimp_preview_draw_buffer:
  * @preview:   a #GimpPreview widget
- * @buffer:    a pixel buffer the size of the preview
+ * @buffer: (array): a pixel buffer the size of the preview
  * @rowstride: the @buffer's rowstride
  *
  * Calls the GimpPreview::draw_buffer method. GimpPreview itself