callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Tons of transfer annotations

Browse Source
This commit is contained in:
Matthias Clasen 2010-09-21 00:18:11 -04:00
parent ca251cf1d4
commit e0aa12eb0a
84 changed files with 815 additions and 772 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/reference/gtk/tmpl/gtkdnd.sgml
View File

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

4
docs/reference/gtk/tmpl/gtkmain.sgml
View File

@ -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.
@Returns:
<!-- ##### FUNCTION gtk_grab_remove ##### -->

7
docs/reference/gtk/tmpl/gtkradiomenuitem.sgml
View File

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

2
gdk/gdkevents.c
View File

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

2
gtk/gtkaccellabel.c
View File

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

10
gtk/gtkaction.c
View File

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

2
gtk/gtkactivatable.c
View File

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

8
gtk/gtkapplication.h
View File

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

7
gtk/gtkassistant.c
View File

@ -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
**/
@ -2120,7 +2121,7 @@ gtk_assistant_set_page_header_image (GtkAssistant *assistant,
*
* Gets the header image for @page.
*
* Return value: the header image for @page, or %NULL
* Return value: (transfer none): the header image for @page, or %NULL
* if there's no header image for the page.
*
* Since: 2.10
@ -2200,7 +2201,7 @@ gtk_assistant_set_page_side_image (GtkAssistant *assistant,
*
* Gets the header image for @page.
*
* Return value: the side image for @page, or %NULL
* Return value: (transfer none): the side image for @page, or %NULL
* if there's no side image for the page.
*
* Since: 2.10

4
gtk/gtkbuildable.c
View File

@ -209,7 +209,7 @@ gtk_buildable_parser_finished (GtkBuildable *buildable,
* #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
**/

2
gtk/gtkbutton.c
View File

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

2
gtk/gtkcellrenderer.c
View File

@ -727,7 +727,7 @@ gtk_cell_renderer_activate (GtkCellRenderer *cell,
*
* 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,

2
gtk/gtkcellsizerequest.c
View File

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

2
gtk/gtkcellview.c
View File

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

80
gtk/gtkclipboard.c
View File

@ -567,18 +567,19 @@ gtk_clipboard_set_contents (GtkClipboard *clipboard,
* @targets: array containing information about the available forms for the
* clipboard data
* @n_targets: number of elements in @targets
* @get_func: function to call to get the actual clipboard data
* @clear_func: when the clipboard contents are set again, this function will
* be called, and @get_func will not be subsequently called.
* @get_func: (scope async): function to call to get the actual clipboard data
* @clear_func: (scope async): when the clipboard contents are set again,
* this function will be called, and @get_func will not be subsequently
* called.
* @user_data: user data to pass to @get_func and @clear_func.
*
* Virtually sets the contents of the specified clipboard by providing
* a list of supported formats for the clipboard data and a function
* to call to get the actual data when it is requested.
*
* Return value: %TRUE if setting the clipboard data succeeded. If setting
* the clipboard data failed the provided callback functions
* will be ignored.
* Return value: %TRUE if setting the clipboard data succeeded.
* If setting the clipboard data failed the provided callback
* functions will be ignored.
**/
gboolean
gtk_clipboard_set_with_data (GtkClipboard *clipboard,
@ -600,14 +601,15 @@ gtk_clipboard_set_with_data (GtkClipboard *clipboard,
/**
* gtk_clipboard_set_with_owner:
* @clipboard: a #GtkClipboard
* @targets: array containing information about the available forms for the
* clipboard data
* @targets: array containing information about the available forms for
* the clipboard data
* @n_targets: number of elements in @targets
* @get_func: function to call to get the actual clipboard data
* @clear_func: when the clipboard contents are set again, this function will
* be called, and @get_func will not be subsequently called.
* @get_func: (scope async): function to call to get the actual clipboard data
* @clear_func: (scope async): when the clipboard contents are set again,
* this function will be called, and @get_func will not be subsequently
* called
* @owner: an object that "owns" the data. This object will be passed
* to the callbacks when called.
* to the callbacks when called
*
* Virtually sets the contents of the specified clipboard by providing
* a list of supported formats for the clipboard data and a function
@ -617,9 +619,9 @@ gtk_clipboard_set_with_data (GtkClipboard *clipboard,
* is that instead of an generic @user_data pointer, a #GObject is passed
* in.
*
* Return value: %TRUE if setting the clipboard data succeeded. If setting
* the clipboard data failed the provided callback functions
* will be ignored.
* Return value: %TRUE if setting the clipboard data succeeded.
* If setting the clipboard data failed the provided callback
* functions will be ignored.
**/
gboolean
gtk_clipboard_set_with_owner (GtkClipboard *clipboard,
@ -648,7 +650,8 @@ gtk_clipboard_set_with_owner (GtkClipboard *clipboard,
* gtk_clipboard_clear() has not subsequently called, returns the owner set
* by gtk_clipboard_set_with_owner().
*
* Return value: the owner of the clipboard, if any; otherwise %NULL.
* Return value: (transfer none): the owner of the clipboard, if any;
* otherwise %NULL.
**/
GObject *
gtk_clipboard_get_owner (GtkClipboard *clipboard)
@ -876,10 +879,9 @@ selection_received (GtkWidget *widget,
* @clipboard: a #GtkClipboard
* @target: an atom representing the form into which the clipboard
* owner should convert the selection.
* @callback: A function to call when the results are received
* (or the retrieval fails). If the retrieval fails
* the length field of @selection_data will be
* negative.
* @callback: (scope async): A function to call when the results are received
* (or the retrieval fails). If the retrieval fails the length field of
* @selection_data will be negative.
* @user_data: user data to pass to @callback
*
* Requests the contents of clipboard as the given target.
@ -957,9 +959,8 @@ request_text_received_func (GtkClipboard *clipboard,
/**
* gtk_clipboard_request_text:
* @clipboard: a #GtkClipboard
* @callback: a function to call when the text is received,
* or the retrieval fails. (It will always be called
* one way or the other.)
* @callback: (scope async): a function to call when the text is received,
* or the retrieval fails. (It will always be called one way or the other.)
* @user_data: user data to pass to @callback.
*
* Requests the contents of the clipboard as text. When the text is
@ -1022,9 +1023,8 @@ request_rich_text_received_func (GtkClipboard *clipboard,
* gtk_clipboard_request_rich_text:
* @clipboard: a #GtkClipboard
* @buffer: a #GtkTextBuffer
* @callback: a function to call when the text is received,
* or the retrieval fails. (It will always be called
* one way or the other.)
* @callback: (scope async): a function to call when the text is received,
* or the retrieval fails. (It will always be called one way or the other.)
* @user_data: user data to pass to @callback.
*
* Requests the contents of the clipboard as rich text. When the rich
@ -1114,9 +1114,8 @@ request_image_received_func (GtkClipboard *clipboard,
/**
* gtk_clipboard_request_image:
* @clipboard: a #GtkClipboard
* @callback: a function to call when the image is received,
* or the retrieval fails. (It will always be called
* one way or the other.)
* @callback: (scope async): a function to call when the image is received,
* or the retrieval fails. (It will always be called one way or the other.)
* @user_data: user data to pass to @callback.
*
* Requests the contents of the clipboard as image. When the image is
@ -1169,9 +1168,8 @@ request_uris_received_func (GtkClipboard *clipboard,
/**
* gtk_clipboard_request_uris:
* @clipboard: a #GtkClipboard
* @callback: a function to call when the URIs are received,
* or the retrieval fails. (It will always be called
* one way or the other.)
* @callback: (scope async): a function to call when the URIs are received,
* or the retrieval fails. (It will always be called one way or the other.)
* @user_data: user data to pass to @callback.
*
* Requests the contents of the clipboard as URIs. When the URIs are
@ -1223,8 +1221,8 @@ request_targets_received_func (GtkClipboard *clipboard,
/**
* gtk_clipboard_request_targets:
* @clipboard: a #GtkClipboard
* @callback: a function to call when the targets are received,
* or the retrieval fails. (It will always be called
* @callback: (scope async): a function to call when the targets are
* received, or the retrieval fails. (It will always be called
* one way or the other.)
* @user_data: user data to pass to @callback.
*
@ -1472,12 +1470,12 @@ clipboard_image_received_func (GtkClipboard *clipboard,
* the data to be received using the main loop, so events,
* timeouts, etc, may be dispatched during the wait.
*
* Return value: a newly-allocated #GdkPixbuf object which must
* be disposed with g_object_unref(), or %NULL if
* retrieving the selection data failed. (This
* could happen for various reasons, in particular
* if the clipboard was empty or if the contents of
* the clipboard could not be converted into an image.)
* Return value: (transfer full): a newly-allocated #GdkPixbuf
* object which must be disposed with g_object_unref(), or
* %NULL if retrieving the selection data failed. (This could
* happen for various reasons, in particular if the clipboard
* was empty or if the contents of the clipboard could not be
* converted into an image.)
*
* Since: 2.6
**/
@ -1568,7 +1566,7 @@ gtk_clipboard_wait_for_uris (GtkClipboard *clipboard)
*
* Gets the #GdkDisplay associated with @clipboard
*
* Return value: the #GdkDisplay associated with @clipboard
* Return value: (transfer none): the #GdkDisplay associated with @clipboard
*
* Since: 2.2
**/

2
gtk/gtkcolorseldialog.c
View File

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

8
gtk/gtkcombobox.c
View File

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

2
gtk/gtkcontainer.c
View File

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

39
gtk/gtkdnd.c
View File

@ -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)
{
@ -2573,22 +2572,22 @@ 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.
**/

16
gtk/gtkentry.c
View File

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

5
gtk/gtkentrycompletion.c
View File

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

3
gtk/gtkexpander.c
View File

@ -1969,7 +1969,8 @@ 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
**/

16
gtk/gtkfilechooser.c
View File

@ -1631,7 +1631,7 @@ gtk_file_chooser_set_current_folder_file (GtkFileChooser *chooser,
* 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
*/
@ -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
**/
@ -1864,7 +1864,7 @@ gtk_file_chooser_set_preview_widget (GtkFileChooser *chooser,
* 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
**/
@ -1986,8 +1986,8 @@ gtk_file_chooser_get_use_preview_label (GtkFileChooser *chooser)
* 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
**/
@ -2135,7 +2135,7 @@ gtk_file_chooser_set_extra_widget (GtkFileChooser *chooser,
* 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
**/
@ -2251,7 +2251,7 @@ gtk_file_chooser_set_filter (GtkFileChooser *chooser,
*
* 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
**/

34
gtk/gtkfontsel.c
View File

@ -1209,7 +1209,7 @@ 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
*/
@ -1247,7 +1247,7 @@ gtk_font_selection_get_face_list (GtkFontSelection *fontsel)
* 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
* Return value: (transfer none): A #GtkWidget that is part of @fontsel
*
* Since: 2.14
*/
@ -1265,7 +1265,7 @@ gtk_font_selection_get_size_entry (GtkFontSelection *fontsel)
*
* This returns the #GtkTreeeView used to list font sizes.
*
* Return value: A #GtkWidget that is part of @fontsel
* Return value: (transfer none): A #GtkWidget that is part of @fontsel
*
* Since: 2.14
*/
@ -1283,7 +1283,7 @@ gtk_font_selection_get_size_list (GtkFontSelection *fontsel)
*
* 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
*/
@ -1301,10 +1301,10 @@ gtk_font_selection_get_preview_entry (GtkFontSelection *fontsel)
*
* 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
*/
@ -1323,9 +1323,9 @@ gtk_font_selection_get_family (GtkFontSelection *fontsel)
* Gets the #PangoFontFace representing the selected font group
* 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
*/
@ -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
*/

2
gtk/gtkframe.c
View File

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

4
gtk/gtkiconfactory.c
View File

@ -1619,7 +1619,7 @@ render_fallback_image (GtkStyle *style,
* (perhaps because an image file fails to load), a default "missing
* image" icon will be returned instead.
*
* Return value: a #GdkPixbuf to be displayed
* Return value: (transfer full): a #GdkPixbuf to be displayed
*/
GdkPixbuf*
gtk_icon_set_render_icon (GtkIconSet *icon_set,
@ -2103,7 +2103,7 @@ gtk_icon_source_get_icon_name (const GtkIconSource *source)
* virtual function. The reference count on the pixbuf is
* not incremented.
*
* Return value: source pixbuf
* Return value: (transfer none): source pixbuf
*/
GdkPixbuf*
gtk_icon_source_get_pixbuf (const GtkIconSource *source)

26
gtk/gtkicontheme.c
View File

@ -1487,7 +1487,8 @@ gtk_icon_theme_error_quark (void)
* @size: the desired icon size. The resulting icon may not be
* exactly this size; see gtk_icon_info_load_icon().
* @flags: flags modifying the behavior of the icon lookup
* @error: (allow-none): Location to store error information on failure, or %NULL.
* @error: (allow-none): Location to store error information on failure,
* or %NULL.
*
* Looks up an icon in an icon theme, scales it to the given size
* and renders it into a pixbuf. This is a convenience function;
@ -1502,10 +1503,10 @@ gtk_icon_theme_error_quark (void)
* returned by this function. Otherwise GTK+ may need to keep the old
* icon theme loaded, which would be a waste of memory.
*
* Return value: the rendered icon; this may be a newly created icon
* or a new reference to an internal icon, so you must not modify
* the icon. Use g_object_unref() to release your reference to the
* icon. %NULL if the icon isn't found.
* Return value: (transfer full): the rendered icon; this may be a
* newly created icon or a new reference to an internal icon, so
* you must not modify the icon. Use g_object_unref() to release
* your reference to the icon. %NULL if the icon isn't found.
*
* Since: 2.4
**/
@ -3006,7 +3007,8 @@ icon_info_ensure_scale_and_pixbuf (GtkIconInfo *icon_info,
/**
* gtk_icon_info_load_icon:
* @icon_info: a #GtkIconInfo structure from gtk_icon_theme_lookup_icon()
* @error: (allow-none): location to store error information on failure, or %NULL.
* @error: (allow-none): location to store error information on failure,
* or %NULL.
*
* Renders an icon previously looked up in an icon theme using
* gtk_icon_theme_lookup_icon(); the size will be based on the size
@ -3020,10 +3022,10 @@ icon_info_ensure_scale_and_pixbuf (GtkIconInfo *icon_info,
* the #GtkIconInfo. If this flag has been specified, the pixbuf
* returned by this function will be scaled to the exact size.
*
* Return value: the rendered icon; this may be a newly created icon
* or a new reference to an internal icon, so you must not modify
* the icon. Use g_object_unref() to release your reference to the
* icon.
* Return value: (transfer full): the rendered icon; this may be a newly
* created icon or a new reference to an internal icon, so you must
* not modify the icon. Use g_object_unref() to release your reference
* to the icon.
*
* Since: 2.4
**/
@ -3091,7 +3093,7 @@ gdk_color_to_css (GdkColor *color)
* See the <ulink url="http://www.freedesktop.org/wiki/SymbolicIcons">Symbolic Icons spec</ulink>
* for more information about symbolic icons.
*
* Return value: a #GdkPixbuf representing the loaded icon
* Return value: (transfer full): a #GdkPixbuf representing the loaded icon
*
* Since: 3.0
**/
@ -3208,7 +3210,7 @@ gtk_icon_info_load_symbolic (GtkIconInfo *icon_info,
*
* See gtk_icon_info_load_symbolic() for more details.
*
* Return value: a #GdkPixbuf representing the loaded icon
* Return value: (transfer full): a #GdkPixbuf representing the loaded icon
*
* Since: 3.0
**/

7
gtk/gtkiconview.c
View File

@ -5252,7 +5252,7 @@ gtk_icon_view_get_visible_range (GtkIconView *icon_view,
/**
* gtk_icon_view_selected_foreach:
* @icon_view: A #GtkIconView.
* @func: The function to call for each selected icon.
* @func: (scope call): The function to call for each selected icon.
* @data: User data to pass to the function.
*
* Calls a function for each selected icon. Note that the model or
@ -5453,7 +5453,8 @@ gtk_icon_view_set_model (GtkIconView *icon_view,
* Returns the model the #GtkIconView is based on. 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.6
**/
@ -7474,7 +7475,7 @@ gtk_icon_view_get_dest_item_at_pos (GtkIconView *icon_view,
* Creates a #GdkPixmap representation of the item at @path.
* This image is used for a drag icon.
*
* Return value: a newly-allocated pixmap of the drag icon.
* Return value: (transfer full): a newly-allocated pixmap of the drag icon.
*
* Since: 2.8
**/

5
gtk/gtkimagemenuitem.c
View File

@ -971,11 +971,12 @@ gtk_image_menu_item_set_image (GtkImageMenuItem *image_menu_item,
/**
* gtk_image_menu_item_get_image:
* @image_menu_item: a #GtkImageMenuItem.
* @returns: the widget set as image of @image_menu_item.
* @image_menu_item: a #GtkImageMenuItem
*
* Gets the widget that is currently set as the image of @image_menu_item.
* See gtk_image_menu_item_set_image().
*
* Return value: (transfer none): the widget set as image of @image_menu_item
**/
GtkWidget*
gtk_image_menu_item_get_image (GtkImageMenuItem *image_menu_item)

6
gtk/gtkinfobar.c
View File

@ -739,7 +739,7 @@ gtk_info_bar_add_action_widget (GtkInfoBar *info_bar,
*
* Returns the action area of @info_bar.
*
* Returns: the action area.
* Returns: (transfer none): the action area
*
* Since: 2.18
*/
@ -757,7 +757,7 @@ gtk_info_bar_get_action_area (GtkInfoBar *info_bar)
*
* Returns the content area of @info_bar.
*
* Returns: the content area.
* Returns: (transfer none): the content area
*
* Since: 2.18
*/
@ -781,7 +781,7 @@ gtk_info_bar_get_content_area (GtkInfoBar *info_bar)
* to the end of the info bars's action area. The button widget is
* returned, but usually you don't need it.
*
* Returns: the button widget that was added
* Returns: (transfer none): the button widget that was added
*
* Since: 2.18
*/

2
gtk/gtkinvisible.c
View File

@ -216,7 +216,7 @@ gtk_invisible_set_screen (GtkInvisible *invisible,
*
* Returns the #GdkScreen object associated with @invisible
*
* Return value: the associated #GdkScreen.
* Return value: (transfer none): the associated #GdkScreen.
*
* Since: 2.2
**/

4
gtk/gtklabel.c
View File

@ -1782,8 +1782,8 @@ gtk_label_set_mnemonic_widget (GtkLabel *label,
* Retrieves the target of the mnemonic (keyboard shortcut) of this
* label. See gtk_label_set_mnemonic_widget().
*
* Return value: the target of the label's mnemonic, or %NULL if none
* has been set and the default algorithm will be used.
* Return value: (transfer none): the target of the label's mnemonic,
* or %NULL if none has been set and the default algorithm will be used.
**/
GtkWidget *
gtk_label_get_mnemonic_widget (GtkLabel *label)

6
gtk/gtklayout.c
View File

@ -173,7 +173,7 @@ gtk_layout_new (GtkAdjustment *hadjustment,
*
* Retrieve the bin window of the layout used for drawing operations.
*
* Return value: a #GdkWindow
* Return value: (transfer none): a #GdkWindow
*
* Since: 2.14
**/
@ -196,7 +196,7 @@ gtk_layout_get_bin_window (GtkLayout *layout)
*
* See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details.
*
* Return value: horizontal scroll adjustment
* Return value: (transfer none): horizontal scroll adjustment
**/
GtkAdjustment*
gtk_layout_get_hadjustment (GtkLayout *layout)
@ -216,7 +216,7 @@ gtk_layout_get_hadjustment (GtkLayout *layout)
*
* See #GtkScrolledWindow, #GtkScrollbar, #GtkAdjustment for details.
*
* Return value: vertical scroll adjustment
* Return value: (transfer none): vertical scroll adjustment
**/
GtkAdjustment*
gtk_layout_get_vadjustment (GtkLayout *layout)

13
gtk/gtkmain.c
View File

@ -2025,6 +2025,14 @@ gtk_grab_add (GtkWidget *widget)
}
}
/**
* gtk_grab_get_current:
*
* Queries the current grab of the default window group.
*
* Return value: (transfer none): The widget which currently
* has the grab or %NULL if no grab is active
*/
GtkWidget*
gtk_grab_get_current (void)
{
@ -2382,7 +2390,7 @@ gtk_get_current_event_state (GdkModifierType *state)
* If there is a current event and it has a device, return that
* device, otherwise return %NULL.
*
* Returns: a #GdkDevice, or %NULL
* Returns: (transfer none): a #GdkDevice, or %NULL
**/
GdkDevice *
gtk_get_current_event_device (void)
@ -2401,7 +2409,8 @@ gtk_get_current_event_device (void)
* returns %NULL, otherwise returns the widget that received the event
* originally.
*
* Return value: the widget that originally received @event, or %NULL
* Return value: (transfer none): the widget that originally
* received @event, or %NULL
**/
GtkWidget*
gtk_get_event_widget (GdkEvent *event)

6
gtk/gtkmenuitem.c
View File

@ -1220,10 +1220,10 @@ gtk_menu_item_set_submenu (GtkMenuItem *menu_item,
* gtk_menu_item_get_submenu:
* @menu_item: a #GtkMenuItem
*
* Gets the submenu underneath this menu item, if any. See
* gtk_menu_item_set_submenu().
* Gets the submenu underneath this menu item, if any.
* See gtk_menu_item_set_submenu().
*
* Return value: submenu for this menu item, or %NULL if none.
* Return value: (transfer none): submenu for this menu item, or %NULL if none.
**/
GtkWidget *
gtk_menu_item_get_submenu (GtkMenuItem *menu_item)

3
gtk/gtkmenutoolbutton.c
View File

@ -595,7 +595,8 @@ gtk_menu_tool_button_set_menu (GtkMenuToolButton *button,
*
* Gets the #GtkMenu associated with #GtkMenuToolButton.
*
* Return value: the #GtkMenu associated with #GtkMenuToolButton
* Return value: (transfer none): the #GtkMenu associated
* with #GtkMenuToolButton
*
* Since: 2.6
**/

17
gtk/gtkmessagedialog.c
View File

@ -740,7 +740,7 @@ gtk_message_dialog_set_image (GtkMessageDialog *dialog,
*
* Gets the dialog's image.
*
* Return value: the dialog's image
* Return value: (transfer none): the dialog's image
*
* Since: 2.14
**/
@ -894,12 +894,15 @@ gtk_message_dialog_format_secondary_markup (GtkMessageDialog *message_dialog,
* gtk_message_dialog_get_message_area:
* @message_dialog: a #GtkMessageDialog
*
* Return value: A #GtkVBox corresponding to the "message area" in the
* @message_dialog. This is the box where the dialog's primary and secondary
* labels are packed. You can add your own extra content to that box and it
* will appear below those labels, on the right side of the dialog's image (or
* on the left for right-to-left languages). See gtk_dialog_get_content_area()
* for the corresponding function in the parent #GtkDialog.
* Returns the message area of the dialog. This is the box where the
* dialog's primary and secondary labels are packed. You can add your
* own extra content to that box and it will appear below those labels,
* on the right side of the dialog's image (or on the left for right-to-left
* languages). See gtk_dialog_get_content_area() for the corresponding
* function in the parent #GtkDialog.
*
* Return value: (transfer none): A #GtkVBox corresponding to the
* "message area" in the @message_dialog.
*
* Since: 2.22
**/

4
gtk/gtkmountoperation.c
View File

@ -1451,7 +1451,7 @@ gtk_mount_operation_set_parent (GtkMountOperation *op,
*
* Gets the transient parent used by the #GtkMountOperation
*
* Returns: the transient parent for windows shown by @op
* Returns: (transfer none): the transient parent for windows shown by @op
*
* Since: 2.14
*/
@ -1504,7 +1504,7 @@ gtk_mount_operation_set_screen (GtkMountOperation *op,
* Gets the screen on which windows of the #GtkMountOperation
* will be shown.
*
* Returns: the screen on which windows of @op are shown
* Returns: (transfer none): the screen on which windows of @op are shown
*
* Since: 2.14
*/

13
gtk/gtknotebook.c
View File

@ -7350,9 +7350,9 @@ gtk_notebook_get_tab_label_text (GtkNotebook *notebook,
*
* Retrieves the menu label widget of the page containing @child.
*
* Return value: the menu label, or %NULL if the
* notebook page does not have a menu label other
* than the default (the tab label).
* Return value: (transfer none): the menu label, or %NULL if the
* notebook page does not have a menu label other than the
* default (the tab label).
**/
GtkWidget*
gtk_notebook_get_menu_label (GtkNotebook *notebook,
@ -7700,7 +7700,8 @@ gtk_notebook_set_group (GtkNotebook *notebook,
*
* Gets the current group identificator pointer for @notebook.
*
* Return Value: the group identificator, or %NULL if none is set.
* Return Value: (transfer none): the group identificator,
* or %NULL if none is set.
*
* Since: 2.12
**/
@ -7871,8 +7872,8 @@ gtk_notebook_set_tab_detachable (GtkNotebook *notebook,
*
* Gets one of the action widgets. See gtk_notebook_set_action_widget().
*
* Returns: The action widget with the given @pack_type or
* %NULL when this action widget has not been set
* Returns: (transfer none): The action widget with the given @pack_type
* or %NULL when this action widget has not been set
*
* Since: 2.20
*/

5
gtk/gtkoffscreenwindow.c
View File

@ -282,7 +282,8 @@ gtk_offscreen_window_new (void)
* a #GdkPixmap. If you need to keep this around over window
* resizes then you should add a reference to it.
*
* Returns: A #GdkPixmap pointer to the offscreen pixmap, or %NULL.
* Returns: (transfer none): A #GdkPixmap pointer to the offscreen pixmap,
* or %NULL.
*
* Since: 2.20
*/
@ -303,7 +304,7 @@ gtk_offscreen_window_get_pixmap (GtkOffscreenWindow *offscreen)
* and the application should unreference it once it is no longer
* needed.
*
* Returns: A #GdkPixbuf pointer, or %NULL.
* Returns: (transfer full): A #GdkPixbuf pointer, or %NULL.
*
* Since: 2.20
*/

2
gtk/gtkpagesetup.c
View File

@ -101,7 +101,7 @@ gtk_page_setup_new (void)
*
* Copies a #GtkPageSetup.
*
* Return value: a copy of @other
* Return value: (transfer full): a copy of @other
*
* Since: 2.10
*/

6
gtk/gtkpaned.c
View File

@ -1639,7 +1639,7 @@ gtk_paned_set_position (GtkPaned *paned,
*
* Obtains the first child of the paned widget.
*
* Return value: first child, or %NULL if it is not set.
* Return value: (transfer none): first child, or %NULL if it is not set.
*
* Since: 2.4
**/
@ -1657,7 +1657,7 @@ gtk_paned_get_child1 (GtkPaned *paned)
*
* Obtains the second child of the paned widget.
*
* Return value: second child, or %NULL if it is not set.
* Return value: (transfer none): second child, or %NULL if it is not set.
*
* Since: 2.4
**/
@ -2359,7 +2359,7 @@ gtk_paned_toggle_handle_focus (GtkPaned *paned)
* enables the callback to distinguish between the window
* of the paned, a child and the handle.
*
* Return value: the paned's handle window.
* Return value: (transfer none): the paned's handle window.
*
* Since: 2.20
**/

2
gtk/gtkplug.c
View File

@ -310,7 +310,7 @@ gtk_plug_get_embedded (GtkPlug *plug)
*
* Retrieves the socket the plug is embedded in.
*
* Return value: the window of the socket, or %NULL
* Return value: (transfer none): the window of the socket, or %NULL
*
* Since: 2.14
**/

8
gtk/gtkprintcontext.c
View File

@ -272,7 +272,7 @@ gtk_print_context_get_cairo_context (GtkPrintContext *context)
* Obtains the #GtkPageSetup that determines the page
* dimensions of the #GtkPrintContext.
*
* Return value: the page setup of @context
* Return value: (transfer none): the page setup of @context
*
* Since: 2.10
*/
@ -443,7 +443,7 @@ _gtk_print_context_set_hard_margins (GtkPrintContext *context,
* Returns a #PangoFontMap that is suitable for use
* with the #GtkPrintContext.
*
* Return value: the font map of @context
* Return value: (transfer none): the font map of @context
*
* Since: 2.10
*/
@ -462,7 +462,7 @@ gtk_print_context_get_pango_fontmap (GtkPrintContext *context)
* Creates a new #PangoContext that can be used with the
* #GtkPrintContext.
*
* Return value: a new Pango context for @context
* Return value: (transfer full): a new Pango context for @context
*
* Since: 2.10
*/
@ -496,7 +496,7 @@ gtk_print_context_create_pango_context (GtkPrintContext *context)
* Creates a new #PangoLayout that is suitable for use
* with the #GtkPrintContext.
*
* Return value: a new Pango layout for @context
* Return value: (transfer full): a new Pango layout for @context
*
* Since: 2.10
*/

4
gtk/gtkprintoperation.c
View File

@ -1412,7 +1412,7 @@ gtk_print_operation_set_default_page_setup (GtkPrintOperation *op,
* Returns the default page setup, see
* gtk_print_operation_set_default_page_setup().
*
* Returns: the default page setup
* Returns: (transfer none): the default page setup
*
* Since: 2.10
*/
@ -1472,7 +1472,7 @@ gtk_print_operation_set_print_settings (GtkPrintOperation *op,
* gtk_print_operation_set_print_settings() or
* gtk_print_operation_run() have been called.
*
* Return value: the current print settings of @op.
* Return value: (transfer none): the current print settings of @op.
*
* Since: 2.10
**/

8
gtk/gtkprintsettings.c
View File

@ -109,7 +109,7 @@ copy_hash_entry (gpointer key,
*
* Copies a #GtkPrintSettings object.
*
* Return value: a newly allocated copy of @other
* Return value: (transfer full): a newly allocated copy of @other
*
* Since: 2.10
*/
@ -472,7 +472,7 @@ gtk_print_settings_set_int (GtkPrintSettings *settings,
/**
* gtk_print_settings_foreach:
* @settings: a #GtkPrintSettings
* @func: (scope call) the function to call
* @func: (scope call): the function to call
* @user_data: user data for @func
*
* Calls @func for each key-value pair of @settings.
@ -1409,8 +1409,8 @@ gtk_print_settings_set_print_pages (GtkPrintSettings *settings,
*
* Gets the value of %GTK_PRINT_SETTINGS_PAGE_RANGES.
*
* Return value: an array of #GtkPageRange<!-- -->s. Use g_free()
* to free the array when it is no longer needed.
* Return value: (transfer full): an array of #GtkPageRange<!-- -->s.
* Use g_free() to free the array when it is no longer needed.
*
* Since: 2.10
*/

25
gtk/gtkradiobutton.c
View File

@ -408,7 +408,7 @@ gtk_radio_button_join_group (GtkRadioButton *radio_button,
* Creates a new #GtkRadioButton. To be of any practical value, a widget should
* then be packed into the radio button.
*
* Returns: a new radio button.
* Returns: a new radio button
*/
GtkWidget*
gtk_radio_button_new (GSList *group)
@ -431,7 +431,7 @@ gtk_radio_button_new (GSList *group)
*
* Creates a new #GtkRadioButton with a text label.
*
* Returns: a new radio button.
* Returns: (transfer full): a new radio button.
*/
GtkWidget*
gtk_radio_button_new_with_label (GSList *group,
@ -453,13 +453,14 @@ gtk_radio_button_new_with_label (GSList *group,
* @group: the radio button group
* @label: the text of the button, with an underscore in front of the
* mnemonic character
* @returns: a new #GtkRadioButton
*
* Creates a new #GtkRadioButton containing a label, adding it to the same
* group as @group. The label will be created using
* gtk_label_new_with_mnemonic(), so underscores in @label indicate the
* mnemonic for the button.
**/
*
* Returns: (transfer full): a new #GtkRadioButton
*/
GtkWidget*
gtk_radio_button_new_with_mnemonic (GSList *group,
const gchar *label)
@ -481,10 +482,11 @@ gtk_radio_button_new_with_mnemonic (GSList *group,
* gtk_radio_button_new_from_widget:
* @radio_group_member: an existing #GtkRadioButton.
*
* Creates a new #GtkRadioButton, adding it to the same group as @radio_group_member.
* As with gtk_radio_button_new(), a widget should be packed into the radio button.
* Creates a new #GtkRadioButton, adding it to the same group as
* @radio_group_member. As with gtk_radio_button_new(), a widget
* should be packed into the radio button.
*
* Returns: a new radio button.
* Returns: (transfer full): a new radio button.
*/
GtkWidget*
gtk_radio_button_new_from_widget (GtkRadioButton *radio_group_member)
@ -500,10 +502,10 @@ gtk_radio_button_new_from_widget (GtkRadioButton *radio_group_member)
* @radio_group_member: widget to get radio group from or %NULL
* @label: a text string to display next to the radio button.
*
* Creates a new #GtkRadioButton with a text label, adding it to the same group
* as @radio_group_member.
* Creates a new #GtkRadioButton with a text label, adding it to
* the same group as @radio_group_member.
*
* Returns: a new radio button.
* Returns: (transfer none): a new radio button.
*/
GtkWidget*
gtk_radio_button_new_with_label_from_widget (GtkRadioButton *radio_group_member,
@ -520,11 +522,12 @@ gtk_radio_button_new_with_label_from_widget (GtkRadioButton *radio_group_member,
* @radio_group_member: (allow-none): widget to get radio group from or %NULL
* @label: the text of the button, with an underscore in front of the
* mnemonic character
* @returns: a new #GtkRadioButton
*
* Creates a new #GtkRadioButton containing a label. The label
* will be created using gtk_label_new_with_mnemonic(), so underscores
* in @label indicate the mnemonic for the button.
*
* Returns: (transfer full): a new #GtkRadioButton
**/
GtkWidget*
gtk_radio_button_new_with_mnemonic_from_widget (GtkRadioButton *radio_group_member,

15
gtk/gtkradiomenuitem.c
View File

@ -251,7 +251,7 @@ gtk_radio_menu_item_new_with_mnemonic (GSList *group,
*
* Creates a new #GtkRadioMenuItem adding it to the same group as @group.
*
* Return value: The new #GtkRadioMenuItem
* Return value: (transfer full): The new #GtkRadioMenuItem
*
* Since: 2.4
**/
@ -280,7 +280,7 @@ gtk_radio_menu_item_new_from_widget (GtkRadioMenuItem *group)
*
* The new #GtkRadioMenuItem is added to the same group as @group.
*
* Return value: The new #GtkRadioMenuItem
* Return value: (transfer full): The new #GtkRadioMenuItem
*
* Since: 2.4
**/
@ -306,7 +306,7 @@ gtk_radio_menu_item_new_with_mnemonic_from_widget (GtkRadioMenuItem *group,
* Creates a new GtkRadioMenuItem whose child is a simple GtkLabel.
* The new #GtkRadioMenuItem is added to the same group as @group.
*
* Return value: The new #GtkRadioMenuItem
* Return value: (transfer full): The new #GtkRadioMenuItem
*
* Since: 2.4
**/
@ -324,6 +324,15 @@ gtk_radio_menu_item_new_with_label_from_widget (GtkRadioMenuItem *group,
return gtk_radio_menu_item_new_with_label (list, label);
}
/**
* gtk_radio_menu_item_get_group:
* @radio_menu_item: a #GtkRadioMenuItem
*
* 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.
*
* Returns: (transfer none): the group of @radio_menu_item
*/
GSList*
gtk_radio_menu_item_get_group (GtkRadioMenuItem *radio_menu_item)
{

8
gtk/gtkradiotoolbutton.c
View File

@ -167,7 +167,7 @@ gtk_radio_tool_button_new_from_stock (GSList *group,
*
* Creates a new #GtkRadioToolButton adding it to the same group as @gruup
*
* Return value: The new #GtkRadioToolButton
* Return value: (transfer full): The new #GtkRadioToolButton
*
* Since: 2.4
**/
@ -193,7 +193,7 @@ gtk_radio_tool_button_new_from_widget (GtkRadioToolButton *group)
* The new #GtkRadioToolButton will contain an icon and label from the
* stock item indicated by @stock_id.
*
* Return value: A new #GtkRadioToolButton
* Return value: (transfer full): A new #GtkRadioToolButton
*
* Since: 2.4
**/
@ -223,10 +223,10 @@ get_radio_button (GtkRadioToolButton *button)
*
* Returns the radio button group @button belongs to.
*
* Return value: The group @button belongs to.
* Return value: (transfer none): The group @button belongs to.
*
* Since: 2.4
**/
*/
GSList *
gtk_radio_tool_button_get_group (GtkRadioToolButton *button)
{

2
gtk/gtkrange.c
View File

@ -737,7 +737,7 @@ gtk_range_init (GtkRange *range)
* The return value does not have a reference added, so should not
* be unreferenced.
*
* Return value: a #GtkAdjustment
* Return value: (transfer none): a #GtkAdjustment
**/
GtkAdjustment*
gtk_range_get_adjustment (GtkRange *range)

24
gtk/gtkrc.c
View File

@ -605,8 +605,8 @@ gtk_rc_set_default_files (gchar **filenames)
* Retrieves the current list of RC files that will be parsed
* at the end of gtk_init().
*
* Return value: A %NULL-terminated array of filenames. This memory
* is owned by GTK+ and must not be freed by the application.
* Return value: (transfer none): A %NULL-terminated array of filenames.
* This memory is owned by GTK+ and must not be freed by the application.
* If you want to store this information, you should make a copy.
**/
gchar **
@ -1265,7 +1265,7 @@ gtk_rc_style_new (void)
* will correctly copy an RC style that is a member of a class
* derived from #GtkRcStyle.
*
* Return value: the resulting #GtkRcStyle
* Return value: (transfer full): the resulting #GtkRcStyle
**/
GtkRcStyle *
gtk_rc_style_copy (GtkRcStyle *orig)
@ -2061,10 +2061,10 @@ gtk_rc_get_style (GtkWidget *widget)
/**
* gtk_rc_get_style_by_paths:
* @settings: a #GtkSettings object
* @widget_path: (allow-none): the widget path to use when looking up the style, or %NULL
* if no matching against the widget path should be done
* @class_path: (allow-none): the class path to use when looking up the style, or %NULL
* if no matching against the class path should be done.
* @widget_path: (allow-none): the widget path to use when looking up the
* style, or %NULL if no matching against the widget path should be done
* @class_path: (allow-none): the class path to use when looking up the style,
* or %NULL if no matching against the class path should be done.
* @type: a type that will be used along with parent types of this type
* when matching against class styles, or #G_TYPE_NONE
*
@ -2083,11 +2083,11 @@ gtk_rc_get_style (GtkWidget *widget)
* G_OBJECT_TYPE (widget));
* ]|
*
* Return value: A style created by matching with the supplied paths,
* or %NULL if nothing matching was specified and the default style should
* be used. The returned value is owned by GTK+ as part of an internal cache,
* so you must call g_object_ref() on the returned value if you want to
* keep a reference to it.
* Return value: (transfer none): A style created by matching with the
* supplied paths, or %NULL if nothing matching was specified and the
* default style should be used. The returned value is owned by GTK+
* as part of an internal cache, so you must call g_object_ref() on
* the returned value if you want to keep a reference to it.
**/
GtkStyle *
gtk_rc_get_style_by_paths (GtkSettings *settings,

6
gtk/gtkrecentchooser.c
View File

@ -859,8 +859,8 @@ gtk_recent_chooser_get_items (GtkRecentChooser *chooser)
*
* Since the returned array is %NULL terminated, @length may be %NULL.
*
* Return value: A newly allocated, %NULL terminated array of strings. Use
* g_strfreev() to free it.
* Return value: (transfer full): A newly allocated, %NULL-terminated array
* of strings. Use g_strfreev() to free it.
*
* Since: 2.10
*/
@ -990,7 +990,7 @@ gtk_recent_chooser_set_filter (GtkRecentChooser *chooser,
* Gets the #GtkRecentFilter object currently used by @chooser to affect
* the display of the recently used resources.
*
* Return value: a #GtkRecentFilter object.
* Return value: (transfer none): a #GtkRecentFilter object.
*
* Since: 2.10
*/

4
gtk/gtkrecentchooser.h
View File

@ -124,8 +124,8 @@ struct _GtkRecentChooserIface
GSList * (* list_filters) (GtkRecentChooser *chooser);
void (* set_sort_func) (GtkRecentChooser *chooser,
GtkRecentSortFunc sort_func,
gpointer data,
GDestroyNotify destroy);
gpointer sort_data,
GDestroyNotify data_destroy);
/*
* Signals

14
gtk/gtkrecentmanager.c
View File

@ -1730,8 +1730,9 @@ gtk_recent_info_get_application_info (GtkRecentInfo *info,
*
* Retrieves the list of applications that have registered this resource.
*
* Return value: (array length=length zero-terminated=1): a newly allocated
* %NULL-terminated array of strings. Use g_strfreev() to free it.
* Return value: (array length=length zero-terminated=1) (transfer full):
* a newly allocated %NULL-terminated array of strings.
* Use g_strfreev() to free it.
*
* Since: 2.10
*/
@ -1890,8 +1891,8 @@ get_icon_fallback (const gchar *icon_name,
*
* Retrieves the icon of size @size associated to the resource MIME type.
*
* Return value: a #GdkPixbuf containing the icon, or %NULL. Use
* g_object_unref() when finished using the icon.
* Return value: (transfer full): a #GdkPixbuf containing the icon,
* or %NULL. Use g_object_unref() when finished using the icon.
*
* Since: 2.10
*/
@ -2227,8 +2228,9 @@ gtk_recent_info_get_age (GtkRecentInfo *info)
* array of returned group names will be %NULL terminated, so length might
* optionally be %NULL.
*
* Return value: (array length=length zero-terminated=1): a newly allocated
* %NULL terminated array of strings. Use g_strfreev() to free it.
* Return value: (array length=length zero-terminated=1) (transfer full):
* a newly allocated %NULL terminated array of strings.
* Use g_strfreev() to free it.
*
* Since: 2.10
*/

10
gtk/gtkscale.c
View File

@ -1329,12 +1329,12 @@ gtk_scale_finalize (GObject *object)
* gtk_scale_get_layout:
* @scale: A #GtkScale
*
* Gets the #PangoLayout used to display the scale.
* The returned object is owned by the scale so does
* not need to be freed by the caller.
* Gets the #PangoLayout used to display the scale. The returned
* object is owned by the scale so does not need to be freed by
* the caller.
*
* Return value: the #PangoLayout for this scale, or %NULL
* if the #GtkScale:draw-value property is %FALSE.
* Return value: (transfer none): the #PangoLayout for this scale,
* or %NULL if the #GtkScale:draw-value property is %FALSE.
*
* Since: 2.4
*/

8
gtk/gtkscalebutton.c
View File

@ -676,7 +676,7 @@ gtk_scale_button_set_icons (GtkScaleButton *button,
* Gets the #GtkAdjustment associated with the #GtkScaleButton's scale.
* See gtk_range_get_adjustment() for details.
*
* Returns: the adjustment associated with the scale
* Returns: (transfer none): the adjustment associated with the scale
*
* Since: 2.12
*/
@ -728,7 +728,7 @@ gtk_scale_button_set_adjustment (GtkScaleButton *button,
*
* Retrieves the plus button of the #GtkScaleButton.
*
* Returns: the plus button of the #GtkScaleButton.
* Returns: (transfer none): the plus button of the #GtkScaleButton
*
* Since: 2.14
*/
@ -746,7 +746,7 @@ gtk_scale_button_get_plus_button (GtkScaleButton *button)
*
* Retrieves the minus button of the #GtkScaleButton.
*
* Returns: the minus button of the #GtkScaleButton.
* Returns: (transfer none): the minus button of the #GtkScaleButton
*
* Since: 2.14
*/
@ -764,7 +764,7 @@ gtk_scale_button_get_minus_button (GtkScaleButton *button)
*
* Retrieves the popup of the #GtkScaleButton.
*
* Returns: the popup of the #GtkScaleButton
* Returns: (transfer none): the popup of the #GtkScaleButton
*
* Since: 2.14
*/

15
gtk/gtkscrolledwindow.c
View File

@ -581,7 +581,7 @@ gtk_scrolled_window_set_vadjustment (GtkScrolledWindow *scrolled_window,
* horizontal scrollbar to the child widget's horizontal scroll
* functionality.
*
* Returns: the horizontal #GtkAdjustment
* Returns: (transfer none): the horizontal #GtkAdjustment
*/
GtkAdjustment*
gtk_scrolled_window_get_hadjustment (GtkScrolledWindow *scrolled_window)
@ -602,10 +602,9 @@ gtk_scrolled_window_get_hadjustment (GtkScrolledWindow *scrolled_window)
* @scrolled_window: a #GtkScrolledWindow
*
* Returns the vertical scrollbar's adjustment, used to connect the
* vertical scrollbar to the child widget's vertical scroll
* functionality.
* vertical scrollbar to the child widget's vertical scroll functionality.
*
* Returns: the vertical #GtkAdjustment
* Returns: (transfer none): the vertical #GtkAdjustment
*/
GtkAdjustment*
gtk_scrolled_window_get_vadjustment (GtkScrolledWindow *scrolled_window)
@ -627,8 +626,8 @@ gtk_scrolled_window_get_vadjustment (GtkScrolledWindow *scrolled_window)
*
* Returns the horizontal scrollbar of @scrolled_window.
*
* Returns: the horizontal scrollbar of the scrolled window, or
* %NULL if it does not have one.
* Returns: (transfer none): the horizontal scrollbar of the scrolled window,
* or %NULL if it does not have one.
*
* Since: 2.8
*/
@ -646,8 +645,8 @@ gtk_scrolled_window_get_hscrollbar (GtkScrolledWindow *scrolled_window)
*
* Returns the vertical scrollbar of @scrolled_window.
*
* Returns: the vertical scrollbar of the scrolled window, or
* %NULL if it does not have one.
* Returns: (transfer none): the vertical scrollbar of the scrolled window,
* or %NULL if it does not have one.
*
* Since: 2.8
*/

4
gtk/gtkselection.c
View File

@ -1224,7 +1224,7 @@ gtk_selection_data_get_length (GtkSelectionData *selection_data)
*
* Retrieves the display of the selection.
*
* Returns: the display of the selection.
* Returns: (transfer none): the display of the selection.
*
* Since: 2.14
**/
@ -1657,7 +1657,7 @@ gtk_selection_data_set_pixbuf (GtkSelectionData *selection_data,
*
* Gets the contents of the selection data as a #GdkPixbuf.
*
* Return value: if the selection data contained a recognized
* Return value: (transfer full): if the selection data contained a recognized
* image type and it could be converted to a #GdkPixbuf, a
* newly allocated pixbuf is returned, otherwise %NULL.
* If the result is non-%NULL it must be freed with g_object_unref().

2
gtk/gtksettings.c
View File

@ -1070,7 +1070,7 @@ gtk_settings_finalize (GObject *object)
*
* Gets the #GtkSettings object for @screen, creating it if necessary.
*
* Return value: a #GtkSettings object.
* Return value: (transfer none): a #GtkSettings object.
*
* Since: 2.2
*/

2
gtk/gtksocket.c
View File

@ -349,7 +349,7 @@ gtk_socket_get_id (GtkSocket *socket)
* Retrieves the window of the plug. Use this to check if the plug has
* been created inside of the socket.
*
* Return value: the window of the plug if available, or %NULL
* Return value: (transfer none): the window of the plug if available, or %NULL
*
* Since: 2.14
**/

2
gtk/gtkspinbutton.c
View File

@ -1886,7 +1886,7 @@ gtk_spin_button_set_adjustment (GtkSpinButton *spin_button,
*
* Get the adjustment associated with a #GtkSpinButton
*
* Return value: the #GtkAdjustment of @spin_button
* Return value: (transfer none): the #GtkAdjustment of @spin_button
**/
GtkAdjustment *
gtk_spin_button_get_adjustment (GtkSpinButton *spin_button)

2
gtk/gtkstatusbar.c
View File

@ -674,7 +674,7 @@ gtk_statusbar_get_has_resize_grip (GtkStatusbar *statusbar)
*
* Retrieves the box containing the label widget.
*
* Returns: a #GtkBox
* Returns: (transfer none): a #GtkBox
*
* Since: 2.20
*/

7
gtk/gtkstatusicon.c
View File

@ -2024,7 +2024,8 @@ gtk_status_icon_get_storage_type (GtkStatusIcon *status_icon)
* The caller of this function does not own a reference to the
* returned pixbuf.
*
* Return value: the displayed pixbuf, or %NULL if the image is empty.
* Return value: (transfer none): the displayed pixbuf,
* or %NULL if the image is empty.
*
* Since: 2.10
**/
@ -2123,7 +2124,7 @@ gtk_status_icon_get_icon_name (GtkStatusIcon *status_icon)
*
* If this function fails, @icon is left unchanged;
*
* Returns: the displayed icon, or %NULL if the image is empty
* Returns: (transfer none): the displayed icon, or %NULL if the image is empty
*
* Since: 2.14
**/
@ -2198,7 +2199,7 @@ gtk_status_icon_set_screen (GtkStatusIcon *status_icon,
*
* Returns the #GdkScreen associated with @status_icon.
*
* Return value: a #GdkScreen.
* Return value: (transfer none): a #GdkScreen.
*
* Since: 2.12
*/

6
gtk/gtkstyle.c
View File

@ -621,7 +621,7 @@ gtk_style_finalize (GObject *object)
*
* Creates a copy of the passed in #GtkStyle object.
*
* Returns: a copy of @style
* Returns: (transfer full): a copy of @style
*/
GtkStyle*
gtk_style_copy (GtkStyle *style)
@ -1370,11 +1370,13 @@ gtk_style_real_set_background (GtkStyle *style,
* don't scale.
* @widget: (allow-none): the widget
* @detail: (allow-none): a style detail
* @returns: a newly-created #GdkPixbuf containing the rendered icon
*
* Renders the icon specified by @source at the given @size
* according to the given parameters and returns the result in a
* pixbuf.
*
* Return value: (transfer full): a newly-created #GdkPixbuf
* containing the rendered icon
*/
GdkPixbuf *
gtk_style_render_icon (GtkStyle *style,

15
gtk/gtktextbuffer.c
View File

@ -1986,7 +1986,7 @@ gtk_text_buffer_insert_child_anchor (GtkTextBuffer *buffer,
* owned by the buffer; no reference count is returned to
* the caller of gtk_text_buffer_create_child_anchor().
*
* Return value: the created child anchor
* Return value: (transfer none): the created child anchor
**/
GtkTextChildAnchor*
gtk_text_buffer_create_child_anchor (GtkTextBuffer *buffer,
@ -2457,7 +2457,6 @@ gtk_text_buffer_select_range (GtkTextBuffer *buffer,
* @first_property_name: (allow-none): name of first property to set, or %NULL
* @Varargs: %NULL-terminated list of property names and values
*
*
* Creates a tag and adds it to the tag table for @buffer.
* Equivalent to calling gtk_text_tag_new() and then adding the
* tag to the buffer's tag table. The returned tag is owned by
@ -2471,8 +2470,8 @@ gtk_text_buffer_select_range (GtkTextBuffer *buffer,
* The @first_property_name argument and subsequent arguments are a list
* of properties to set on the tag, as with g_object_set().
*
* Return value: a new tag
**/
* Return value: (transfer none): a new tag
*/
GtkTextTag*
gtk_text_buffer_create_tag (GtkTextBuffer *buffer,
const gchar *tag_name,
@ -3763,10 +3762,10 @@ remove_all_selection_clipboards (GtkTextBuffer *buffer)
* at the cursor
* @default_editable: whether the buffer is editable by default
*
* Pastes the contents of a clipboard at the insertion point, or at
* @override_location. (Note: pasting is asynchronous, that is, we'll
* ask for the paste data and return, and at some point later after
* the main loop runs, the paste data will be inserted.)
* Pastes the contents of a clipboard at the insertion point, or
* at @override_location. (Note: pasting is asynchronous, that is,
* we'll ask for the paste data and return, and at some point later
* after the main loop runs, the paste data will be inserted.)
**/
void
gtk_text_buffer_paste_clipboard (GtkTextBuffer *buffer,

10
gtk/gtktextiter.c
View File

@ -1005,7 +1005,7 @@ gtk_text_iter_get_pixbuf (const GtkTextIter *iter)
* anchor is returned (with no new reference count added). Otherwise,
* %NULL is returned.
*
* Return value: the anchor at @iter
* Return value: (transfer none): the anchor at @iter
**/
GtkTextChildAnchor*
gtk_text_iter_get_child_anchor (const GtkTextIter *iter)
@ -3242,7 +3242,7 @@ gtk_text_iter_forward_word_ends (GtkTextIter *iter,
}
/**
* gtk_text_iter_backward_word_starts
* gtk_text_iter_backward_word_starts:
* @iter: a #GtkTextIter
* @count: number of times to move
*
@ -3320,7 +3320,7 @@ gtk_text_iter_forward_visible_word_ends (GtkTextIter *iter,
}
/**
* gtk_text_iter_backward_visible_word_starts
* gtk_text_iter_backward_visible_word_starts:
* @iter: a #GtkTextIter
* @count: number of times to move
*
@ -4309,7 +4309,7 @@ matches_pred (GtkTextIter *iter,
/**
* gtk_text_iter_forward_find_char:
* @iter: a #GtkTextIter
* @pred: a function to be called on each character
* @pred: (scope call): a function to be called on each character
* @user_data: user data for @pred
* @limit: (allow-none): search limit, or %NULL for none
*
@ -4347,7 +4347,7 @@ gtk_text_iter_forward_find_char (GtkTextIter *iter,
/**
* gtk_text_iter_backward_find_char:
* @iter: a #GtkTextIter
* @pred: function to be called on each character
* @pred: (scope call): function to be called on each character
* @user_data: user data for @pred
* @limit: (allow-none): search limit, or %NULL for none
*

2
gtk/gtktexttagtable.c
View File

@ -402,7 +402,7 @@ list_foreach (gpointer data, gpointer user_data)
/**
* gtk_text_tag_table_foreach:
* @table: a #GtkTextTagTable
* @func: a function to call on each tag
* @func: (scope call): a function to call on each tag
* @data: user data
*
* Calls @func on each tag in @table, with user data @data.

4
gtk/gtktoolbar.c
View File

@ -2927,8 +2927,8 @@ gtk_toolbar_get_n_items (GtkToolbar *toolbar)
* Returns the @n<!-- -->'th item on @toolbar, or %NULL if the
* toolbar does not contain an @n<!-- -->'th item.
*
* Return value: The @n<!-- -->'th #GtkToolItem on @toolbar, or %NULL if there
* isn't an @n<!-- -->'th item.
* Return value: (transfer none): The @n<!-- -->'th #GtkToolItem on @toolbar,
* or %NULL if there isn't an @n<!-- -->'th item.
*
* Since: 2.4
**/

14
gtk/gtktoolbutton.c
View File

@ -1270,10 +1270,11 @@ gtk_tool_button_set_label_widget (GtkToolButton *button,
* gtk_tool_button_get_label_widget:
* @button: a #GtkToolButton
*
* Returns the widget used as label on @button. See
* gtk_tool_button_set_label_widget().
* Returns the widget used as label on @button.
* See gtk_tool_button_set_label_widget().
*
* Return value: The widget used as label on @button, or %NULL.
* Return value: (transfer none): The widget used as label
* on @button, or %NULL.
*
* Since: 2.4
**/
@ -1289,10 +1290,11 @@ gtk_tool_button_get_label_widget (GtkToolButton *button)
* gtk_tool_button_get_icon_widget:
* @button: a #GtkToolButton
*
* Return the widget used as icon widget on @button. See
* gtk_tool_button_set_icon_widget().
* Return the widget used as icon widget on @button.
* See gtk_tool_button_set_icon_widget().
*
* Return value: The widget used as icon on @button, or %NULL.
* Return value: (transfer none): The widget used as icon
* on @button, or %NULL.
*
* Since: 2.4
**/

20
gtk/gtktoolitem.c
View File

@ -893,10 +893,11 @@ gtk_tool_item_get_text_orientation (GtkToolItem *tool_item)
* gtk_tool_item_get_text_size_group:
* @tool_item: a #GtkToolItem
*
* Returns the size group used for labels in @tool_item. Custom subclasses of
* #GtkToolItem should call this function and use the size group for labels.
* Returns the size group used for labels in @tool_item.
* Custom subclasses of #GtkToolItem should call this function
* and use the size group for labels.
*
* Return value: a #GtkSizeGroup
* Return value: (transfer none): a #GtkSizeGroup
*
* Since: 2.20
*/
@ -1294,13 +1295,14 @@ gtk_tool_item_retrieve_proxy_menu_item (GtkToolItem *tool_item)
* If @menu_item_id matches the string passed to
* gtk_tool_item_set_proxy_menu_item() return the corresponding #GtkMenuItem.
*
* Custom subclasses of #GtkToolItem should use this function to update
* their menu item when the #GtkToolItem changes. That the
* @menu_item_id<!-- -->s must match ensures that a #GtkToolItem will not
* inadvertently change a menu item that they did not create.
* Custom subclasses of #GtkToolItem should use this function to
* update their menu item when the #GtkToolItem changes. That the
* @menu_item_id<!-- -->s must match ensures that a #GtkToolItem
* will not inadvertently change a menu item that they did not create.
*
* Return value: The #GtkMenuItem passed to
* gtk_tool_item_set_proxy_menu_item(), if the @menu_item_id<!-- -->s match.
* Return value: (transfer none): The #GtkMenuItem passed to
* gtk_tool_item_set_proxy_menu_item(), if the @menu_item_id<!-- -->s
* match.
*
* Since: 2.4
**/

6
gtk/gtktoolitemgroup.c
View File

@ -1994,7 +1994,7 @@ gtk_tool_item_group_get_label (GtkToolItemGroup *group)
* Gets the label widget of @group.
* See gtk_tool_item_group_set_label_widget().
*
* Returns: the label widget of @group
* Returns: (transfer none): the label widget of @group
*
* Since: 2.20
*/
@ -2199,7 +2199,7 @@ gtk_tool_item_group_get_n_items (GtkToolItemGroup *group)
*
* Gets the tool item at @index in group.
*
* Returns: the #GtkToolItem at index
* Returns: (transfer none): the #GtkToolItem at index
*
* Since: 2.20
*/
@ -2224,7 +2224,7 @@ gtk_tool_item_group_get_nth_item (GtkToolItemGroup *group,
*
* Gets the tool item at position (x, y).
*
* Returns: the #GtkToolItem at position (x, y)
* Returns: (transfer none): the #GtkToolItem at position (x, y)
*
* Since: 2.20
*/

4
gtk/gtktreemodel.c
View File

@ -1611,7 +1611,7 @@ gtk_tree_model_foreach_helper (GtkTreeModel *model,
/**
* gtk_tree_model_foreach:
* @model: A #GtkTreeModel
* @func: A function to be called on each row
* @func: (scope call): A function to be called on each row
* @user_data: User data to passed to func.
*
* Calls func on each node in model in a depth-first fashion.
@ -2020,7 +2020,7 @@ gtk_tree_row_reference_get_path (GtkTreeRowReference *reference)
*
* Returns the model that the row reference is monitoring.
*
* Return value: the model
* Return value: (transfer none): the model
*
* Since: 2.8
*/

4
gtk/gtktreemodelfilter.c
View File

@ -2994,7 +2994,7 @@ gtk_tree_model_filter_set_root (GtkTreeModelFilter *filter,
* Creates a new #GtkTreeModel, with @child_model as the child_model
* and @root as the virtual root.
*
* Return value: A new #GtkTreeModel.
* Return value: (transfer full): A new #GtkTreeModel.
*
* Since: 2.4
*/
@ -3028,7 +3028,7 @@ gtk_tree_model_filter_new (GtkTreeModel *child_model,
*
* Returns a pointer to the child model of @filter.
*
* Return value: A pointer to a #GtkTreeModel.
* Return value: (transfer none): A pointer to a #GtkTreeModel.
*
* Since: 2.4
*/

4
gtk/gtktreemodelsort.c
View File

@ -324,7 +324,7 @@ gtk_tree_model_sort_drag_source_init (GtkTreeDragSourceIface *iface)
*
* Creates a new #GtkTreeModel, with @child_model as the child model.
*
* Return value: A new #GtkTreeModel.
* Return value: (transfer full): A new #GtkTreeModel.
*/
GtkTreeModel *
gtk_tree_model_sort_new_with_model (GtkTreeModel *child_model)
@ -1989,7 +1989,7 @@ gtk_tree_model_sort_set_model (GtkTreeModelSort *tree_model_sort,
*
* Returns the model the #GtkTreeModelSort is sorting.
*
* Return value: the "child model" being sorted
* Return value: (transfer none): the "child model" being sorted
**/
GtkTreeModel *
gtk_tree_model_sort_get_model (GtkTreeModelSort *tree_model)

8
gtk/gtktreesortable.h
View File

@ -67,12 +67,12 @@ struct _GtkTreeSortableIface
GtkSortType order);
void (* set_sort_func) (GtkTreeSortable *sortable,
gint sort_column_id,
GtkTreeIterCompareFunc func,
gpointer data,
GtkTreeIterCompareFunc sort_func,
gpointer user_data,
GDestroyNotify destroy);
void (* set_default_sort_func) (GtkTreeSortable *sortable,
GtkTreeIterCompareFunc func,
gpointer data,
GtkTreeIterCompareFunc sort_func,
gpointer user_data,
GDestroyNotify destroy);
gboolean (* has_default_sort_func) (GtkTreeSortable *sortable);
};

33
gtk/gtktreeview.c
View File

@ -10967,8 +10967,8 @@ gtk_tree_view_get_selection (GtkTreeView *tree_view)
*
* Gets the #GtkAdjustment currently being used for the horizontal aspect.
*
* Return value: A #GtkAdjustment object, or %NULL if none is currently being
* used.
* Return value: (transfer none): A #GtkAdjustment object, or %NULL
* if none is currently being used.
**/
GtkAdjustment *
gtk_tree_view_get_hadjustment (GtkTreeView *tree_view)
@ -11007,8 +11007,8 @@ gtk_tree_view_set_hadjustment (GtkTreeView *tree_view,
*
* Gets the #GtkAdjustment currently being used for the vertical aspect.
*
* Return value: A #GtkAdjustment object, or %NULL if none is currently being
* used.
* Return value: (transfer none): A #GtkAdjustment object, or %NULL
* if none is currently being used.
**/
GtkAdjustment *
gtk_tree_view_get_vadjustment (GtkTreeView *tree_view)
@ -11516,8 +11516,8 @@ gtk_tree_view_insert_column_with_data_func (GtkTreeView *tree_vie
*
* Gets the #GtkTreeViewColumn at the given position in the #tree_view.
*
* Return value: The #GtkTreeViewColumn, or %NULL if the position is outside the
* range of columns.
* Return value: (transfer none): The #GtkTreeViewColumn, or %NULL if the
* position is outside the range of columns.
**/
GtkTreeViewColumn *
gtk_tree_view_get_column (GtkTreeView *tree_view,
@ -11649,10 +11649,10 @@ gtk_tree_view_set_expander_column (GtkTreeView *tree_view,
* gtk_tree_view_get_expander_column:
* @tree_view: A #GtkTreeView
*
* Returns the column that is the current expander column. This
* column has the expander arrow drawn next to it.
* Returns the column that is the current expander column.
* This column has the expander arrow drawn next to it.
*
* Return value: The expander column.
* Return value: (transfer none): The expander column.
**/
GtkTreeViewColumn *
gtk_tree_view_get_expander_column (GtkTreeView *tree_view)
@ -12490,7 +12490,7 @@ gtk_tree_view_map_expanded_rows_helper (GtkTreeView *tree_view,
/**
* gtk_tree_view_map_expanded_rows:
* @tree_view: A #GtkTreeView
* @func: A function to be called
* @func: (scope call): A function to be called
* @data: User data to be passed to the function.
*
* Calls @func on all expanded rows.
@ -12832,11 +12832,12 @@ gtk_tree_view_set_cursor_on_cell (GtkTreeView *tree_view,
* gtk_tree_view_get_bin_window:
* @tree_view: A #GtkTreeView
*
* Returns the window that @tree_view renders to. This is used primarily to
* compare to <literal>event->window</literal> to confirm that the event on
* @tree_view is on the right window.
* Returns the window that @tree_view renders to.
* This is used primarily to compare to <literal>event->window</literal>
* to confirm that the event on @tree_view is on the right window.
*
* Return value: A #GdkWindow, or %NULL when @tree_view hasn't been realized yet
* Return value: (transfer none): A #GdkWindow, or %NULL when @tree_view
* hasn't been realized yet
**/
GdkWindow *
gtk_tree_view_get_bin_window (GtkTreeView *tree_view)
@ -13763,7 +13764,7 @@ gtk_tree_view_get_dest_row_at_pos (GtkTreeView *tree_view,
* Creates a #GdkPixmap representation of the row at @path.
* This image is used for a drag icon.
*
* Return value: a newly-allocated pixmap of the drag icon.
* Return value: (transfer none): a newly-allocated pixmap of the drag icon.
**/
GdkPixmap *
gtk_tree_view_create_row_drag_icon (GtkTreeView *tree_view,
@ -14092,7 +14093,7 @@ gtk_tree_view_set_search_equal_func (GtkTreeView *tree_view,
* entry for @tree_view. In case the built-in entry is being used, %NULL
* will be returned.
*
* Return value: the entry currently in use as search entry.
* Return value: (transfer none): the entry currently in use as search entry.
*
* Since: 2.10
*/

15
gtk/gtktreeviewcolumn.c
View File

@ -2269,10 +2269,11 @@ gtk_tree_view_column_set_widget (GtkTreeViewColumn *tree_column,
* gtk_tree_view_column_get_widget:
* @tree_column: A #GtkTreeViewColumn.
*
* Returns the #GtkWidget in the button on the column header. If a custom
* widget has not been set then %NULL is returned.
* Returns the #GtkWidget in the button on the column header.
* If a custom widget has not been set then %NULL is returned.
*
* Return value: The #GtkWidget in the column header, or %NULL
* Return value: (transfer none): The #GtkWidget in the column
* header, or %NULL
**/
GtkWidget *
gtk_tree_view_column_get_widget (GtkTreeViewColumn *tree_column)
@ -3770,12 +3771,12 @@ gtk_tree_view_column_queue_resize (GtkTreeViewColumn *tree_column)
* gtk_tree_view_column_get_tree_view:
* @tree_column: A #GtkTreeViewColumn
*
* Returns the #GtkTreeView wherein @tree_column has been inserted. If
* @column is currently not inserted in any tree view, %NULL is
* Returns the #GtkTreeView wherein @tree_column has been inserted.
* If @column is currently not inserted in any tree view, %NULL is
* returned.
*
* Return value: The tree view wherein @column has been inserted if any,
* %NULL otherwise.
* Return value: (transfer none): The tree view wherein @column has
* been inserted if any, %NULL otherwise.
*
* Since: 2.12
*/

402
gtk/gtkuimanager.c
View File

File diff suppressed because it is too large Load Diff

44
gtk/gtkuimanager.h
View File

@ -65,18 +65,18 @@ struct _GtkUIManagerClass {
GObjectClass parent_class;
/* Signals */
void (* add_widget) (GtkUIManager *merge,
void (* add_widget) (GtkUIManager *manager,
GtkWidget *widget);
void (* actions_changed) (GtkUIManager *merge);
void (* connect_proxy) (GtkUIManager *merge,
void (* actions_changed) (GtkUIManager *manager);
void (* connect_proxy) (GtkUIManager *manager,
GtkAction *action,
GtkWidget *proxy);
void (* disconnect_proxy) (GtkUIManager *merge,
void (* disconnect_proxy) (GtkUIManager *manager,
GtkAction *action,
GtkWidget *proxy);
void (* pre_activate) (GtkUIManager *merge,
void (* pre_activate) (GtkUIManager *manager,
GtkAction *action);
void (* post_activate) (GtkUIManager *merge,
void (* post_activate) (GtkUIManager *manager,
GtkAction *action);
/* Virtual functions */
@ -106,41 +106,41 @@ typedef enum {
GType gtk_ui_manager_get_type (void) G_GNUC_CONST;
GtkUIManager *gtk_ui_manager_new (void);
void gtk_ui_manager_set_add_tearoffs (GtkUIManager *self,
void gtk_ui_manager_set_add_tearoffs (GtkUIManager *manager,
gboolean add_tearoffs);
gboolean gtk_ui_manager_get_add_tearoffs (GtkUIManager *self);
void gtk_ui_manager_insert_action_group (GtkUIManager *self,
gboolean gtk_ui_manager_get_add_tearoffs (GtkUIManager *manager);
void gtk_ui_manager_insert_action_group (GtkUIManager *manager,
GtkActionGroup *action_group,
gint pos);
void gtk_ui_manager_remove_action_group (GtkUIManager *self,
void gtk_ui_manager_remove_action_group (GtkUIManager *manager,
GtkActionGroup *action_group);
GList *gtk_ui_manager_get_action_groups (GtkUIManager *self);
GtkAccelGroup *gtk_ui_manager_get_accel_group (GtkUIManager *self);
GtkWidget *gtk_ui_manager_get_widget (GtkUIManager *self,
GList *gtk_ui_manager_get_action_groups (GtkUIManager *manager);
GtkAccelGroup *gtk_ui_manager_get_accel_group (GtkUIManager *manager);
GtkWidget *gtk_ui_manager_get_widget (GtkUIManager *manager,
const gchar *path);
GSList *gtk_ui_manager_get_toplevels (GtkUIManager *self,
GSList *gtk_ui_manager_get_toplevels (GtkUIManager *manager,
GtkUIManagerItemType types);
GtkAction *gtk_ui_manager_get_action (GtkUIManager *self,
GtkAction *gtk_ui_manager_get_action (GtkUIManager *manager,
const gchar *path);
guint gtk_ui_manager_add_ui_from_string (GtkUIManager *self,
guint gtk_ui_manager_add_ui_from_string (GtkUIManager *manager,
const gchar *buffer,
gssize length,
GError **error);
guint gtk_ui_manager_add_ui_from_file (GtkUIManager *self,
guint gtk_ui_manager_add_ui_from_file (GtkUIManager *manager,
const gchar *filename,
GError **error);
void gtk_ui_manager_add_ui (GtkUIManager *self,
void gtk_ui_manager_add_ui (GtkUIManager *manager,
guint merge_id,
const gchar *path,
const gchar *name,
const gchar *action,
GtkUIManagerItemType type,
gboolean top);
void gtk_ui_manager_remove_ui (GtkUIManager *self,
void gtk_ui_manager_remove_ui (GtkUIManager *manager,
guint merge_id);
gchar *gtk_ui_manager_get_ui (GtkUIManager *self);
void gtk_ui_manager_ensure_update (GtkUIManager *self);
guint gtk_ui_manager_new_merge_id (GtkUIManager *self);
gchar *gtk_ui_manager_get_ui (GtkUIManager *manager);
void gtk_ui_manager_ensure_update (GtkUIManager *manager);
guint gtk_ui_manager_new_merge_id (GtkUIManager *manager);
G_END_DECLS

6
gtk/gtkviewport.c
View File

@ -332,7 +332,7 @@ gtk_viewport_destroy (GtkObject *object)
*
* Returns the horizontal adjustment of the viewport.
*
* Return value: the horizontal adjustment of @viewport.
* Return value: (transfer none): the horizontal adjustment of @viewport.
**/
GtkAdjustment*
gtk_viewport_get_hadjustment (GtkViewport *viewport)
@ -355,7 +355,7 @@ gtk_viewport_get_hadjustment (GtkViewport *viewport)
*
* Returns the vertical adjustment of the viewport.
*
* Return value: the vertical adjustment of @viewport.
* Return value: (transfer none): the vertical adjustment of @viewport.
**/
GtkAdjustment*
gtk_viewport_get_vadjustment (GtkViewport *viewport)
@ -639,7 +639,7 @@ gtk_viewport_get_shadow_type (GtkViewport *viewport)
*
* Gets the bin window of the #GtkViewport.
*
* Return value: a #GdkWindow
* Return value: (transfer none): a #GdkWindow
*
* Since: 2.20
**/

7
gtk/gtkwidget.c
View File

@ -7739,7 +7739,7 @@ gtk_widget_update_pango_context (GtkWidget *widget)
* font description, and base direction for drawing text for
* this widget. See also gtk_widget_get_pango_context().
*
* Return value: the new #PangoContext
* Return value: (transfer full): the new #PangoContext
**/
PangoContext *
gtk_widget_create_pango_context (GtkWidget *widget)
@ -7781,7 +7781,7 @@ gtk_widget_create_pango_context (GtkWidget *widget)
* the #GtkWidget::style-set and #GtkWidget::direction-changed signals
* for the widget.
*
* Return value: the new #PangoLayout
* Return value: (transfer full): the new #PangoLayout
**/
PangoLayout *
gtk_widget_create_pango_layout (GtkWidget *widget,
@ -7822,7 +7822,8 @@ gtk_widget_create_pango_layout (GtkWidget *widget,
* the application and should not be modified. The pixbuf should be freed
* after use with g_object_unref().
*
* Return value: a new pixbuf, or %NULL if the stock ID wasn't known
* Return value: (transferi full): a new pixbuf, or %NULL if the
* stock ID wasn't known
**/
GdkPixbuf*
gtk_widget_render_icon (GtkWidget *widget,

2
gtk/gtkwindow.c
View File

@ -1794,7 +1794,7 @@ gtk_window_set_default (GtkWindow *window,
* Returns the default widget for @window. See gtk_window_set_default()
* for more details.
*
* Returns: the default widget, or %NULL if there is none.
* Returns: (transfer none): the default widget, or %NULL if there is none.
*
* Since: 2.14
**/

2
gtk/gtkwrapbox.c
View File

@ -1984,7 +1984,7 @@ gtk_wrap_box_get_width_for_height (GtkSizeRequest *widget,
/**
* gtk_wrap_box_new:
* @allocation_mode: The #GtkWrapAllocationMode to use
* @mode: The #GtkWrapAllocationMode to use
* @spreading: The #GtkWrapBoxSpreading policy to use
* @horizontal_spacing: The horizontal spacing to add between children
* @vertical_spacing: The vertical spacing to add between children

28
gtk/gtkwrapbox.h
View File

@ -58,36 +58,36 @@ GtkWidget *gtk_wrap_box_new (GtkWrapAllocationM
GtkWrapBoxSpreading spreading,
guint horizontal_spacing,
guint vertical_spacing);
void gtk_wrap_box_set_allocation_mode (GtkWrapBox *layout,
void gtk_wrap_box_set_allocation_mode (GtkWrapBox *box,
GtkWrapAllocationMode mode);
GtkWrapAllocationMode gtk_wrap_box_get_allocation_mode (GtkWrapBox *layout);
GtkWrapAllocationMode gtk_wrap_box_get_allocation_mode (GtkWrapBox *box);
void gtk_wrap_box_set_spreading (GtkWrapBox *layout,
void gtk_wrap_box_set_spreading (GtkWrapBox *box,
GtkWrapBoxSpreading spreading);
GtkWrapBoxSpreading gtk_wrap_box_get_spreading (GtkWrapBox *layout);
GtkWrapBoxSpreading gtk_wrap_box_get_spreading (GtkWrapBox *box);
void gtk_wrap_box_set_vertical_spacing (GtkWrapBox *layout,
void gtk_wrap_box_set_vertical_spacing (GtkWrapBox *box,
guint spacing);
guint gtk_wrap_box_get_vertical_spacing (GtkWrapBox *layout);
guint gtk_wrap_box_get_vertical_spacing (GtkWrapBox *box);
void gtk_wrap_box_set_horizontal_spacing (GtkWrapBox *layout,
void gtk_wrap_box_set_horizontal_spacing (GtkWrapBox *box,
guint spacing);
guint gtk_wrap_box_get_horizontal_spacing (GtkWrapBox *layout);
guint gtk_wrap_box_get_horizontal_spacing (GtkWrapBox *box);
void gtk_wrap_box_set_minimum_line_children (GtkWrapBox *layout,
void gtk_wrap_box_set_minimum_line_children (GtkWrapBox *box,
guint n_children);
guint gtk_wrap_box_get_minimum_line_children (GtkWrapBox *layout);
guint gtk_wrap_box_get_minimum_line_children (GtkWrapBox *box);
void gtk_wrap_box_set_natural_line_children (GtkWrapBox *layout,
void gtk_wrap_box_set_natural_line_children (GtkWrapBox *box,
guint n_children);
guint gtk_wrap_box_get_natural_line_children (GtkWrapBox *layout);
guint gtk_wrap_box_get_natural_line_children (GtkWrapBox *box);
void gtk_wrap_box_insert_child (GtkWrapBox *layout,
void gtk_wrap_box_insert_child (GtkWrapBox *box,
GtkWidget *widget,
gint index,
GtkWrapBoxPacking packing);
void gtk_wrap_box_reorder_child (GtkWrapBox *layout,
void gtk_wrap_box_reorder_child (GtkWrapBox *box,
GtkWidget *widget,
guint index);