Commit e0aa12eb authored by Matthias Clasen's avatar Matthias Clasen

Tons of transfer annotations

parent ca251cf1
......@@ -221,12 +221,11 @@ drops.
<!-- ##### FUNCTION gtk_drag_get_source_widget ##### -->
<para>
Determines the source widget for a drag.
</para>
@context: a (destination side) drag context.
@Returns: if the drag is occurring within a single application,
a pointer to the source widget. Otherwise, %NULL.
@context:
@Returns:
<!-- ##### FUNCTION gtk_drag_highlight ##### -->
......
......@@ -392,11 +392,11 @@ widget and this function does nothing.
<!-- ##### FUNCTION gtk_grab_get_current ##### -->
<para>
Queries the current grab of the default window group.
</para>
@void:
@Returns: The widget which currently has the grab or %NULL if no grab is active.
@void:
@Returns:
<!-- ##### FUNCTION gtk_grab_remove ##### -->
......
......@@ -140,11 +140,10 @@ Sets the group of a radio menu item, or changes it.
<!-- ##### FUNCTION gtk_radio_menu_item_get_group ##### -->
<para>
Returns the group to which the radio menu item belongs, as a #GList of
#GtkRadioMenuItem. The list belongs to GTK+ and should not be freed.
</para>
@radio_menu_item: a #GtkRadioMenuItem.
@Returns: the group of @radio_menu_item.
@radio_menu_item:
@Returns:
......@@ -972,7 +972,7 @@ gdk_event_set_device (GdkEvent *event,
* If the event contains a "device" field, this function will return
* it, else it will return %NULL.
*
* Returns: a #GdkDevice, or %NULL.
* Returns: (transfer none): a #GdkDevice, or %NULL.
*
* Since: 3.0
**/
......
......@@ -319,7 +319,7 @@ gtk_accel_label_finalize (GObject *object)
* Fetches the widget monitored by this accelerator label. See
* gtk_accel_label_set_accel_widget().
*
* Returns: the object monitored by the accelerator label, or %NULL.
* Returns: (transfer none): the object monitored by the accelerator label, or %NULL.
**/
GtkWidget*
gtk_accel_label_get_accel_widget (GtkAccelLabel *accel_label)
......
......@@ -873,7 +873,7 @@ gtk_action_unblock_activate (GtkAction *action)
* This function is intended for use by action implementations to
* create icons displayed in the proxy widgets.
*
* Returns: a widget that displays the icon for this action.
* Returns: (transfer full): a widget that displays the icon for this action.
*
* Since: 2.4
*/
......@@ -899,7 +899,7 @@ gtk_action_create_icon (GtkAction *action, GtkIconSize icon_size)
*
* Creates a menu item widget that proxies for the given action.
*
* Returns: a menu item connected to the action.
* Returns: (transfer full): a menu item connected to the action.
*
* Since: 2.4
*/
......@@ -924,7 +924,7 @@ gtk_action_create_menu_item (GtkAction *action)
*
* Creates a toolbar item widget that proxies for the given action.
*
* Returns: a toolbar item connected to the action.
* Returns: (transfer full): a toolbar item connected to the action.
*
* Since: 2.4
*/
......@@ -1609,7 +1609,7 @@ gtk_action_set_gicon (GtkAction *action,
*
* Gets the gicon of @action.
*
* Returns: The action's #GIcon if one is set.
* Returns: (transfer none): The action's #GIcon if one is set.
*
* Since: 2.16
*/
......@@ -1811,7 +1811,7 @@ gtk_action_disconnect_accelerator (GtkAction *action)
* item or the toolbar item it creates, this function returns an
* instance of that menu.
*
* Return value: the menu item provided by the action, or %NULL.
* Return value: (transfer full): the menu item provided by the action, or %NULL.
*
* Since: 2.12
*/
......
......@@ -478,7 +478,7 @@ gtk_activatable_do_set_related_action (GtkActivatable *activatable,
*
* Gets the related #GtkAction for @activatable.
*
* Returns: the related #GtkAction if one is set.
* Returns: (transfer none): the related #GtkAction if one is set.
*
* Since: 2.16
**/
......
......@@ -66,12 +66,12 @@ struct _GtkApplicationClass
GApplicationClass parent_class;
/*< vfuncs >*/
GtkWindow *(* create_window) (GtkApplication *application);
void (* activated) (GtkApplication *application,
GtkWindow *(* create_window) (GtkApplication *app);
void (* activated) (GtkApplication *app,
GVariant *args);
void (* action) (GtkApplication *application,
void (* action) (GtkApplication *app,
const gchar *action_name);
gboolean (* quit) (GtkApplication *application);
gboolean (* quit) (GtkApplication *app);
/* Padding for future expansion */
......
......@@ -1686,7 +1686,8 @@ gtk_assistant_get_n_pages (GtkAssistant *assistant)
*
* Returns the child widget contained in page number @page_num.
*
* Return value: The child widget, or %NULL if @page_num is out of bounds.
* Return value: (transfer none): The child widget, or %NULL
* if @page_num is out of bounds.
*
* Since: 2.10
**/
......@@ -2117,11 +2118,11 @@ gtk_assistant_set_page_header_image (GtkAssistant *assistant,
* gtk_assistant_get_page_header_image:
* @assistant: a #GtkAssistant
* @page: a page of @assistant
*
* Gets the header image for @page.
*
* Return value: the header image for @page, or %NULL
* if there's no header image for the page.
*
* Gets the header image for @page.
*
* Return value: (transfer none): the header image for @page, or %NULL
* if there's no header image for the page.
*
* Since: 2.10
**/
......@@ -2197,11 +2198,11 @@ gtk_assistant_set_page_side_image (GtkAssistant *assistant,
* gtk_assistant_get_page_side_image:
* @assistant: a #GtkAssistant
* @page: a page of @assistant
*
* Gets the header image for @page.
*
* Return value: the side image for @page, or %NULL
* if there's no side image for the page.
*
* Gets the header image for @page.
*
* Return value: (transfer none): the side image for @page, or %NULL
* if there's no side image for the page.
*
* Since: 2.10
**/
......
......@@ -204,12 +204,12 @@ gtk_buildable_parser_finished (GtkBuildable *buildable,
* @builder: #GtkBuilder used to construct this object
* @name: name of child to construct
*
* Constructs a child of @buildable with the name @name.
* Constructs a child of @buildable with the name @name.
*
* #GtkBuilder calls this function if a "constructor" has been
* specified in the UI definition.
*
* Returns: the constructed child
* Returns: (transfer full): the constructed child
*
* Since: 2.12
**/
......@@ -337,7 +337,7 @@ gtk_buildable_custom_finished (GtkBuildable *buildable,
*
* Get the internal child called @childname of the @buildable object.
*
* Returns: the internal child of the buildable object
* Returns: (transfer none): the internal child of the buildable object
*
* Since: 2.12
**/
......
......@@ -2443,7 +2443,7 @@ gtk_button_set_image (GtkButton *button,
* This may have been explicitly set by gtk_button_set_image()
* or constructed by gtk_button_new_from_stock().
*
* Return value: a #GtkWidget or %NULL in case there is no image
* Return value: (transfer none): a #GtkWidget or %NULL in case there is no image
*
* Since: 2.6
*/
......
......@@ -719,15 +719,15 @@ gtk_cell_renderer_activate (GtkCellRenderer *cell,
* @cell: a #GtkCellRenderer
* @event: a #GdkEvent
* @widget: widget that received the event
* @path: widget-dependent string representation of the event location;
* @path: widget-dependent string representation of the event location;
* e.g. for #GtkTreeView, a string representation of #GtkTreePath
* @background_area: background area as passed to gtk_cell_renderer_render()
* @cell_area: cell area as passed to gtk_cell_renderer_render()
* @flags: render flags
*
*
* Passes an activate event to the cell renderer for possible processing.
*
* Return value: A new #GtkCellEditable, or %NULL
*
* Return value: (transfer full): A new #GtkCellEditable, or %NULL
**/
GtkCellEditable *
gtk_cell_renderer_start_editing (GtkCellRenderer *cell,
......
......@@ -266,8 +266,6 @@ gtk_cell_size_request_get_height_for_width (GtkCellSizeRequest *cell,
* gtk_cell_size_request_get_size:
* @cell: a #GtkCellSizeRequest instance
* @widget: the #GtkWidget this cell will be rendering to
* @request_natural: Whether to base the contextual request off of the
* base natural or the base minimum
* @minimum_size: (out) (allow-none): location for storing the minimum size, or %NULL
* @natural_size: (out) (allow-none): location for storing the natural size, or %NULL
*
......
......@@ -923,7 +923,7 @@ gtk_cell_view_set_model (GtkCellView *cell_view,
* Returns the model for @cell_view. If no model is used %NULL is
* returned.
*
* Returns: a #GtkTreeModel used or %NULL
* Returns: (transfer none): a #GtkTreeModel used or %NULL
*
* Since: 2.16
**/
......
This diff is collapsed.
......@@ -210,7 +210,7 @@ gtk_color_selection_dialog_new (const gchar *title)
*
* Retrieves the #GtkColorSelection widget embedded in the dialog.
*
* Returns: the embedded #GtkColorSelection
* Returns: (transfer none): the embedded #GtkColorSelection
*
* Since: 2.14
**/
......
......@@ -5099,12 +5099,13 @@ out:
}
/**
* gtk_combo_box_get_model
* gtk_combo_box_get_model:
* @combo_box: A #GtkComboBox
*
* Returns the #GtkTreeModel which is acting as data source for @combo_box.
*
* Return value: (transfer none): A #GtkTreeModel which was passed during construction.
* Return value: (transfer none): A #GtkTreeModel which was passed
* during construction.
*
* Since: 2.4
*/
......@@ -5744,7 +5745,8 @@ gtk_combo_box_set_title (GtkComboBox *combo_box,
* This function is mostly intended for use by accessibility technologies;
* applications should have little use for it.
*
* Returns: the accessible object corresponding to the combo box's popup.
* Returns: (transfer none): the accessible object corresponding
* to the combo box's popup.
*
* Since: 2.6
*/
......
......@@ -1663,7 +1663,7 @@ gtk_container_forall (GtkContainer *container,
/**
* gtk_container_foreach:
* @container: a #GtkContainer
* @callback: a callback
* @callback: (scope call): a callback
* @callback_data: callback user data
*
* Invokes @callback on each non-internal child of @container. See
......
......@@ -1009,17 +1009,16 @@ gtk_drag_get_data (GtkWidget *widget,
}
/*************************************************************
/**
* gtk_drag_get_source_widget:
* Get the widget the was the source of this drag, if
* the drag originated from this application.
* arguments:
* context: The drag context for this drag
* results:
* The source widget, or NULL if the drag originated from
* a different application.
*************************************************************/
* @context: a (destination side) drag context
*
* Determines the source widget for a drag.
*
* Return value: (transfer none): if the drag is occurring
* within a single application, a pointer to the source widget.
* Otherwise, %NULL.
*/
GtkWidget *
gtk_drag_get_source_widget (GdkDragContext *context)
{
......@@ -1692,7 +1691,7 @@ _gtk_drag_dest_handle_event (GtkWidget *toplevel,
* @context: drag context
* @target_list: (allow-none): list of droppable targets, or %NULL to use
* gtk_drag_dest_get_target_list (@widget).
*
*
* Looks for a match between @context->targets and the
* @dest_target_list, returning the first matching target, otherwise
* returning %GDK_NONE. @dest_target_list should usually be the return
......@@ -1700,7 +1699,7 @@ _gtk_drag_dest_handle_event (GtkWidget *toplevel,
* have different valid targets for different parts of the widget; in
* that case, they will have to implement a drag_motion handler that
* passes the correct target list to this function.
*
*
* Return value: first target that the source offers and the dest can accept, or %GDK_NONE
**/
GdkAtom
......@@ -2561,7 +2560,7 @@ gtk_drag_begin_internal (GtkWidget *widget,
* @actions: A bitmask of the allowed drag actions for this drag.
* @button: The button the user clicked to start the drag.
* @event: The event that triggered the start of the drag.
*
*
* Initiates a drag on the source side. The function
* only needs to be used when the application is
* starting drags itself, and is not needed when
......@@ -2573,23 +2572,23 @@ gtk_drag_begin_internal (GtkWidget *widget,
* used by GTK+ to get information about the start position of the drag, for
* example if the @event is a GDK_MOTION_NOTIFY.
*
* Generally there are three cases when you want to start a drag by hand by calling
* this function:
* Generally there are three cases when you want to start a drag by hand by
* calling this function:
*
* 1. During a button-press-event handler, if you want to start a drag immediately
* when the user presses the mouse button. Pass the @event that you have in your
* button-press-event handler.
* 1. During a button-press-event handler, if you want to start a drag
* immediately when the user presses the mouse button. Pass the @event
* that you have in your button-press-event handler.
*
* 2. During a motion-notify-event handler, if you want to start a drag when the mouse
* moves past a certain threshold distance after a button-press. Pass the @event that you
* have in your motion-notify-event handler.
* 2. During a motion-notify-event handler, if you want to start a drag
* when the mouse moves past a certain threshold distance after a button-press.
* Pass the @event that you have in your motion-notify-event handler.
*
* 3. During a timeout handler, if you want to start a drag after the mouse
* button is held down for some time. Try to save the last event that you got
* from the mouse, using gdk_event_copy(), and pass it to this function
* (remember to free the event with gdk_event_free() when you are done). If you
* can really not pass a real event, pass #NULL instead.
*
* (remember to free the event with gdk_event_free() when you are done).
* If you can really not pass a real event, pass #NULL instead.
*
* Return value: the context for this drag.
**/
GdkDragContext *
......
......@@ -6680,7 +6680,7 @@ get_buffer (GtkEntry *entry)
*
* Since: 2.18
*
* Returns: A #GtkEntryBuffer object.
* Returns: (transfer none): A #GtkEntryBuffer object.
*/
GtkEntryBuffer*
gtk_entry_get_buffer (GtkEntry *entry)
......@@ -6753,7 +6753,7 @@ gtk_entry_set_buffer (GtkEntry *entry,
*
* See also gtk_entry_get_icon_window().
*
* Return value: the entry's text window.
* Return value: (transfer none): the entry's text window.
*
* Since: 2.20
**/
......@@ -7816,7 +7816,8 @@ gtk_entry_get_icon_activatable (GtkEntry *entry,
* method will work regardless of whether the icon was set using a
* #GdkPixbuf, a #GIcon, a stock item, or an icon name.
*
* Returns: A #GdkPixbuf, or %NULL if no icon is set for this position.
* Returns: (transfer none): A #GdkPixbuf, or %NULL if no icon is
* set for this position.
*
* Since: 2.16
*/
......@@ -7850,8 +7851,8 @@ gtk_entry_get_icon_pixbuf (GtkEntry *entry,
* no icon or if the icon was set by some other method (e.g., by
* stock, pixbuf, or icon name).
*
* Returns: A #GIcon, or %NULL if no icon is set or if the icon
* is not a #GIcon
* Returns: (transfer none): A #GIcon, or %NULL if no icon is set
* or if the icon is not a #GIcon
*
* Since: 2.16
*/
......@@ -8181,7 +8182,7 @@ gtk_entry_get_current_icon_drag_source (GtkEntry *entry)
*
* See also gtk_entry_get_text_window().
*
* Return value: the entry's icon window at @icon_pos.
* Return value: (transfer none): the entry's icon window at @icon_pos.
*
* Since: 2.20
*/
......@@ -9725,7 +9726,8 @@ gtk_entry_set_completion (GtkEntry *entry,
*
* Returns the auxiliary completion object currently in use by @entry.
*
* Return value: The auxiliary completion object currently in use by @entry.
* Return value: (transfer none): The auxiliary completion object currently
* in use by @entry.
*
* Since: 2.4
*/
......
......@@ -1012,7 +1012,7 @@ gtk_entry_completion_new (void)
*
* Gets the entry @completion has been attached to.
*
* Return value: The entry @completion has been attached to.
* Return value: (transfer none): The entry @completion has been attached to.
*
* Since: 2.4
*/
......@@ -1076,7 +1076,8 @@ gtk_entry_completion_set_model (GtkEntryCompletion *completion,
* Returns the model the #GtkEntryCompletion is using as data source.
* Returns %NULL if the model is unset.
*
* Return value: A #GtkTreeModel, or %NULL if none is currently being used.
* Return value: (transfer none): A #GtkTreeModel, or %NULL if none
* is currently being used.
*
* Since: 2.4
*/
......@@ -1087,7 +1088,7 @@ gtk_entry_completion_get_model (GtkEntryCompletion *completion)
if (!completion->priv->filter_model)
return NULL;
return gtk_tree_model_filter_get_model (completion->priv->filter_model);
}
......
......@@ -1969,8 +1969,9 @@ gtk_expander_set_label_widget (GtkExpander *expander,
* Retrieves the label widget for the frame. See
* gtk_expander_set_label_widget().
*
* Return value: the label widget, or %NULL if there is none.
*
* Return value: (transfer none): the label widget,
* or %NULL if there is none.
*
* Since: 2.4
**/
GtkWidget *
......
......@@ -1561,7 +1561,7 @@ gtk_file_chooser_set_current_folder_uri (GtkFileChooser *chooser,
/**
* gtk_file_chooser_get_current_folder_uri:
* @chooser: a #GtkFileChooser
*
*
* Gets the current folder of @chooser as an URI.
* See gtk_file_chooser_set_current_folder_uri().
*
......@@ -1603,7 +1603,7 @@ gtk_file_chooser_get_current_folder_uri (GtkFileChooser *chooser)
* @chooser: a #GtkFileChooser
* @file: the #GFile for the new folder
* @error: (allow-none): location to store error, or %NULL.
*
*
* Sets the current folder for @chooser from a #GFile.
* Internal function, see gtk_file_chooser_set_current_folder_uri().
*
......@@ -1627,11 +1627,11 @@ gtk_file_chooser_set_current_folder_file (GtkFileChooser *chooser,
/**
* gtk_file_chooser_get_current_folder_file:
* @chooser: a #GtkFileChooser
*
*
* Gets the current folder of @chooser as #GFile.
* See gtk_file_chooser_get_current_folder_uri().
*
* Return value: the #GFile for the current folder.
*
* Return value: (transfer full): the #GFile for the current folder.
*
* Since: 2.14
*/
......@@ -1640,7 +1640,7 @@ gtk_file_chooser_get_current_folder_file (GtkFileChooser *chooser)
{
g_return_val_if_fail (GTK_IS_FILE_CHOOSER (chooser), NULL);
return GTK_FILE_CHOOSER_GET_IFACE (chooser)->get_current_folder (chooser);
return GTK_FILE_CHOOSER_GET_IFACE (chooser)->get_current_folder (chooser);
}
/**
......@@ -1779,8 +1779,8 @@ gtk_file_chooser_set_file (GtkFileChooser *chooser,
* If the file chooser is in folder mode, this function returns the selected
* folder.
*
* Returns: a selected #GFile. You own the returned file; use
* g_object_unref() to release it.
* Returns: (transfer full): a selected #GFile. You own the returned file;
* use g_object_unref() to release it.
*
* Since: 2.14
**/
......@@ -1860,11 +1860,11 @@ gtk_file_chooser_set_preview_widget (GtkFileChooser *chooser,
/**
* gtk_file_chooser_get_preview_widget:
* @chooser: a #GtkFileChooser
*
*
* Gets the current preview widget; see
* gtk_file_chooser_set_preview_widget().
*
* Return value: the current preview widget, or %NULL
*
* Return value: (transfer none): the current preview widget, or %NULL
*
* Since: 2.4
**/
......@@ -1982,12 +1982,12 @@ gtk_file_chooser_get_use_preview_label (GtkFileChooser *chooser)
/**
* gtk_file_chooser_get_preview_file:
* @chooser: a #GtkFileChooser
*
*
* Gets the #GFile that should be previewed in a custom preview
* Internal function, see gtk_file_chooser_get_preview_uri().
*
* Return value: the #GFile for the file to preview, or %NULL if no file
* is selected. Free with g_object_unref().
*
* Return value: (transfer none): the #GFile for the file to preview,
* or %NULL if no file is selected. Free with g_object_unref().
*
* Since: 2.14
**/
......@@ -2131,11 +2131,11 @@ gtk_file_chooser_set_extra_widget (GtkFileChooser *chooser,
/**
* gtk_file_chooser_get_extra_widget:
* @chooser: a #GtkFileChooser
*
*
* Gets the current preview widget; see
* gtk_file_chooser_set_extra_widget().
*
* Return value: the current extra widget, or %NULL
*
* Return value: (transfer none): the current extra widget, or %NULL
*
* Since: 2.4
**/
......@@ -2248,10 +2248,10 @@ gtk_file_chooser_set_filter (GtkFileChooser *chooser,
/**
* gtk_file_chooser_get_filter:
* @chooser: a #GtkFileChooser
*
*
* Gets the current filter; see gtk_file_chooser_set_filter().
*
* Return value: the current filter, or %NULL
*
* Return value: (transfer none): the current filter, or %NULL
*
* Since: 2.4
**/
......
......@@ -1208,8 +1208,8 @@ gtk_font_selection_update_preview (GtkFontSelection *fontsel)
*
* This returns the #GtkTreeView that lists font families, for
* example, 'Sans', 'Serif', etc.
*
* Return value: A #GtkWidget that is part of @fontsel
*
* Return value: (transfer none): A #GtkWidget that is part of @fontsel
*
* Since: 2.14
*/
......@@ -1228,7 +1228,7 @@ gtk_font_selection_get_family_list (GtkFontSelection *fontsel)
* This returns the #GtkTreeView which lists all styles available for
* the selected font. For example, 'Regular', 'Bold', etc.
*
* Return value: A #GtkWidget that is part of @fontsel
* Return value: (transfer none): A #GtkWidget that is part of @fontsel
*
* Since: 2.14
*/
......@@ -1245,9 +1245,9 @@ gtk_font_selection_get_face_list (GtkFontSelection *fontsel)
* @fontsel: a #GtkFontSelection
*
* This returns the #GtkEntry used to allow the user to edit the font
* number manually instead of selecting it from the list of font sizes.
*
* Return value: A #GtkWidget that is part of @fontsel
* number manually instead of selecting it from the list of font sizes.
*
* Return value: (transfer none): A #GtkWidget that is part of @fontsel
*
* Since: 2.14
*/
......@@ -1263,9 +1263,9 @@ gtk_font_selection_get_size_entry (GtkFontSelection *fontsel)
* gtk_font_selection_get_size_list:
* @fontsel: a #GtkFontSelection
*
* This returns the #GtkTreeeView used to list font sizes.
*
* Return value: A #GtkWidget that is part of @fontsel
* This returns the #GtkTreeeView used to list font sizes.
*
* Return value: (transfer none): A #GtkWidget that is part of @fontsel
*
* Since: 2.14
*/
......@@ -1280,10 +1280,10 @@ gtk_font_selection_get_size_list (GtkFontSelection *fontsel)
/**
* gtk_font_selection_get_preview_entry:
* @fontsel: a #GtkFontSelection
*
*
* This returns the #GtkEntry used to display the font as a preview.
*
* Return value: A #GtkWidget that is part of @fontsel
* Return value: (transfer none): A #GtkWidget that is part of @fontsel
*
* Since: 2.14
*/
......@@ -1298,13 +1298,13 @@ gtk_font_selection_get_preview_entry (GtkFontSelection *fontsel)
/**
* gtk_font_selection_get_family:
* @fontsel: a #GtkFontSelection
*
*
* Gets the #PangoFontFamily representing the selected font family.
*
* Return value: A #PangoFontFamily representing the selected font
* family. Font families are a collection of font faces. The
* returned object is owned by @fontsel and must not be modified
* or freed.
* Return value: (transfer none): A #PangoFontFamily representing the
* selected font family. Font families are a collection of font
* faces. The returned object is owned by @fontsel and must not
* be modified or freed.
*
* Since: 2.14
*/
......@@ -1319,13 +1319,13 @@ gtk_font_selection_get_family (GtkFontSelection *fontsel)
/**
* gtk_font_selection_get_face:
* @fontsel: a #GtkFontSelection
*
*
* Gets the #PangoFontFace representing the selected font group
* details (i.e. family, slant, weight, width, etc).
* details (i.e. family, slant, weight, width, etc).
*
* Return value: A #PangoFontFace representing the selected font
* group details. The returned object is owned by @fontsel and
* must not be modified or freed.
* Return value: (transfer none): A #PangoFontFace representing the
* selected font group details. The returned object is owned by
* @fontsel and must not be modified or freed.
*
* Since: 2.14
*/
......@@ -1340,10 +1340,10 @@ gtk_font_selection_get_face (GtkFontSelection *fontsel)
/**
* gtk_font_selection_get_size:
* @fontsel: a #GtkFontSelection
*
*
* The selected font size.
*
* Return value: A n integer representing the selected font size,
* Return value: A n integer representing the selected font size,
* or -1 if no font size is selected.
*
* Since: 2.14
......@@ -1686,11 +1686,11 @@ gtk_font_selection_dialog_new (const gchar *title)
/**
* gtk_font_selection_dialog_get_font_selection:
* @colorsel: a #GtkFontSelectionDialog
* @fsd: a #GtkFontSelectionDialog
*
* Retrieves the #GtkFontSelection widget embedded in the dialog.
*
* Returns: the embedded #GtkFontSelection
* Returns: (transfer none): the embedded #GtkFontSelection
*
* Since: 2.22
**/
......@@ -1709,7 +1709,8 @@ gtk_font_selection_dialog_get_font_selection (GtkFontSelectionDialog *fsd)
*
* Gets the 'OK' button.
*
* Return value: the #GtkWidget used in the dialog for the 'OK' button.
* Return value: (transfer none): the #GtkWidget used in the dialog
* for the 'OK' button.
*
* Since: 2.14
*/
......@@ -1727,7 +1728,8 @@ gtk_font_selection_dialog_get_ok_button (GtkFontSelectionDialog *fsd)
*
* Gets the 'Cancel' button.
*
* Return value: the #GtkWidget used in the dialog for the 'Cancel' button.
* Return value: (transfer none): the #GtkWidget used in the dialog
* for the 'Cancel' button.
*
* Since: 2.14
*/
......
......@@ -446,7 +446,7 @@ gtk_frame_set_label_widget (GtkFrame *frame,
* Retrieves the label widget for the frame. See
* gtk_frame_set_label_widget().
*
* Return value: the label widget, or %NULL if there is none.
* Return value: (transfer none): the label widget, or %NULL if there is none.
**/
GtkWidget *
gtk_frame_get_label_widget (GtkFrame *frame)
......