dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

libgimpwidgets: add many missing (transfer) annotations.

This commit is contained in:
Jehan 2019-08-01 02:04:28 +02:00
parent 6fe2508301
commit 3016dfb347
3 changed files with 34 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
libgimpwidgets/gimpenumwidgets.c
View File

@ -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
**/

54
libgimpwidgets/gimppropwidgets.c
View File

@ -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
*/

2
libgimpwidgets/gimpscaleentry.c
View File

@ -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,