From bdac38a85492c20dfc0366332b6683c7cdaae244 Mon Sep 17 00:00:00 2001
From: Michael Natterer <mitch@gimp.org>
Date: Thu, 1 Aug 2019 14:02:21 +0200
Subject: [PATCH] libgimpwidgets: add and fix some annotations

---
 libgimpwidgets/gimpcolordisplay.c         | 6 ++++--
 libgimpwidgets/gimpcolornotebook.c        | 3 ++-
 libgimpwidgets/gimpcolorprofilecombobox.c | 2 +-
 libgimpwidgets/gimpcolorselection.c       | 7 ++++---
 libgimpwidgets/gimpsizeentry.c            | 2 +-
 5 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/libgimpwidgets/gimpcolordisplay.c b/libgimpwidgets/gimpcolordisplay.c
index ed01a567f6..f0bf881a5a 100644
--- a/libgimpwidgets/gimpcolordisplay.c
+++ b/libgimpwidgets/gimpcolordisplay.c
@@ -414,7 +414,8 @@ gimp_color_display_get_enabled (GimpColorDisplay *display)
  * gimp_color_display_get_config:
  * @display:
  *
- * Return value: (transfer none): a pointer to the #GimpColorConfig object or %NULL.
+ * Return value: (transfer none): a pointer to the #GimpColorConfig
+ *               object or %NULL.
  *
  * Since: 2.4
  **/
@@ -430,7 +431,8 @@ gimp_color_display_get_config (GimpColorDisplay *display)
  * gimp_color_display_get_managed:
  * @display:
  *
- * Return value: (transfer none): a pointer to the #GimpColorManaged object or %NULL.
+ * Return value: (transfer none): a pointer to the #GimpColorManaged
+ *               object or %NULL.
  *
  * Since: 2.4
  **/
diff --git a/libgimpwidgets/gimpcolornotebook.c b/libgimpwidgets/gimpcolornotebook.c
index 6cfe3c7eec..72b4a42c9c 100644
--- a/libgimpwidgets/gimpcolornotebook.c
+++ b/libgimpwidgets/gimpcolornotebook.c
@@ -568,7 +568,8 @@ gimp_color_notebook_get_notebook (GimpColorNotebook *notebook)
  * gimp_color_notebook_get_selectors:
  * @notebook:  A #GimpColorNotebook widget.
  *
- * Return value: (transfer none): The notebook's list of #GimpColorSelector's.
+ * Return value: (element-type GimpColorSelector) (transfer-none): The
+ *               notebook's list of #GimpColorSelector's.
  *
  * Since: 3.0
  **/
diff --git a/libgimpwidgets/gimpcolorprofilecombobox.c b/libgimpwidgets/gimpcolorprofilecombobox.c
index 459bf42fd8..c21afc6430 100644
--- a/libgimpwidgets/gimpcolorprofilecombobox.c
+++ b/libgimpwidgets/gimpcolorprofilecombobox.c
@@ -446,7 +446,7 @@ gimp_color_profile_combo_box_set_active_file (GimpColorProfileComboBox *combo,
  * gimp_color_profile_combo_box_get_active_file:
  * @combo: a #GimpColorProfileComboBox
  *
- * Return value: (transfer full): The file of the currently selected
+ * Return value: (transfer none): The file of the currently selected
  *               color profile, release using g_object_unref() when it
  *               is not any longer needed.
  *
diff --git a/libgimpwidgets/gimpcolorselection.c b/libgimpwidgets/gimpcolorselection.c
index bd95532ad4..b9d40359ba 100644
--- a/libgimpwidgets/gimpcolorselection.c
+++ b/libgimpwidgets/gimpcolorselection.c
@@ -471,7 +471,7 @@ gimp_color_selection_set_color (GimpColorSelection *selection,
 /**
  * gimp_color_selection_get_color:
  * @selection: A #GimpColorSelection widget.
- * @color:     Return location for the @selection's current @color.
+ * @color:     (out): Return location for the @selection's current @color.
  *
  * This function returns the #GimpColorSelection's current color.
  **/
@@ -509,7 +509,7 @@ gimp_color_selection_set_old_color (GimpColorSelection *selection,
 /**
  * gimp_color_selection_get_old_color:
  * @selection: A #GimpColorSelection widget.
- * @color:     Return location for the @selection's old @color.
+ * @color:     (out): Return location for the @selection's old @color.
  *
  * This function returns the #GimpColorSelection's old color.
  **/
@@ -611,7 +611,8 @@ gimp_color_selection_get_notebook (GimpColorSelection *selection)
  * gimp_color_selection_get_right_vbox:
  * @selection: A #GimpColorSelection widget.
  *
- * Returns: (transfer none): The selection's right #GtkBox which contains the color scales.
+ * Returns: (transfer none): The selection's right #GtkBox which
+ *          contains the color scales.
  *
  * Since: 3.0
  */
diff --git a/libgimpwidgets/gimpsizeentry.c b/libgimpwidgets/gimpsizeentry.c
index 3bf70659e2..c51eabf350 100644
--- a/libgimpwidgets/gimpsizeentry.c
+++ b/libgimpwidgets/gimpsizeentry.c
@@ -559,7 +559,7 @@ gimp_size_entry_get_unit_combo (GimpSizeEntry *gse)
  *
  * Attaches a #GtkLabel to the #GimpSizeEntry (which is a #GtkGrid).
  *
- * Returns: (transfer full): A pointer to the new #GtkLabel widget.
+ * Returns: (transfer none): A pointer to the new #GtkLabel widget.
  **/
 GtkWidget *
 gimp_size_entry_attach_label (GimpSizeEntry *gse,