[gimp] libgimpwidgets: add many missing (transfer) annotations.

From: Jehan <jehanp src gnome org>
To: commits-list gnome org
Cc:
Subject: [gimp] libgimpwidgets: add many missing (transfer) annotations.
Date: Thu, 1 Aug 2019 00:05:31 +0000 (UTC)
commit 3016dfb3478e44e870fc7cac24772847efcb42f9
Author: Jehan <jehan girinstud io>
Date:   Thu Aug 1 02:04:28 2019 +0200

    libgimpwidgets: add many missing (transfer) annotations.

 libgimpwidgets/gimpenumwidgets.c | 12 ++++-----
 libgimpwidgets/gimppropwidgets.c | 54 ++++++++++++++++++++--------------------
 libgimpwidgets/gimpscaleentry.c  |  2 +-
 3 files changed, 34 insertions(+), 34 deletions(-)
---
diff --git a/libgimpwidgets/gimpenumwidgets.c b/libgimpwidgets/gimpenumwidgets.c
index 9bb98b9825..c08ee0ca78 100644
--- a/libgimpwidgets/gimpenumwidgets.c
+++ b/libgimpwidgets/gimpenumwidgets.c
@@ -55,7 +55,7 @@
  * with up to three or four values. Often it is better to use a
  * #GimpEnumComboBox instead.
  *
- * Return value: a new #GtkVBox holding a group of #GtkRadioButtons.
+ * Return value: (transfer full): a new #GtkVBox holding a group of #GtkRadioButtons.
  *
  * Since: 2.4
  **/
@@ -97,7 +97,7 @@ gimp_enum_radio_box_new (GType       enum_type,
  * of radio buttons, but additionally it supports limiting the range
  * of available enum values.
  *
- * Return value: a new #GtkVBox holding a group of #GtkRadioButtons.
+ * Return value: (transfer full): a new #GtkVBox holding a group of #GtkRadioButtons.
  *
  * Since: 2.4
  **/
@@ -169,7 +169,7 @@ gimp_enum_radio_box_new_with_range (GType       enum_type,
  * Calls gimp_enum_radio_box_new() and puts the resulting vbox into a
  * #GtkFrame.
  *
- * Return value: a new #GtkFrame holding a group of #GtkRadioButtons.
+ * Return value: (transfer full): a new #GtkFrame holding a group of #GtkRadioButtons.
  *
  * Since: 2.4
  **/
@@ -218,7 +218,7 @@ gimp_enum_radio_frame_new (GType       enum_type,
  * Calls gimp_enum_radio_box_new_with_range() and puts the resulting
  * vbox into a #GtkFrame.
  *
- * Return value: a new #GtkFrame holding a group of #GtkRadioButtons.
+ * Return value: (transfer full): a new #GtkFrame holding a group of #GtkRadioButtons.
  *
  * Since: 2.4
  **/
@@ -271,7 +271,7 @@ gimp_enum_radio_frame_new_with_range (GType       enum_type,
  * icon name for each icon is created by appending the enum_value's
  * nick to the given @icon_prefix.
  *
- * Return value: a new horizontal #GtkBox holding a group of #GtkRadioButtons.
+ * Return value: (transfer full): a new horizontal #GtkBox holding a group of #GtkRadioButtons.
  *
  * Since: 2.10
  **/
@@ -318,7 +318,7 @@ gimp_enum_icon_box_new (GType         enum_type,
  * of radio buttons, but additionally it supports limiting the range
  * of available enum values.
  *
- * Return value: a new horizontal #GtkBox holding a group of #GtkRadioButtons.
+ * Return value: (transfer full): a new horizontal #GtkBox holding a group of #GtkRadioButtons.
  *
  * Since: 2.10
  **/
diff --git a/libgimpwidgets/gimppropwidgets.c b/libgimpwidgets/gimppropwidgets.c
index 9570efd886..9bf9d71795 100644
--- a/libgimpwidgets/gimppropwidgets.c
+++ b/libgimpwidgets/gimppropwidgets.c
@@ -96,7 +96,7 @@ static void   gimp_prop_check_button_notify   (GObject    *config,
  * If @label is #NULL, the @property_name's nick will be used as label
  * of the returned button.
  *
- * Return value: The newly created #GtkCheckButton widget.
+ * Return value: (transfer full): The newly created #GtkCheckButton widget.
  *
  * Since: 2.4
  */
@@ -207,7 +207,7 @@ static void   gimp_prop_enum_check_button_notify   (GObject    *config,
  * If @label is #NULL, the @property_name's nick will be used as label
  * of the returned button.
  *
- * Return value: The newly created #GtkCheckButton widget.
+ * Return value: (transfer full): The newly created #GtkCheckButton widget.
  *
  * Since: 2.4
  */
@@ -363,7 +363,7 @@ static void gimp_prop_pointer_combo_box_notify   (GObject    *config,
  * property.  The contents of the widget are determined by @store,
  * which should be created using gimp_int_store_new().
  *
- * Return value: The newly created #GimpIntComboBox widget.
+ * Return value: (transfer full): The newly created #GimpIntComboBox widget.
  *
  * Since: 2.4
  */
@@ -419,7 +419,7 @@ gimp_prop_int_combo_box_new (GObject      *config,
  * Values are GType/gpointer data, and therefore must be stored in the
  * "user-data" column, instead of the usual "value" column.
  *
- * Return value: The newly created #GimpIntComboBox widget.
+ * Return value: (transfer full): The newly created #GimpIntComboBox widget.
  *
  * Since: 2.10
  */
@@ -486,7 +486,7 @@ gimp_prop_pointer_combo_box_new (GObject      *config,
  * enum.  If the two values are equal (e.g., 0, 0), then the full
  * range of the Enum is used.
  *
- * Return value: The newly created #GimpEnumComboBox widget.
+ * Return value: (transfer full): The newly created #GimpEnumComboBox widget.
  *
  * Since: 2.4
  */
@@ -689,7 +689,7 @@ static void   gimp_prop_boolean_combo_box_notify   (GObject     *config,
  * displaying the @true_text label, the other displaying the
  * @false_text label.
  *
- * Return value: The newly created #GtkComboBox widget.
+ * Return value: (transfer full): The newly created #GtkComboBox widget.
  *
  * Since: 2.4
  */
@@ -805,7 +805,7 @@ static void  gimp_prop_radio_button_notify   (GObject     *config,
  * If @title is #NULL, the @property_name's nick will be used as label
  * of the returned frame.
  *
- * Return value: A #GimpFrame containing the radio buttons.
+ * Return value: (transfer full): A #GimpFrame containing the radio buttons.
  *
  * Since: 2.4
  */
@@ -881,7 +881,7 @@ gimp_prop_enum_radio_frame_new (GObject     *config,
  * If you want to assign a label to the group of radio buttons, use
  * gimp_prop_enum_radio_frame_new() instead of this function.
  *
- * Return value: A #GtkVBox containing the radio buttons.
+ * Return value: (transfer full): A #GtkVBox containing the radio buttons.
  *
  * Since: 2.4
  */
@@ -951,7 +951,7 @@ static void  gimp_prop_enum_label_notify (GObject    *config,
  * @config:         Object to which property is attached.
  * @property_name:  Name of enum property to be displayed.
  *
- * Return value: The newly created #GimpEnumLabel widget.
+ * Return value: (transfer full): The newly created #GimpEnumLabel widget.
  *
  * Since: 2.4
  */
@@ -1015,7 +1015,7 @@ gimp_prop_enum_label_notify (GObject    *config,
  * If @title is #NULL, the @property_name's nick will be used as label
  * of the returned frame.
  *
- * Return value: A #GimpFrame containing the radio buttons.
+ * Return value: (transfer full): A #GimpFrame containing the radio buttons.
  *
  * Since: 2.4
  */
@@ -1081,7 +1081,7 @@ gimp_prop_boolean_radio_frame_new (GObject     *config,
  * enum_value's nick to the given @icon_prefix.  See
  * gimp_enum_icon_box_new() for more information.
  *
- * Return value: A #libgimpwidgets-gimpenumiconbox containing the radio buttons.
+ * Return value: (transfer full): A #libgimpwidgets-gimpenumiconbox containing the radio buttons.
  *
  * Since: 2.10
  */
@@ -1200,7 +1200,7 @@ static void   gimp_prop_adjustment_notify   (GObject       *config,
  * Creates a spin button to set and display the value of the
  * specified double property.
  *
- * Return value: A new #libgimpwidgets-gimpspinbutton.
+ * Return value: (transfer full): A new #libgimpwidgets-gimpspinbutton.
  *
  * Since: 2.4
  */
@@ -1259,7 +1259,7 @@ gimp_prop_spin_button_new (GObject     *config,
  * Creates a horizontal scale to control the value of the specified
  * integer or double property.
  *
- * Return value: A new #GtkScale.
+ * Return value: (transfer full): A new #GtkScale.
  *
  * Since: 2.4
  */
@@ -1336,7 +1336,7 @@ gimp_prop_hscale_new (GObject     *config,
  * Note that the @scale_limits boolean is the inverse of
  * gimp_scale_entry_new()'s "constrain" parameter.
  *
- * Return value: The #GtkSpinButton's #GtkAdjustment.
+ * Return value: (transfer full): The #GtkSpinButton's #GtkAdjustment.
  *
  * Since: 2.4
  */
@@ -1482,7 +1482,7 @@ gimp_prop_widget_set_factor (GtkWidget     *widget,
  * which should represent an "opacity" variable with range 0 to 100.
  * See gimp_scale_entry_new() for more information.
  *
- * Return value:  The #GtkSpinButton's #GtkAdjustment.
+ * Return value: (transfer full): The #GtkSpinButton's #GtkAdjustment.
  *
  * Since: 2.4
  */
@@ -1709,7 +1709,7 @@ static void   gimp_prop_memsize_notify   (GObject          *config,
  * and display the value of the specified memsize property.  See
  * gimp_memsize_entry_new() for more information.
  *
- * Return value:  A new #GimpMemsizeEntry.
+ * Return value: (transfer full): A new #GimpMemsizeEntry.
  *
  * Since: 2.4
  */
@@ -1827,7 +1827,7 @@ static void   gimp_prop_label_notify (GObject    *config,
  * to a string.  If the user should be able to edit the string, use
  * gimp_prop_entry_new() instead.
  *
- * Return value:  A new #GtkLabel widget.
+ * Return value: (transfer full): A new #GtkLabel widget.
  *
  * Since: 2.4
  */
@@ -1924,7 +1924,7 @@ static void   gimp_prop_entry_notify   (GObject    *config,
  * Creates a #GtkEntry to set and display the value of the specified
  * string property.
  *
- * Return value:  A new #GtkEntry widget.
+ * Return value: (transfer full): A new #GtkEntry widget.
  *
  * Since: 2.4
  */
@@ -2055,7 +2055,7 @@ static void   gimp_prop_text_buffer_notify   (GObject       *config,
  * If @max_len is 0 or negative, the text buffer allows an unlimited
  * number of characters to be entered.
  *
- * Return value:  A new #GtkTextBuffer.
+ * Return value: (transfer full): A new #GtkTextBuffer.
  *
  * Since: 2.4
  */
@@ -2208,7 +2208,7 @@ static void   gimp_prop_string_combo_box_notify   (GObject     *config,
  * specified property.  The contents of the widget are determined by
  * @store.
  *
- * Return value: The newly created #GimpStringComboBox widget.
+ * Return value: (transfer full): The newly created #GimpStringComboBox widget.
  *
  * Since: 2.4
  */
@@ -2328,7 +2328,7 @@ static void        gimp_prop_file_chooser_button_notify   (GObject        *confi
  * Note that #GtkFileChooserButton implements the #GtkFileChooser
  * interface; you can use the #GtkFileChooser API with it.
  *
- * Return value:  A new #GtkFileChooserButton.
+ * Return value: (transfer full): A new #GtkFileChooserButton.
  *
  * Since: 2.4
  */
@@ -2369,7 +2369,7 @@ gimp_prop_file_chooser_button_new (GObject              *config,
  * Note that #GtkFileChooserButton implements the #GtkFileChooser
  * interface; you can use the #GtkFileChooser API with it.
  *
- * Return value:  A new #GtkFileChooserButton.
+ * Return value: (transfer full): A new #GtkFileChooserButton.
  *
  * Since: 2.4
  */
@@ -3108,7 +3108,7 @@ static void   gimp_prop_coordinates_notify_unit (GObject       *config,
  * properties, which will usually represent X and Y coordinates, and
  * their associated unit property.
  *
- * Return value:  A new #GimpSizeEntry widget.
+ * Return value: (transfer full): A new #GimpSizeEntry widget.
  *
  * Since: 2.4
  */
@@ -3563,7 +3563,7 @@ static void   gimp_prop_color_area_notify   (GObject    *config,
  * Creates a #GimpColorArea to set and display the value of an RGB
  * property.
  *
- * Return value:  A new #GimpColorArea widget.
+ * Return value: (transfer full): A new #GimpColorArea widget.
  *
  * Since: 2.4
  */
@@ -3675,7 +3675,7 @@ static void   gimp_prop_unit_combo_box_notify   (GObject    *config,
  * Creates a #GimpUnitComboBox to set and display the value of a Unit
  * property.  See gimp_unit_combo_box_new() for more information.
  *
- * Return value:  A new #GimpUnitComboBox widget.
+ * Return value: (transfer full): A new #GimpUnitComboBox widget.
  *
  * Since: 2.8
  */
@@ -3805,7 +3805,7 @@ static void   gimp_prop_icon_image_notify (GObject    *config,
  * specified string property, which should encode an icon name.
  * See gtk_image_new_from_icon_name() for more information.
  *
- * Return value:  A new #GtkImage widget.
+ * Return value: (transfer full): A new #GtkImage widget.
  *
  * Since: 2.10
  */
@@ -3885,7 +3885,7 @@ static void   gimp_prop_expander_notify (GObject     *config,
  * If @label is #NULL, the @property_name's nick will be used as label
  * of the returned widget.
  *
- * Return value:  A new #GtkExpander widget.
+ * Return value: (transfer full): A new #GtkExpander widget.
  *
  * Since: 2.4
  */
diff --git a/libgimpwidgets/gimpscaleentry.c b/libgimpwidgets/gimpscaleentry.c
index b230356166..ab69485aeb 100644
--- a/libgimpwidgets/gimpscaleentry.c
+++ b/libgimpwidgets/gimpscaleentry.c
@@ -290,7 +290,7 @@ gimp_scale_entry_new (GtkGrid     *grid,
  * This function creates a #GtkLabel, a #GimpColorScale and a
  * #GtkSpinButton and attaches them to a 3-column #GtkGrid.
  *
- * Returns: The #GtkSpinButton's #GtkAdjustment.
+ * Returns: (transfer full): The #GtkSpinButton's #GtkAdjustment.
  **/
 GtkAdjustment *
 gimp_color_scale_entry_new (GtkGrid     *grid,
[Date Prev][Date Next] [Thread Prev][Thread Next] [Thread Index] [Date Index] [Author Index]