[gtk+/gi-annotations-2: 3/12] [GI] Add missing (transfer) annotations
- From: Pavel Holejsovsky <pholejs src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+/gi-annotations-2: 3/12] [GI] Add missing (transfer) annotations
- Date: Tue, 18 Jan 2011 09:32:31 +0000 (UTC)
commit 5b19b1fb49c6b2479fe8941ff901414c7ad69db3
Author: Pavel Holejsovsky <pholejs src gnome org>
Date: Tue Jan 18 10:01:17 2011 +0100
[GI] Add missing (transfer) annotations
gdk/gdkcursor.c | 2 +-
gdk/gdkdisplay.c | 2 +-
gdk/gdkdisplaymanager.c | 4 ++--
gdk/gdkdnd.c | 2 +-
gdk/gdkevents.c | 2 +-
gdk/gdkoffscreenwindow.c | 2 +-
gdk/gdkwindow.c | 21 ++++++++++++---------
gdk/x11/gdkdisplay-x11.c | 3 ++-
gdk/x11/gdkvisual-x11.c | 4 ++--
gtk/gtkaboutdialog.c | 6 +++---
gtk/gtkaccelgroup.c | 7 ++++---
gtk/gtkaction.c | 5 +++--
gtk/gtkbindings.c | 2 +-
gtk/gtkcellarea.c | 15 ++++++++-------
gtk/gtkcellareacontext.c | 2 +-
gtk/gtkcontainer.c | 11 ++++++-----
gtk/gtkdnd.c | 10 +++++-----
gtk/gtkiconfactory.c | 4 ++--
gtk/gtklabel.c | 3 ++-
gtk/gtkmain.c | 6 +++---
gtk/gtkmenu.c | 10 +++++-----
gtk/gtkmenushell.c | 4 ++--
gtk/gtknotebook.c | 3 ++-
gtk/gtknumerableicon.c | 4 ++--
gtk/gtkpagesetupunixdialog.c | 4 ++--
gtk/gtkprintcontext.c | 2 +-
gtk/gtkprinter.c | 2 +-
gtk/gtkprintjob.c | 6 +++---
gtk/gtkprintoperation-unix.c | 2 +-
gtk/gtkprintoperation.c | 4 ++--
gtk/gtkprintunixdialog.c | 4 ++--
gtk/gtkradiobutton.c | 4 ++--
gtk/gtkrc.c | 6 +++---
gtk/gtkrecentmanager.c | 2 +-
gtk/gtkselection.c | 8 ++++----
gtk/gtkstyle.c | 2 +-
gtk/gtkstylecontext.c | 7 ++++---
gtk/gtkstyleproperties.c | 2 +-
gtk/gtkstyleprovider.c | 5 +++--
gtk/gtktestutils.c | 8 ++++----
gtk/gtktextbuffer.c | 4 ++--
gtk/gtktextbufferrichtext.c | 16 ++++++++--------
gtk/gtkthemingengine.c | 7 ++++---
gtk/gtkwidget.c | 4 ++--
gtk/gtkwindow.c | 6 +++---
45 files changed, 126 insertions(+), 113 deletions(-)
---
diff --git a/gdk/gdkcursor.c b/gdk/gdkcursor.c
index fe5f38c..b28064f 100644
--- a/gdk/gdkcursor.c
+++ b/gdk/gdkcursor.c
@@ -150,7 +150,7 @@ gdk_cursor_init (GdkCursor *cursor)
*
* Adds a reference to @cursor.
*
- * Return value: Same @cursor that was passed in
+ * Return value: (transfer full): Same @cursor that was passed in
*
* Deprecated: 3.0: Use g_object_ref() instead
*/
diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c
index fa2e645..0cbf387 100644
--- a/gdk/gdkdisplay.c
+++ b/gdk/gdkdisplay.c
@@ -1756,7 +1756,7 @@ gdk_display_real_get_app_launch_context (GdkDisplay *display)
* Returns a #GdkAppLaunchContext suitable for launching
* applications on the given display.
*
- * Returns: a new #GdkAppLaunchContext for @display.
+ * Returns: (transfer full): a new #GdkAppLaunchContext for @display.
* Free with g_object_unref() when done
*
* Since: 3.0
diff --git a/gdk/gdkdisplaymanager.c b/gdk/gdkdisplaymanager.c
index 79ed85a..160404d 100644
--- a/gdk/gdkdisplaymanager.c
+++ b/gdk/gdkdisplaymanager.c
@@ -335,7 +335,7 @@ gdk_display_manager_open_display (GdkDisplayManager *manager,
*
* Finds or creates an atom corresponding to a given string.
*
- * Returns: the atom corresponding to @atom_name.
+ * Returns: (transfer none): the atom corresponding to @atom_name.
*/
GdkAtom
gdk_atom_intern (const gchar *atom_name,
@@ -361,7 +361,7 @@ gdk_atom_intern (const gchar *atom_name,
* ever unload the module again (e.g. do not use this function in
* GTK+ theme engines).
*
- * Returns: the atom corresponding to @atom_name
+ * Returns: (transfer none): the atom corresponding to @atom_name
*
* Since: 2.10
*/
diff --git a/gdk/gdkdnd.c b/gdk/gdkdnd.c
index bb2e6a8..fd54a8a 100644
--- a/gdk/gdkdnd.c
+++ b/gdk/gdkdnd.c
@@ -445,7 +445,7 @@ gdk_drag_drop_succeeded (GdkDragContext *context)
*
* Returns the selection atom for the current source window.
*
- * Return value: the selection atom, or %GDK_NONE
+ * Return value: (transfer none): the selection atom, or %GDK_NONE
*/
GdkAtom
gdk_drag_get_selection (GdkDragContext *context)
diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c
index 1878799..34974e4 100644
--- a/gdk/gdkevents.c
+++ b/gdk/gdkevents.c
@@ -1161,7 +1161,7 @@ gdk_event_set_source_device (GdkEvent *event,
*
* If the event does not contain device field, this function will return %NULL.
*
- * Returns: a #GdkDevice, or %NULL.
+ * Returns: (transfer none): a #GdkDevice, or %NULL.
*
* Since: 3.0
**/
diff --git a/gdk/gdkoffscreenwindow.c b/gdk/gdkoffscreenwindow.c
index fa1518f..b3c53af 100644
--- a/gdk/gdkoffscreenwindow.c
+++ b/gdk/gdkoffscreenwindow.c
@@ -334,7 +334,7 @@ gdk_offscreen_window_get_device_state (GdkWindow *window,
* If you need to keep this around over window resizes, you need to
* add a reference to it.
*
- * Returns: The offscreen surface, or %NULL if not offscreen
+ * Returns: (transfer none): The offscreen surface, or %NULL if not offscreen
*/
cairo_surface_t *
gdk_offscreen_window_get_surface (GdkWindow *window)
diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c
index aa9fb3c..0ea4d40 100644
--- a/gdk/gdkwindow.c
+++ b/gdk/gdkwindow.c
@@ -384,7 +384,8 @@ gdk_window_class_init (GdkWindowClass *klass)
* The ::pick-embedded-child signal is emitted to find an embedded
* child at the given position.
*
- * Returns: the #GdkWindow of the embedded child at @x, @y, or %NULL
+ * Returns: (transfer none): the #GdkWindow of the embedded child at
+ * @x, @y, or %NULL
*
* Since: 2.18
*/
@@ -6584,8 +6585,8 @@ gdk_window_set_background_pattern (GdkWindow *window,
* does not have its own background and reuses the parent's, %NULL is
* returned and you'll have to query it yourself.
*
- * Returns: The pattern to use for the background or %NULL to use the
- * parent's background.
+ * Returns: (transfer none): The pattern to use for the background or
+ * %NULL to use the parent's background.
*
* Since: 2.22
**/
@@ -6622,9 +6623,10 @@ update_cursor_foreach (GdkDisplay *display,
* there is no custom cursor set on the specified window, and it is
* using the cursor for its parent window.
*
- * Return value: a #GdkCursor, or %NULL. The returned object is owned
- * by the #GdkWindow and should not be unreferenced directly. Use
- * gdk_window_set_cursor() to unset the cursor of the window
+ * Return value: (transfer none): a #GdkCursor, or %NULL. The returned
+ * object is owned by the #GdkWindow and should not be unreferenced
+ * directly. Use gdk_window_set_cursor() to unset the cursor of the
+ * window
*
* Since: 2.18
*/
@@ -6686,9 +6688,10 @@ gdk_window_set_cursor (GdkWindow *window,
* there is no custom cursor set on the specified window, and it is
* using the cursor for its parent window.
*
- * Returns: a #GdkCursor, or %NULL. The returned object is owned
- * by the #GdkWindow and should not be unreferenced directly. Use
- * gdk_window_set_cursor() to unset the cursor of the window
+ * Returns: (transfer none): a #GdkCursor, or %NULL. The returned
+ * object is owned by the #GdkWindow and should not be unreferenced
+ * directly. Use gdk_window_set_cursor() to unset the cursor of the
+ * window
*
* Since: 3.0
**/
diff --git a/gdk/x11/gdkdisplay-x11.c b/gdk/x11/gdkdisplay-x11.c
index e406bb8..b3d77cb 100644
--- a/gdk/x11/gdkdisplay-x11.c
+++ b/gdk/x11/gdkdisplay-x11.c
@@ -1854,7 +1854,8 @@ gdk_x11_lookup_xdisplay (Display *xdisplay)
* Given the root window ID of one of the screen's of a #GdkDisplay,
* finds the screen.
*
- * Return value: the #GdkScreen corresponding to @xrootwin, or %NULL.
+ * Return value: (transfer none): the #GdkScreen corresponding to
+ * @xrootwin, or %NULL.
**/
GdkScreen *
_gdk_x11_display_screen_for_xrootwin (GdkDisplay *display,
diff --git a/gdk/x11/gdkvisual-x11.c b/gdk/x11/gdkvisual-x11.c
index eb394f6..7d80a12 100644
--- a/gdk/x11/gdkvisual-x11.c
+++ b/gdk/x11/gdkvisual-x11.c
@@ -462,8 +462,8 @@ _gdk_x11_screen_list_visuals (GdkScreen *screen)
*
* Looks up the #GdkVisual for a particular screen and X Visual ID.
*
- * Returns: the #GdkVisual (owned by the screen object), or %NULL
- * if the visual ID wasn't found.
+ * Returns: (transfer none): the #GdkVisual (owned by the screen
+ * object), or %NULL if the visual ID wasn't found.
*
* Since: 2.2
*/
diff --git a/gtk/gtkaboutdialog.c b/gtk/gtkaboutdialog.c
index 414355e..8da802f 100644
--- a/gtk/gtkaboutdialog.c
+++ b/gtk/gtkaboutdialog.c
@@ -1706,9 +1706,9 @@ gtk_about_dialog_set_translator_credits (GtkAboutDialog *about,
*
* Returns the pixbuf displayed as logo in the about dialog.
*
- * Return value: the pixbuf displayed as logo. The pixbuf is
- * owned by the about dialog. If you want to keep a reference
- * to it, you have to call g_object_ref() on it.
+ * Return value: (transfer none): the pixbuf displayed as logo. The
+ * pixbuf is owned by the about dialog. If you want to keep a
+ * reference to it, you have to call g_object_ref() on it.
*
* Since: 2.6
*/
diff --git a/gtk/gtkaccelgroup.c b/gtk/gtkaccelgroup.c
index 5a52359..6394b4e 100644
--- a/gtk/gtkaccelgroup.c
+++ b/gtk/gtkaccelgroup.c
@@ -378,8 +378,8 @@ gtk_accel_groups_from_object (GObject *object)
* @find_func: (scope call): a function to filter the entries
* of @accel_group with
* @data: data to pass to @find_func
- * @returns: the key of the first entry passing @find_func. The key is
- * owned by GTK+ and must not be freed.
+ * @returns: (transfer none): the key of the first entry passing
+ * @find_func. The key is owned by GTK+ and must not be freed.
*
* Finds the first entry in an accelerator group for which
* @find_func returns %TRUE and returns its #GtkAccelKey.
@@ -848,7 +848,8 @@ gtk_accel_group_query (GtkAccelGroup *accel_group,
/**
* gtk_accel_group_from_accel_closure:
* @closure: a #GClosure
- * @returns: (allow-none): the #GtkAccelGroup to which @closure is connected, or %NULL.
+ * @returns: (transfer none): the #GtkAccelGroup to which @closure
+ * is connected, or %NULL.
*
* Finds the #GtkAccelGroup to which @closure is connected;
* see gtk_accel_group_connect().
diff --git a/gtk/gtkaction.c b/gtk/gtkaction.c
index 0a7fcb2..52935a3 100644
--- a/gtk/gtkaction.c
+++ b/gtk/gtkaction.c
@@ -1705,8 +1705,9 @@ gtk_action_get_accel_path (GtkAction *action)
*
* Since: 2.8
*
- * Returns: the accel closure for this action. The returned closure is
- * owned by GTK+ and must not be unreffed or modified.
+ * Returns: (transfer none): the accel closure for this action. The
+ * returned closure is owned by GTK+ and must not be unreffed
+ * or modified.
*/
GClosure *
gtk_action_get_accel_closure (GtkAction *action)
diff --git a/gtk/gtkbindings.c b/gtk/gtkbindings.c
index 733c9b1..21820b7 100644
--- a/gtk/gtkbindings.c
+++ b/gtk/gtkbindings.c
@@ -650,7 +650,7 @@ gtk_binding_set_by_class (gpointer object_class)
* either be a name used for gtk_binding_set_new() or the type name of
* a class used in gtk_binding_set_by_class().
*
- * Return value: %NULL or the specified binding set
+ * Return value: (transfer none): %NULL or the specified binding set
*/
GtkBindingSet*
gtk_binding_set_find (const gchar *set_name)
diff --git a/gtk/gtkcellarea.c b/gtk/gtkcellarea.c
index 8976c22..39a4ebc 100644
--- a/gtk/gtkcellarea.c
+++ b/gtk/gtkcellarea.c
@@ -1907,7 +1907,7 @@ get_cell_by_position (GtkCellRenderer *renderer,
* Gets the #GtkCellRenderer at @x and @y coordinates inside @area and optionally
* returns the full cell allocation for it inside @cell_area.
*
- * Return value: the #GtkCellRenderer at @x and @y.
+ * Return value: (transfer none): the #GtkCellRenderer at @x and @y.
*
* Since: 3.0
*/
@@ -2433,8 +2433,8 @@ gtk_cell_area_class_install_cell_property (GtkCellAreaClass *aclass,
*
* Finds a cell property of a cell area class by name.
*
- * Return value: (allow-none): the #GParamSpec of the child property or %NULL if @aclass has no
- * child property with that name.
+ * Return value: (transfer none): the #GParamSpec of the child property
+ * or %NULL if @aclass has no child property with that name.
*
* Since: 3.0
*/
@@ -2993,7 +2993,7 @@ gtk_cell_area_set_focus_cell (GtkCellArea *area,
*
* Retrieves the currently focused cell for @area
*
- * Return value: the currently focused cell in @area.
+ * Return value: (transfer none): the currently focused cell in @area.
*
* Since: 3.0
*/
@@ -3177,7 +3177,8 @@ gtk_cell_area_get_focus_siblings (GtkCellArea *area,
* then chose to activate the focus cell for which the event
* cell may have been a sibling.
*
- * Return value: the #GtkCellRenderer for which @renderer is a sibling, or %NULL.
+ * Return value: (transfer none): the #GtkCellRenderer for which @renderer
+ * is a sibling, or %NULL.
*
* Since: 3.0
*/
@@ -3320,7 +3321,7 @@ gtk_cell_area_set_edit_widget (GtkCellArea *area,
* Gets the #GtkCellRenderer in @area that is currently
* being edited.
*
- * Return value: The currently edited #GtkCellRenderer
+ * Return value: (transfer none): The currently edited #GtkCellRenderer
*
* Since: 3.0
*/
@@ -3343,7 +3344,7 @@ gtk_cell_area_get_edited_cell (GtkCellArea *area)
* Gets the #GtkCellEditable widget currently used
* to edit the currently edited cell.
*
- * Return value: The currently active #GtkCellEditable widget
+ * Return value: (transfer none): The currently active #GtkCellEditable widget
*
* Since: 3.0
*/
diff --git a/gtk/gtkcellareacontext.c b/gtk/gtkcellareacontext.c
index ca1ac3a..d085494 100644
--- a/gtk/gtkcellareacontext.c
+++ b/gtk/gtkcellareacontext.c
@@ -348,7 +348,7 @@ gtk_cell_area_context_real_allocate (GtkCellAreaContext *context,
* that the #GtkCellArea is configured with in order to
* compute a proper allocation.
*
- * Return value: the #GtkCellArea this context was created by.
+ * Return value: (transfer none): the #GtkCellArea this context was created by.
*
* Since: 3.0
*/
diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index d531bba..d6d1877 100644
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -1196,10 +1196,10 @@ gtk_container_class_install_child_property (GtkContainerClass *cclass,
/**
* gtk_container_class_find_child_property:
- * @cclass: a #GtkContainerClass
+ * @cclass: (type GtkContainerClass): a #GtkContainerClass
* @property_name: the name of the child property to find
- * @returns: (allow-none): the #GParamSpec of the child property or %NULL if @class has no
- * child property with that name.
+ * @returns: (transfer none): the #GParamSpec of the child property or
+ * %NULL if @class has no child property with that name.
*
* Finds a child property of a container class by name.
*/
@@ -1951,8 +1951,9 @@ gtk_container_set_focus_child (GtkContainer *container,
* currently focused widget. That can be obtained by calling
* gtk_window_get_focus().
*
- * Returns: The child widget which will recieve the focus inside @container when
- * the @conatiner is focussed, or %NULL if none is set.
+ * Returns: (transfer none): The child widget which will receive the
+ * focus inside @container when the @conatiner is focussed,
+ * or %NULL if none is set.
*
* Since: 2.14
**/
diff --git a/gtk/gtkdnd.c b/gtk/gtkdnd.c
index 933172b..4131f13 100644
--- a/gtk/gtkdnd.c
+++ b/gtk/gtkdnd.c
@@ -1355,7 +1355,7 @@ gtk_drag_dest_unset (GtkWidget *widget)
* Returns the list of targets this widget can accept from
* drag-and-drop.
*
- * Return value: the #GtkTargetList, or %NULL if none
+ * Return value: (transfer none): the #GtkTargetList, or %NULL if none
**/
GtkTargetList*
gtk_drag_dest_get_target_list (GtkWidget *widget)
@@ -1666,8 +1666,8 @@ _gtk_drag_dest_handle_event (GtkWidget *toplevel,
* 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
+ * Return value: (transfer none): first target that the source offers
+ * and the dest can accept, or %GDK_NONE
**/
GdkAtom
gtk_drag_dest_find_target (GtkWidget *widget,
@@ -2544,7 +2544,7 @@ gtk_drag_begin_internal (GtkWidget *widget,
* (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.
+ * Return value: (transfer none): the context for this drag.
**/
GdkDragContext *
gtk_drag_begin (GtkWidget *widget,
@@ -2657,7 +2657,7 @@ gtk_drag_source_unset (GtkWidget *widget)
* Gets the list of targets this widget can provide for
* drag-and-drop.
*
- * Return value: the #GtkTargetList, or %NULL if none
+ * Return value: (transfer none): the #GtkTargetList, or %NULL if none
*
* Since: 2.4
**/
diff --git a/gtk/gtkiconfactory.c b/gtk/gtkiconfactory.c
index 4674449..5147282 100644
--- a/gtk/gtkiconfactory.c
+++ b/gtk/gtkiconfactory.c
@@ -251,7 +251,7 @@ gtk_icon_factory_add (GtkIconFactory *factory,
* widget that will display the icon, instead of using this
* function directly, so that themes are taken into account.
*
- * Return value: icon set of @stock_id.
+ * Return value: (transfer none): icon set of @stock_id.
*/
GtkIconSet *
gtk_icon_factory_lookup (GtkIconFactory *factory,
@@ -330,7 +330,7 @@ _gtk_icon_factory_ensure_default_icons (void)
* using this function directly, so that themes are taken into
* account.
*
- * Return value: a #GtkIconSet, or %NULL
+ * Return value: (transfer none): a #GtkIconSet, or %NULL
*/
GtkIconSet *
gtk_icon_factory_lookup_default (const gchar *stock_id)
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index 7fff547..5f4ba06 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -2036,7 +2036,8 @@ gtk_label_set_attributes (GtkLabel *label,
* effective attributes for the label, use
* pango_layout_get_attribute (gtk_label_get_layout (label)).
*
- * Return value: the attribute list, or %NULL if none was set.
+ * Return value: (transfer none): the attribute list, or %NULL
+ * if none was set.
**/
PangoAttrList *
gtk_label_get_attributes (GtkLabel *label)
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index ae6980f..79077b8 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -2384,9 +2384,9 @@ gtk_invoke_key_snoopers (GtkWidget *grab_widget,
* the current event will be the #GdkEventButton that triggered
* the ::clicked signal.
*
- * Return value: a copy of the current event, or %NULL if there is
- * no current event. The returned event must be freed with
- * gdk_event_free().
+ * Return value: (transfer full): a copy of the current event, or
+ * %NULL if there is no current event. The returned event must be
+ * freed with gdk_event_free().
*/
GdkEvent*
gtk_get_current_event (void)
diff --git a/gtk/gtkmenu.c b/gtk/gtkmenu.c
index e1b4ca3..034e11d 100644
--- a/gtk/gtkmenu.c
+++ b/gtk/gtkmenu.c
@@ -1251,7 +1251,7 @@ gtk_menu_attach_to_widget (GtkMenu *menu,
*
* Returns the #GtkWidget that the menu is attached to.
*
- * Returns: the #GtkWidget that the menu is attached to
+ * Returns: (transfer none): the #GtkWidget that the menu is attached to
*/
GtkWidget*
gtk_menu_get_attach_widget (GtkMenu *menu)
@@ -1889,9 +1889,9 @@ gtk_menu_popdown (GtkMenu *menu)
* Returns the selected menu item from the menu. This is used by the
* #GtkOptionMenu.
*
- * Returns: the #GtkMenuItem that was last selected in the menu. If a
- * selection has not yet been made, the first menu item is
- * selected.
+ * Returns: (transfer none): the #GtkMenuItem that was last selected
+ * in the menu. If a selection has not yet been made, the
+ * first menu item is selected.
*/
GtkWidget*
gtk_menu_get_active (GtkMenu *menu)
@@ -1995,7 +1995,7 @@ gtk_menu_set_accel_group (GtkMenu *menu,
* Gets the #GtkAccelGroup which holds global accelerators for the
* menu. See gtk_menu_set_accel_group().
*
- * Returns: the #GtkAccelGroup associated with the menu.
+ * Returns: (transfer none): the #GtkAccelGroup associated with the menu.
*/
GtkAccelGroup*
gtk_menu_get_accel_group (GtkMenu *menu)
diff --git a/gtk/gtkmenushell.c b/gtk/gtkmenushell.c
index 172b576..f210cab 100644
--- a/gtk/gtkmenushell.c
+++ b/gtk/gtkmenushell.c
@@ -1990,7 +1990,7 @@ gtk_menu_shell_set_take_focus (GtkMenuShell *menu_shell,
*
* Gets the currently selected item.
*
- * Returns: the currently selected item
+ * Returns: (transfer none): the currently selected item
*
* Since: 3.0
*/
@@ -2011,7 +2011,7 @@ gtk_menu_shell_get_selected_item (GtkMenuShell *menu_shell)
* The parent menu shell of a submenu is the #GtkMenu or #GtkMenuBar
* from which it was opened up.
*
- * Returns: the parent #GtkMenuShell
+ * Returns: (transfer none): the parent #GtkMenuShell
*
* Since: 3.0
*/
diff --git a/gtk/gtknotebook.c b/gtk/gtknotebook.c
index e94518d..a237602 100644
--- a/gtk/gtknotebook.c
+++ b/gtk/gtknotebook.c
@@ -1047,7 +1047,8 @@ gtk_notebook_class_init (GtkNotebookClass *class)
* necessary properties to the notebook (e.g. the
* #GtkNotebook:group ).
*
- * Returns: a #GtkNotebook that @page should be added to, or %NULL.
+ * Returns: (transfer none): a #GtkNotebook that @page should be
+ * added to, or %NULL.
*
* Since: 2.12
*/
diff --git a/gtk/gtknumerableicon.c b/gtk/gtknumerableicon.c
index 2522102..adb1cc6 100644
--- a/gtk/gtknumerableicon.c
+++ b/gtk/gtknumerableicon.c
@@ -1008,7 +1008,7 @@ gtk_numerable_icon_get_background_icon_name (GtkNumerableIcon *self)
*
* Creates a new unthemed #GtkNumerableIcon.
*
- * Returns: a new #GIcon
+ * Returns: (transfer full): a new #GIcon
*
* Since: 3.0
*/
@@ -1031,7 +1031,7 @@ gtk_numerable_icon_new (GIcon *base_icon)
* to the passed #GtkStyleContext. This is a convenience constructor
* that calls gtk_numerable_icon_set_style_context() internally.
*
- * Returns: a new #GIcon
+ * Returns: (transfer full): a new #GIcon
*
* Since: 3.0
*/
diff --git a/gtk/gtkpagesetupunixdialog.c b/gtk/gtkpagesetupunixdialog.c
index ed1190d..0a4e141 100644
--- a/gtk/gtkpagesetupunixdialog.c
+++ b/gtk/gtkpagesetupunixdialog.c
@@ -1099,7 +1099,7 @@ gtk_page_setup_unix_dialog_set_page_setup (GtkPageSetupUnixDialog *dialog,
*
* Gets the currently selected page setup from the dialog.
*
- * Returns: the current page setup
+ * Returns: (transfer none): the current page setup
*
* Since: 2.10
**/
@@ -1196,7 +1196,7 @@ gtk_page_setup_unix_dialog_set_print_settings (GtkPageSetupUnixDialog *dialog,
*
* Gets the current print settings from the dialog.
*
- * Returns: the current print settings
+ * Returns: (transfer none): the current print settings
*
* Since: 2.10
**/
diff --git a/gtk/gtkprintcontext.c b/gtk/gtkprintcontext.c
index c512869..9cd0298 100644
--- a/gtk/gtkprintcontext.c
+++ b/gtk/gtkprintcontext.c
@@ -253,7 +253,7 @@ _gtk_print_context_set_page_setup (GtkPrintContext *context,
* Obtains the cairo context that is associated with the
* #GtkPrintContext.
*
- * Return value: the cairo context of @context
+ * Return value: (transfer none): the cairo context of @context
*
* Since: 2.10
*/
diff --git a/gtk/gtkprinter.c b/gtk/gtkprinter.c
index 4d5112b..0a416d6 100644
--- a/gtk/gtkprinter.c
+++ b/gtk/gtkprinter.c
@@ -414,7 +414,7 @@ gtk_printer_new (const gchar *name,
*
* Returns the backend of the printer.
*
- * Return value: the backend of @printer
+ * Return value: (transfer none): the backend of @printer
*
* Since: 2.10
*/
diff --git a/gtk/gtkprintjob.c b/gtk/gtkprintjob.c
index d37e122..5fb95c6 100644
--- a/gtk/gtkprintjob.c
+++ b/gtk/gtkprintjob.c
@@ -336,7 +336,7 @@ gtk_print_job_new (const gchar *title,
*
* Gets the #GtkPrintSettings of the print job.
*
- * Return value: the settings of @job
+ * Return value: (transfer none): the settings of @job
*
* Since: 2.10
*/
@@ -354,7 +354,7 @@ gtk_print_job_get_settings (GtkPrintJob *job)
*
* Gets the #GtkPrinter of the print job.
*
- * Return value: the printer of @job
+ * Return value: (transfer none): the printer of @job
*
* Since: 2.10
*/
@@ -471,7 +471,7 @@ gtk_print_job_set_source_file (GtkPrintJob *job,
* Gets a cairo surface onto which the pages of
* the print job should be rendered.
*
- * Return value: the cairo surface of @job
+ * Return value: (transfer none): the cairo surface of @job
*
* Since: 2.10
**/
diff --git a/gtk/gtkprintoperation-unix.c b/gtk/gtkprintoperation-unix.c
index d3a8a37..e220e59 100644
--- a/gtk/gtkprintoperation-unix.c
+++ b/gtk/gtkprintoperation-unix.c
@@ -964,7 +964,7 @@ get_page_setup_dialog (GtkWindow *parent,
* setup dialog. See gtk_print_run_page_setup_dialog_async() if this is
* a problem.
*
- * Return value: a new #GtkPageSetup
+ * Return value: (transfer full): a new #GtkPageSetup
*
* Since: 2.10
*/
diff --git a/gtk/gtkprintoperation.c b/gtk/gtkprintoperation.c
index 96425ed..ff5e00c 100644
--- a/gtk/gtkprintoperation.c
+++ b/gtk/gtkprintoperation.c
@@ -892,8 +892,8 @@ gtk_print_operation_class_init (GtkPrintOperationClass *class)
* signal is emitted on the operation. Then you can read out any
* information you need from the widgets.
*
- * Returns: A custom widget that gets embedded in the print dialog,
- * or %NULL
+ * Returns: (transfer none): A custom widget that gets embedded in
+ * the print dialog, or %NULL
*
* Since: 2.10
*/
diff --git a/gtk/gtkprintunixdialog.c b/gtk/gtkprintunixdialog.c
index d4d1211..d555c1b 100644
--- a/gtk/gtkprintunixdialog.c
+++ b/gtk/gtkprintunixdialog.c
@@ -3884,7 +3884,7 @@ gtk_print_unix_dialog_new (const gchar *title,
*
* Gets the currently selected printer.
*
- * Returns: the currently selected printer
+ * Returns: (transfer none): the currently selected printer
*
* Since: 2.10
*/
@@ -3933,7 +3933,7 @@ gtk_print_unix_dialog_set_page_setup (GtkPrintUnixDialog *dialog,
*
* Gets the page setup that is used by the #GtkPrintUnixDialog.
*
- * Returns: the page setup of @dialog.
+ * Returns: (transfer none): the page setup of @dialog.
*
* Since: 2.10
*/
diff --git a/gtk/gtkradiobutton.c b/gtk/gtkradiobutton.c
index a793483..7e665b4 100644
--- a/gtk/gtkradiobutton.c
+++ b/gtk/gtkradiobutton.c
@@ -432,7 +432,7 @@ gtk_radio_button_new (GSList *group)
*
* Creates a new #GtkRadioButton with a text label.
*
- * Returns: (transfer full): a new radio button.
+ * Returns: a new radio button.
*/
GtkWidget*
gtk_radio_button_new_with_label (GSList *group,
@@ -460,7 +460,7 @@ gtk_radio_button_new_with_label (GSList *group,
* gtk_label_new_with_mnemonic(), so underscores in @label indicate the
* mnemonic for the button.
*
- * Returns: (transfer full): a new #GtkRadioButton
+ * Returns: a new #GtkRadioButton
*/
GtkWidget*
gtk_radio_button_new_with_mnemonic (GSList *group,
diff --git a/gtk/gtkrc.c b/gtk/gtkrc.c
index 5e37a56..f9db924 100644
--- a/gtk/gtkrc.c
+++ b/gtk/gtkrc.c
@@ -751,9 +751,9 @@ gtk_rc_reparse_all (void)
* created styles, so a new style may not be
* created.)
*
- * Returns: the resulting style. No refcount is added
- * to the returned style, so if you want to save this
- * style around, you should add a reference yourself.
+ * Returns: (transfer none): the resulting style. No refcount is added
+ * to the returned style, so if you want to save this style around,
+ * you should add a reference yourself.
*
* Deprecated:3.0: Use #GtkStyleContext instead
**/
diff --git a/gtk/gtkrecentmanager.c b/gtk/gtkrecentmanager.c
index ccdea45..4c4f70a 100644
--- a/gtk/gtkrecentmanager.c
+++ b/gtk/gtkrecentmanager.c
@@ -1975,7 +1975,7 @@ gtk_recent_info_get_icon (GtkRecentInfo *info,
*
* Retrieves the icon associated to the resource MIME type.
*
- * Return value: a #GIcon containing the icon, or %NULL. Use
+ * Return value: (transfer full): a #GIcon containing the icon, or %NULL. Use
* g_object_unref() when finished using the icon
*
* Since: 2.22
diff --git a/gtk/gtkselection.c b/gtk/gtkselection.c
index 67bc241..92c8ca5 100644
--- a/gtk/gtkselection.c
+++ b/gtk/gtkselection.c
@@ -221,7 +221,7 @@ static const char gtk_selection_handler_key[] = "gtk-selection-handlers";
*
* Creates a new #GtkTargetList from an array of #GtkTargetEntry.
*
- * Return value: the new #GtkTargetList.
+ * Return value: (transfer full): the new #GtkTargetList.
**/
GtkTargetList *
gtk_target_list_new (const GtkTargetEntry *targets,
@@ -1146,7 +1146,7 @@ gtk_selection_convert (GtkWidget *widget,
*
* Retrieves the selection #GdkAtom of the selection data.
*
- * Returns: the selection #GdkAtom of the selection data.
+ * Returns: (transfer none): the selection #GdkAtom of the selection data.
*
* Since: 2.16
**/
@@ -1164,7 +1164,7 @@ gtk_selection_data_get_selection (const GtkSelectionData *selection_data)
*
* Retrieves the target of the selection.
*
- * Returns: the target of the selection.
+ * Returns: (transfer none): the target of the selection.
*
* Since: 2.14
**/
@@ -1182,7 +1182,7 @@ gtk_selection_data_get_target (const GtkSelectionData *selection_data)
*
* Retrieves the data type of the selection.
*
- * Returns: the data type of the selection.
+ * Returns: (transfer none): the data type of the selection.
*
* Since: 2.14
**/
diff --git a/gtk/gtkstyle.c b/gtk/gtkstyle.c
index 9fd3bfb..7d9e5ef 100644
--- a/gtk/gtkstyle.c
+++ b/gtk/gtkstyle.c
@@ -919,7 +919,7 @@ gtk_style_detach (GtkStyle *style)
* and the default icon factory, returning an icon set if found,
* otherwise %NULL.
*
- * Return value: icon set of @stock_id
+ * Return value: (transfer none): icon set of @stock_id
*
* Deprecated:3.0: Use gtk_style_context_lookup_icon_set() instead
*/
diff --git a/gtk/gtkstylecontext.c b/gtk/gtkstylecontext.c
index ed51a56..2d7f4ac 100644
--- a/gtk/gtkstylecontext.c
+++ b/gtk/gtkstylecontext.c
@@ -2614,7 +2614,7 @@ gtk_style_context_set_screen (GtkStyleContext *context,
*
* Returns the #GdkScreen to which @context is attached.
*
- * Returns: a #GdkScreen.
+ * Returns: (transfer none): a #GdkScreen.
**/
GdkScreen *
gtk_style_context_get_screen (GtkStyleContext *context)
@@ -3547,8 +3547,9 @@ gtk_style_context_get_margin (GtkStyleContext *context,
* object is const and will remain valid until the
* #GtkStyleContext::changed signal happens.
*
- * Returns: the #PangoFontDescription for the given state. This
- * object is owned by GTK+ and should not be freed.
+ * Returns: (transfer none): the #PangoFontDescription for the given
+ * state. This object is owned by GTK+ and should not be
+ * freed.
*
* Since: 3.0
**/
diff --git a/gtk/gtkstyleproperties.c b/gtk/gtkstyleproperties.c
index 0052257..a1f538d 100644
--- a/gtk/gtkstyleproperties.c
+++ b/gtk/gtkstyleproperties.c
@@ -574,7 +574,7 @@ gtk_style_properties_map_color (GtkStyleProperties *props,
* Returns the symbolic color that is mapped
* to @name.
*
- * Returns: The mapped color
+ * Returns: (transfer none): The mapped color
*
* Since: 3.0
**/
diff --git a/gtk/gtkstyleprovider.c b/gtk/gtkstyleprovider.c
index 5cd63e4..d43808f 100644
--- a/gtk/gtkstyleprovider.c
+++ b/gtk/gtkstyleprovider.c
@@ -62,7 +62,8 @@ gtk_style_provider_iface_init (gpointer g_iface)
* Returns the style settings affecting a widget defined by @path, or %NULL if
* @provider doesn't contemplate styling @path.
*
- * Returns: a #GtkStyleProperties containing the style settings affecting @path
+ * Returns: (transfer full): a #GtkStyleProperties containing the
+ * style settings affecting @path
*
* Since: 3.0
**/
@@ -126,7 +127,7 @@ gtk_style_provider_get_style_property (GtkStyleProvider *provider,
* Returns the #GtkIconFactory defined to be in use for @path, or %NULL if none
* is defined.
*
- * Returns: The icon factory to use for @path, or %NULL
+ * Returns: (transfer none): The icon factory to use for @path, or %NULL
*
* Since: 3.0
**/
diff --git a/gtk/gtktestutils.c b/gtk/gtktestutils.c
index 76fcc77..e1fe5e7 100644
--- a/gtk/gtktestutils.c
+++ b/gtk/gtktestutils.c
@@ -230,7 +230,7 @@ gtk_test_spin_button_click (GtkSpinButton *spinner,
* so this function is genrally only useful in test programs with
* predetermined locales, see gtk_test_init() for more details.
*
- * Returns: a GtkLabel widget if any is found.
+ * Returns: (transfer none): a GtkLabel widget if any is found.
*
* Since: 2.14
**/
@@ -333,7 +333,7 @@ widget_geo_cmp (gconstpointer a,
* widget, relative to another labeling widget. Such as finding a
* button or text entry widget, given it's corresponding label widget.
*
- * Returns: a widget of type @widget_type if any is found.
+ * Returns: (transfer none): a widget of type @widget_type if any is found.
*
* Since: 2.14
**/
@@ -375,7 +375,7 @@ gtk_test_find_sibling (GtkWidget *base_widget,
* gtk_test_widget_click() for possible caveats involving the search of
* such widgets and synthesizing widget events.
*
- * Returns: a valid widget if any is found or %NULL.
+ * Returns: (transfer none): a valid widget if any is found or %NULL.
*
* Since: 2.14
**/
@@ -620,7 +620,7 @@ gtk_test_display_button_window (const gchar *window_title,
* The window will quit any running gtk_main()-loop when destroyed, and it
* will automatically be destroyed upon test function teardown.
*
- * Returns: a widget pointer to the newly created GtkWindow.
+ * Returns: (transfer none): a widget pointer to the newly created GtkWindow.
*
* Since: 2.14
**/
diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c
index 050ac9b..3a45357 100644
--- a/gtk/gtktextbuffer.c
+++ b/gtk/gtktextbuffer.c
@@ -4193,7 +4193,7 @@ gtk_text_buffer_get_target_list (GtkTextBuffer *buffer,
* using gtk_target_list_add_rich_text_targets() and
* gtk_target_list_add_text_targets().
*
- * Return value: the #GtkTargetList
+ * Return value: (transfer none): the #GtkTargetList
*
* Since: 2.10
**/
@@ -4225,7 +4225,7 @@ gtk_text_buffer_get_copy_target_list (GtkTextBuffer *buffer)
* using gtk_target_list_add_rich_text_targets() and
* gtk_target_list_add_text_targets().
*
- * Return value: the #GtkTargetList
+ * Return value: (transfer none): the #GtkTargetList
*
* Since: 2.10
**/
diff --git a/gtk/gtktextbufferrichtext.c b/gtk/gtktextbufferrichtext.c
index 8db902f..74a934f 100644
--- a/gtk/gtktextbufferrichtext.c
+++ b/gtk/gtktextbufferrichtext.c
@@ -66,8 +66,8 @@ static GQuark deserialize_quark (void);
* This function registers a rich text serialization @function along with
* its @mime_type with the passed @buffer.
*
- * Return value: the #GdkAtom that corresponds to the newly registered
- * format's mime-type.
+ * Return value: (transfer none): the #GdkAtom that corresponds to the
+ * newly registered format's mime-type.
*
* Since: 2.10
**/
@@ -123,8 +123,8 @@ gtk_text_buffer_register_serialize_format (GtkTextBuffer *buffer,
* identifier != %NULL here, since the %NULL tagset requires the
* receiving buffer to deal with with pasting of arbitrary tags.
*
- * Return value: the #GdkAtom that corresponds to the newly registered
- * format's mime-type.
+ * Return value: (transfer none): the #GdkAtom that corresponds to the
+ * newly registered format's mime-type.
*
* Since: 2.10
**/
@@ -164,8 +164,8 @@ gtk_text_buffer_register_serialize_tagset (GtkTextBuffer *buffer,
* This function registers a rich text deserialization @function along with
* its @mime_type with the passed @buffer.
*
- * Return value: the #GdkAtom that corresponds to the newly registered
- * format's mime-type.
+ * Return value: (transfer none): the #GdkAtom that corresponds to the
+ * newly registered format's mime-type.
*
* Since: 2.10
**/
@@ -207,8 +207,8 @@ gtk_text_buffer_register_deserialize_format (GtkTextBuffer *buffe
* format with the passed @buffer. See
* gtk_text_buffer_register_serialize_tagset() for details.
*
- * Return value: the #GdkAtom that corresponds to the newly registered
- * format's mime-type.
+ * Return value: (transfer none): the #GdkAtom that corresponds to the
+ * newly registered format's mime-type.
*
* Since: 2.10
**/
diff --git a/gtk/gtkthemingengine.c b/gtk/gtkthemingengine.c
index 417fc47..4f8c838 100644
--- a/gtk/gtkthemingengine.c
+++ b/gtk/gtkthemingengine.c
@@ -881,8 +881,9 @@ gtk_theming_engine_get_margin (GtkThemingEngine *engine,
*
* Returns the font description for a given state.
*
- * Returns: the #PangoFontDescription for the given state. This
- * object is owned by GTK+ and should not be freed.
+ * Returns: (transfer none): the #PangoFontDescription for the given
+ * state. This object is owned by GTK+ and should not be
+ * freed.
*
* Since: 3.0
**/
@@ -1029,7 +1030,7 @@ gtk_theming_engine_load (const gchar *name)
*
* Returns the #GdkScreen to which @engine currently rendering to.
*
- * Returns: a #GdkScreen, or %NULL.
+ * Returns: (transfer none): a #GdkScreen, or %NULL.
**/
GdkScreen *
gtk_theming_engine_get_screen (GtkThemingEngine *engine)
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index cd408cc..90c0ad9 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -11515,8 +11515,8 @@ gtk_widget_class_install_style_property (GtkWidgetClass *klass,
* gtk_widget_class_find_style_property:
* @klass: a #GtkWidgetClass
* @property_name: the name of the style property to find
- * @returns: (allow-none): the #GParamSpec of the style property or %NULL if @class has no
- * style property with that name.
+ * @returns: (transfer none): the #GParamSpec of the style property or
+ * %NULL if @class has no style property with that name.
*
* Finds a style property of a widget class by name.
*
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index a5840a2..167dcd7 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -2598,7 +2598,7 @@ gtk_window_get_opacity (GtkWindow *window)
*
* Gets the #GtkApplication associated with the window (if any).
*
- * Return value: a #GtkApplication, or %NULL
+ * Return value: (transfer none): a #GtkApplication, or %NULL
*
* Since: 3.0
**/
@@ -8416,7 +8416,7 @@ gtk_window_has_group (GtkWindow *window)
* Gets the current grab widget of the given group,
* see gtk_grab_add().
*
- * Returns: the current grab widget of the group
+ * Returns: (transfer none): the current grab widget of the group
*
* Since: 2.22
*/
@@ -8515,7 +8515,7 @@ _gtk_window_group_remove_device_grab (GtkWindowGroup *window_group,
*
* Returns the current grab widget for @device, or %NULL if none.
*
- * Returns: The grab widget, or %NULL
+ * Returns: (transfer none): The grab widget, or %NULL
*
* Since: 3.0
*/
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
