Commit 2f0d4033 authored by Pavel Holejsovsky's avatar Pavel Holejsovsky

[GI] Add missing (transfer) annotations

parent 9b88eb35
...@@ -150,7 +150,7 @@ gdk_cursor_init (GdkCursor *cursor) ...@@ -150,7 +150,7 @@ gdk_cursor_init (GdkCursor *cursor)
* *
* Adds a reference to @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 * Deprecated: 3.0: Use g_object_ref() instead
*/ */
......
...@@ -1756,7 +1756,7 @@ gdk_display_real_get_app_launch_context (GdkDisplay *display) ...@@ -1756,7 +1756,7 @@ gdk_display_real_get_app_launch_context (GdkDisplay *display)
* Returns a #GdkAppLaunchContext suitable for launching * Returns a #GdkAppLaunchContext suitable for launching
* applications on the given display. * 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 * Free with g_object_unref() when done
* *
* Since: 3.0 * Since: 3.0
......
...@@ -335,7 +335,7 @@ gdk_display_manager_open_display (GdkDisplayManager *manager, ...@@ -335,7 +335,7 @@ gdk_display_manager_open_display (GdkDisplayManager *manager,
* *
* Finds or creates an atom corresponding to a given string. * 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 GdkAtom
gdk_atom_intern (const gchar *atom_name, gdk_atom_intern (const gchar *atom_name,
...@@ -361,7 +361,7 @@ 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 * ever unload the module again (e.g. do not use this function in
* GTK+ theme engines). * GTK+ theme engines).
* *
* Returns: the atom corresponding to @atom_name * Returns: (transfer none): the atom corresponding to @atom_name
* *
* Since: 2.10 * Since: 2.10
*/ */
......
...@@ -445,7 +445,7 @@ gdk_drag_drop_succeeded (GdkDragContext *context) ...@@ -445,7 +445,7 @@ gdk_drag_drop_succeeded (GdkDragContext *context)
* *
* Returns the selection atom for the current source window. * 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 GdkAtom
gdk_drag_get_selection (GdkDragContext *context) gdk_drag_get_selection (GdkDragContext *context)
......
...@@ -1165,7 +1165,7 @@ gdk_event_set_source_device (GdkEvent *event, ...@@ -1165,7 +1165,7 @@ gdk_event_set_source_device (GdkEvent *event,
* If the event does not contain a device field, this function will * If the event does not contain a device field, this function will
* return %NULL. * return %NULL.
* *
* Returns: a #GdkDevice, or %NULL * Returns: (transfer none): a #GdkDevice, or %NULL.
* *
* Since: 3.0 * Since: 3.0
**/ **/
......
...@@ -334,7 +334,7 @@ gdk_offscreen_window_get_device_state (GdkWindow *window, ...@@ -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 * If you need to keep this around over window resizes, you need to
* add a reference to it. * 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 * cairo_surface_t *
gdk_offscreen_window_get_surface (GdkWindow *window) gdk_offscreen_window_get_surface (GdkWindow *window)
......
...@@ -384,7 +384,8 @@ gdk_window_class_init (GdkWindowClass *klass) ...@@ -384,7 +384,8 @@ gdk_window_class_init (GdkWindowClass *klass)
* The ::pick-embedded-child signal is emitted to find an embedded * The ::pick-embedded-child signal is emitted to find an embedded
* child at the given position. * 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 * Since: 2.18
*/ */
...@@ -6584,8 +6585,8 @@ gdk_window_set_background_pattern (GdkWindow *window, ...@@ -6584,8 +6585,8 @@ gdk_window_set_background_pattern (GdkWindow *window,
* does not have its own background and reuses the parent's, %NULL is * does not have its own background and reuses the parent's, %NULL is
* returned and you'll have to query it yourself. * returned and you'll have to query it yourself.
* *
* Returns: The pattern to use for the background or %NULL to use the * Returns: (transfer none): The pattern to use for the background or
* parent's background. * %NULL to use the parent's background.
* *
* Since: 2.22 * Since: 2.22
**/ **/
...@@ -6622,9 +6623,10 @@ update_cursor_foreach (GdkDisplay *display, ...@@ -6622,9 +6623,10 @@ update_cursor_foreach (GdkDisplay *display,
* there is no custom cursor set on the specified window, and it is * there is no custom cursor set on the specified window, and it is
* using the cursor for its parent window. * using the cursor for its parent window.
* *
* Return value: a #GdkCursor, or %NULL. The returned object is owned * Return value: (transfer none): a #GdkCursor, or %NULL. The returned
* by the #GdkWindow and should not be unreferenced directly. Use * object is owned by the #GdkWindow and should not be unreferenced
* gdk_window_set_cursor() to unset the cursor of the window * directly. Use gdk_window_set_cursor() to unset the cursor of the
* window
* *
* Since: 2.18 * Since: 2.18
*/ */
...@@ -6686,9 +6688,10 @@ gdk_window_set_cursor (GdkWindow *window, ...@@ -6686,9 +6688,10 @@ gdk_window_set_cursor (GdkWindow *window,
* there is no custom cursor set on the specified window, and it is * there is no custom cursor set on the specified window, and it is
* using the cursor for its parent window. * using the cursor for its parent window.
* *
* Returns: a #GdkCursor, or %NULL. The returned object is owned * Returns: (transfer none): a #GdkCursor, or %NULL. The returned
* by the #GdkWindow and should not be unreferenced directly. Use * object is owned by the #GdkWindow and should not be unreferenced
* gdk_window_set_cursor() to unset the cursor of the window * directly. Use gdk_window_set_cursor() to unset the cursor of the
* window
* *
* Since: 3.0 * Since: 3.0
**/ **/
......
...@@ -1854,7 +1854,8 @@ gdk_x11_lookup_xdisplay (Display *xdisplay) ...@@ -1854,7 +1854,8 @@ gdk_x11_lookup_xdisplay (Display *xdisplay)
* Given the root window ID of one of the screen's of a #GdkDisplay, * Given the root window ID of one of the screen's of a #GdkDisplay,
* finds the screen. * finds the screen.
* *
* Return value: the #GdkScreen corresponding to @xrootwin, or %NULL. * Return value: (transfer none): the #GdkScreen corresponding to
* @xrootwin, or %NULL.
**/ **/
GdkScreen * GdkScreen *
_gdk_x11_display_screen_for_xrootwin (GdkDisplay *display, _gdk_x11_display_screen_for_xrootwin (GdkDisplay *display,
......
...@@ -462,8 +462,8 @@ _gdk_x11_screen_list_visuals (GdkScreen *screen) ...@@ -462,8 +462,8 @@ _gdk_x11_screen_list_visuals (GdkScreen *screen)
* *
* Looks up the #GdkVisual for a particular screen and X Visual ID. * Looks up the #GdkVisual for a particular screen and X Visual ID.
* *
* Returns: the #GdkVisual (owned by the screen object), or %NULL * Returns: (transfer none): the #GdkVisual (owned by the screen
* if the visual ID wasn't found. * object), or %NULL if the visual ID wasn't found.
* *
* Since: 2.2 * Since: 2.2
*/ */
......
...@@ -1706,9 +1706,9 @@ gtk_about_dialog_set_translator_credits (GtkAboutDialog *about, ...@@ -1706,9 +1706,9 @@ gtk_about_dialog_set_translator_credits (GtkAboutDialog *about,
* *
* Returns the pixbuf displayed as logo in the about dialog. * Returns the pixbuf displayed as logo in the about dialog.
* *
* Return value: the pixbuf displayed as logo. The pixbuf is * Return value: (transfer none): the pixbuf displayed as logo. The
* owned by the about dialog. If you want to keep a reference * pixbuf is owned by the about dialog. If you want to keep a
* to it, you have to call g_object_ref() on it. * reference to it, you have to call g_object_ref() on it.
* *
* Since: 2.6 * Since: 2.6
*/ */
......
...@@ -378,8 +378,8 @@ gtk_accel_groups_from_object (GObject *object) ...@@ -378,8 +378,8 @@ gtk_accel_groups_from_object (GObject *object)
* @find_func: (scope call): a function to filter the entries * @find_func: (scope call): a function to filter the entries
* of @accel_group with * of @accel_group with
* @data: data to pass to @find_func * @data: data to pass to @find_func
* @returns: the key of the first entry passing @find_func. The key is * @returns: (transfer none): the key of the first entry passing
* owned by GTK+ and must not be freed. * @find_func. The key is owned by GTK+ and must not be freed.
* *
* Finds the first entry in an accelerator group for which * Finds the first entry in an accelerator group for which
* @find_func returns %TRUE and returns its #GtkAccelKey. * @find_func returns %TRUE and returns its #GtkAccelKey.
...@@ -851,7 +851,8 @@ gtk_accel_group_query (GtkAccelGroup *accel_group, ...@@ -851,7 +851,8 @@ gtk_accel_group_query (GtkAccelGroup *accel_group,
/** /**
* gtk_accel_group_from_accel_closure: * gtk_accel_group_from_accel_closure:
* @closure: a #GClosure * @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; * Finds the #GtkAccelGroup to which @closure is connected;
* see gtk_accel_group_connect(). * see gtk_accel_group_connect().
......
...@@ -1706,8 +1706,9 @@ gtk_action_get_accel_path (GtkAction *action) ...@@ -1706,8 +1706,9 @@ gtk_action_get_accel_path (GtkAction *action)
* *
* Since: 2.8 * Since: 2.8
* *
* Returns: the accel closure for this action. The returned closure is * Returns: (transfer none): the accel closure for this action. The
* owned by GTK+ and must not be unreffed or modified. * returned closure is owned by GTK+ and must not be unreffed
* or modified.
*/ */
GClosure * GClosure *
gtk_action_get_accel_closure (GtkAction *action) gtk_action_get_accel_closure (GtkAction *action)
......
...@@ -650,7 +650,7 @@ gtk_binding_set_by_class (gpointer object_class) ...@@ -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 * either be a name used for gtk_binding_set_new() or the type name of
* a class used in gtk_binding_set_by_class(). * 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* GtkBindingSet*
gtk_binding_set_find (const gchar *set_name) gtk_binding_set_find (const gchar *set_name)
......
...@@ -1907,7 +1907,7 @@ get_cell_by_position (GtkCellRenderer *renderer, ...@@ -1907,7 +1907,7 @@ get_cell_by_position (GtkCellRenderer *renderer,
* Gets the #GtkCellRenderer at @x and @y coordinates inside @area and optionally * Gets the #GtkCellRenderer at @x and @y coordinates inside @area and optionally
* returns the full cell allocation for it inside @cell_area. * 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 * Since: 3.0
*/ */
...@@ -2433,8 +2433,8 @@ gtk_cell_area_class_install_cell_property (GtkCellAreaClass *aclass, ...@@ -2433,8 +2433,8 @@ gtk_cell_area_class_install_cell_property (GtkCellAreaClass *aclass,
* *
* Finds a cell property of a cell area class by name. * 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 * Return value: (transfer none): the #GParamSpec of the child property
* child property with that name. * or %NULL if @aclass has no child property with that name.
* *
* Since: 3.0 * Since: 3.0
*/ */
...@@ -2993,7 +2993,7 @@ gtk_cell_area_set_focus_cell (GtkCellArea *area, ...@@ -2993,7 +2993,7 @@ gtk_cell_area_set_focus_cell (GtkCellArea *area,
* *
* Retrieves the currently focused cell for @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 * Since: 3.0
*/ */
...@@ -3177,7 +3177,8 @@ gtk_cell_area_get_focus_siblings (GtkCellArea *area, ...@@ -3177,7 +3177,8 @@ gtk_cell_area_get_focus_siblings (GtkCellArea *area,
* then chose to activate the focus cell for which the event * then chose to activate the focus cell for which the event
* cell may have been a sibling. * 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 * Since: 3.0
*/ */
...@@ -3320,7 +3321,7 @@ gtk_cell_area_set_edit_widget (GtkCellArea *area, ...@@ -3320,7 +3321,7 @@ gtk_cell_area_set_edit_widget (GtkCellArea *area,
* Gets the #GtkCellRenderer in @area that is currently * Gets the #GtkCellRenderer in @area that is currently
* being edited. * being edited.
* *
* Return value: The currently edited #GtkCellRenderer * Return value: (transfer none): The currently edited #GtkCellRenderer
* *
* Since: 3.0 * Since: 3.0
*/ */
...@@ -3343,7 +3344,7 @@ gtk_cell_area_get_edited_cell (GtkCellArea *area) ...@@ -3343,7 +3344,7 @@ gtk_cell_area_get_edited_cell (GtkCellArea *area)
* Gets the #GtkCellEditable widget currently used * Gets the #GtkCellEditable widget currently used
* to edit the currently edited cell. * 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 * Since: 3.0
*/ */
......
...@@ -348,7 +348,7 @@ gtk_cell_area_context_real_allocate (GtkCellAreaContext *context, ...@@ -348,7 +348,7 @@ gtk_cell_area_context_real_allocate (GtkCellAreaContext *context,
* that the #GtkCellArea is configured with in order to * that the #GtkCellArea is configured with in order to
* compute a proper allocation. * 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 * Since: 3.0
*/ */
......
...@@ -1196,10 +1196,10 @@ gtk_container_class_install_child_property (GtkContainerClass *cclass, ...@@ -1196,10 +1196,10 @@ gtk_container_class_install_child_property (GtkContainerClass *cclass,
/** /**
* gtk_container_class_find_child_property: * gtk_container_class_find_child_property:
* @cclass: a #GtkContainerClass * @cclass: (type GtkContainerClass): a #GtkContainerClass
* @property_name: the name of the child property to find * @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 * @returns: (transfer none): the #GParamSpec of the child property or
* child property with that name. * %NULL if @class has no child property with that name.
* *
* Finds a child property of a container class by name. * Finds a child property of a container class by name.
*/ */
...@@ -1951,8 +1951,9 @@ gtk_container_set_focus_child (GtkContainer *container, ...@@ -1951,8 +1951,9 @@ gtk_container_set_focus_child (GtkContainer *container,
* currently focused widget. That can be obtained by calling * currently focused widget. That can be obtained by calling
* gtk_window_get_focus(). * gtk_window_get_focus().
* *
* Returns: The child widget which will recieve the focus inside @container when * Returns: (transfer none): The child widget which will receive the
* the @conatiner is focussed, or %NULL if none is set. * focus inside @container when the @conatiner is focussed,
* or %NULL if none is set.
* *
* Since: 2.14 * Since: 2.14
**/ **/
......
...@@ -1355,7 +1355,7 @@ gtk_drag_dest_unset (GtkWidget *widget) ...@@ -1355,7 +1355,7 @@ gtk_drag_dest_unset (GtkWidget *widget)
* Returns the list of targets this widget can accept from * Returns the list of targets this widget can accept from
* drag-and-drop. * drag-and-drop.
* *
* Return value: the #GtkTargetList, or %NULL if none * Return value: (transfer none): the #GtkTargetList, or %NULL if none
**/ **/
GtkTargetList* GtkTargetList*
gtk_drag_dest_get_target_list (GtkWidget *widget) gtk_drag_dest_get_target_list (GtkWidget *widget)
...@@ -1666,8 +1666,8 @@ _gtk_drag_dest_handle_event (GtkWidget *toplevel, ...@@ -1666,8 +1666,8 @@ _gtk_drag_dest_handle_event (GtkWidget *toplevel,
* that case, they will have to implement a drag_motion handler that * that case, they will have to implement a drag_motion handler that
* passes the correct target list to this function. * passes the correct target list to this function.
* *
* Return value: first target that the source offers and the dest can * Return value: (transfer none): first target that the source offers
* accept, or %GDK_NONE * and the dest can accept, or %GDK_NONE
**/ **/
GdkAtom GdkAtom
gtk_drag_dest_find_target (GtkWidget *widget, gtk_drag_dest_find_target (GtkWidget *widget,
...@@ -2544,7 +2544,7 @@ gtk_drag_begin_internal (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). * (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. * 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 * GdkDragContext *
gtk_drag_begin (GtkWidget *widget, gtk_drag_begin (GtkWidget *widget,
...@@ -2657,7 +2657,7 @@ gtk_drag_source_unset (GtkWidget *widget) ...@@ -2657,7 +2657,7 @@ gtk_drag_source_unset (GtkWidget *widget)
* Gets the list of targets this widget can provide for * Gets the list of targets this widget can provide for
* drag-and-drop. * drag-and-drop.
* *
* Return value: the #GtkTargetList, or %NULL if none * Return value: (transfer none): the #GtkTargetList, or %NULL if none
* *
* Since: 2.4 * Since: 2.4
**/ **/
......
...@@ -251,7 +251,7 @@ gtk_icon_factory_add (GtkIconFactory *factory, ...@@ -251,7 +251,7 @@ gtk_icon_factory_add (GtkIconFactory *factory,
* widget that will display the icon, instead of using this * widget that will display the icon, instead of using this
* function directly, so that themes are taken into account. * 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 * GtkIconSet *
gtk_icon_factory_lookup (GtkIconFactory *factory, gtk_icon_factory_lookup (GtkIconFactory *factory,
...@@ -330,7 +330,7 @@ _gtk_icon_factory_ensure_default_icons (void) ...@@ -330,7 +330,7 @@ _gtk_icon_factory_ensure_default_icons (void)
* using this function directly, so that themes are taken into * using this function directly, so that themes are taken into
* account. * account.
* *
* Return value: a #GtkIconSet, or %NULL * Return value: (transfer none): a #GtkIconSet, or %NULL
*/ */
GtkIconSet * GtkIconSet *
gtk_icon_factory_lookup_default (const gchar *stock_id) gtk_icon_factory_lookup_default (const gchar *stock_id)
......
...@@ -2036,7 +2036,8 @@ gtk_label_set_attributes (GtkLabel *label, ...@@ -2036,7 +2036,8 @@ gtk_label_set_attributes (GtkLabel *label,
* effective attributes for the label, use * effective attributes for the label, use
* pango_layout_get_attribute (gtk_label_get_layout (label)). * 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 * PangoAttrList *
gtk_label_get_attributes (GtkLabel *label) gtk_label_get_attributes (GtkLabel *label)
......
...@@ -2384,9 +2384,9 @@ gtk_invoke_key_snoopers (GtkWidget *grab_widget, ...@@ -2384,9 +2384,9 @@ gtk_invoke_key_snoopers (GtkWidget *grab_widget,
* the current event will be the #GdkEventButton that triggered * the current event will be the #GdkEventButton that triggered
* the ::clicked signal. * the ::clicked signal.
* *
* Return value: a copy of the current event, or %NULL if there is * Return value: (transfer full): a copy of the current event, or
* no current event. The returned event must be freed with * %NULL if there is no current event. The returned event must be
* gdk_event_free(). * freed with gdk_event_free().
*/ */
GdkEvent* GdkEvent*
gtk_get_current_event (void) gtk_get_current_event (void)
......
...@@ -1251,7 +1251,7 @@ gtk_menu_attach_to_widget (GtkMenu *menu, ...@@ -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: the #GtkWidget that the menu is attached to * Returns: (transfer none): the #GtkWidget that the menu is attached to
*/ */
GtkWidget* GtkWidget*
gtk_menu_get_attach_widget (GtkMenu *menu) gtk_menu_get_attach_widget (GtkMenu *menu)
...@@ -1889,9 +1889,9 @@ gtk_menu_popdown (GtkMenu *menu) ...@@ -1889,9 +1889,9 @@ gtk_menu_popdown (GtkMenu *menu)
* Returns the selected menu item from the menu. This is used by the * Returns the selected menu item from the menu. This is used by the
* #GtkOptionMenu. * #GtkOptionMenu.
* *
* Returns: the #GtkMenuItem that was last selected in the menu. If a * Returns: (transfer none): the #GtkMenuItem that was last selected
* selection has not yet been made, the first menu item is * in the menu. If a selection has not yet been made, the
* selected. * first menu item is selected.
*/ */
GtkWidget* GtkWidget*
gtk_menu_get_active (GtkMenu *menu) gtk_menu_get_active (GtkMenu *menu)
...@@ -1995,7 +1995,7 @@ gtk_menu_set_accel_group (GtkMenu *menu, ...@@ -1995,7 +1995,7 @@ gtk_menu_set_accel_group (GtkMenu *menu,
* Gets the #GtkAccelGroup which holds global accelerators for the * Gets the #GtkAccelGroup which holds global accelerators for the
* menu. See gtk_menu_set_accel_group(). * menu. See gtk_menu_set_accel_group().
* *
* Returns: the #GtkAccelGroup associated with the menu. * Returns: (transfer none): the #GtkAccelGroup associated with the menu.
*/ */
GtkAccelGroup* GtkAccelGroup*
gtk_menu_get_accel_group (GtkMenu *menu) gtk_menu_get_accel_group (GtkMenu *menu)
......
...@@ -1990,7 +1990,7 @@ gtk_menu_shell_set_take_focus (GtkMenuShell *menu_shell, ...@@ -1990,7 +1990,7 @@ gtk_menu_shell_set_take_focus (GtkMenuShell *menu_shell,
* *
* Gets the currently selected item. * Gets the currently selected item.
* *
* Returns: the currently selected item * Returns: (transfer none): the currently selected item
* *
* Since: 3.0 * Since: 3.0
*/ */
...@@ -2011,7 +2011,7 @@ gtk_menu_shell_get_selected_item (GtkMenuShell *menu_shell) ...@@ -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 * The parent menu shell of a submenu is the #GtkMenu or #GtkMenuBar
* from which it was opened up. * from which it was opened up.
* *
* Returns: the parent #GtkMenuShell * Returns: (transfer none): the parent #GtkMenuShell
* *
* Since: 3.0 * Since: 3.0
*/ */
......
...@@ -1047,7 +1047,8 @@ gtk_notebook_class_init (GtkNotebookClass *class) ...@@ -1047,7 +1047,8 @@ gtk_notebook_class_init (GtkNotebookClass *class)
* necessary properties to the notebook (e.g. the * necessary properties to the notebook (e.g. the
* #GtkNotebook:group ). * #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 * Since: 2.12
*/ */
......
...@@ -1008,7 +1008,7 @@ gtk_numerable_icon_get_background_icon_name (GtkNumerableIcon *self) ...@@ -1008,7 +1008,7 @@ gtk_numerable_icon_get_background_icon_name (GtkNumerableIcon *self)
* *
* Creates a new unthemed #GtkNumerableIcon. * Creates a new unthemed #GtkNumerableIcon.
* *
* Returns: a new #GIcon * Returns: (transfer full): a new #GIcon
* *
* Since: 3.0 * Since: 3.0
*/ */
...@@ -1031,7 +1031,7 @@ gtk_numerable_icon_new (GIcon *base_icon) ...@@ -1031,7 +1031,7 @@ gtk_numerable_icon_new (GIcon *base_icon)
* to the passed #GtkStyleContext. This is a convenience constructor * to the passed #GtkStyleContext. This is a convenience constructor
* that calls gtk_numerable_icon_set_style_context() internally. * that calls gtk_numerable_icon_set_style_context() internally.
* *
* Returns: a new #GIcon * Returns: (transfer full): a new #GIcon
* *
* Since: 3.0 * Since: 3.0
*/ */
......
...@@ -1099,7 +1099,7 @@ gtk_page_setup_unix_dialog_set_page_setup (GtkPageSetupUnixDialog *dialog, ...@@ -1099,7 +1099,7 @@ gtk_page_setup_unix_dialog_set_page_setup (GtkPageSetupUnixDialog *dialog,
* *
* Gets the currently selected page setup from the 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 * Since: 2.10
**/ **/
...@@ -1196,7 +1196,7 @@ gtk_page_setup_unix_dialog_set_print_settings (GtkPageSetupUnixDialog *dialog, ...@@ -1196,7 +1196,7 @@ gtk_page_setup_unix_dialog_set_print_settings (GtkPageSetupUnixDialog *dialog,
* *
* Gets the current print settings from the dialog. * Gets the current print settings from the dialog.
* *
* Returns: the current print settings * Returns: (transfer none): the current print settings
* *
* Since: 2.10 * Since: 2.10
**/ **/
......
...@@ -253,7 +253,7 @@ _gtk_print_context_set_page_setup (GtkPrintContext *context, ...@@ -253,7 +253,7 @@ _gtk_print_context_set_page_setup (GtkPrintContext *context,
* Obtains the cairo context that is associated with the * Obtains the cairo context that is associated with the
* #GtkPrintContext. * #GtkPrintContext.
* *
* Return value: the cairo context of @context * Return value: (transfer none): the cairo context of @context
* *
* Since: 2.10 * Since: 2.10
*/ */
......
...@@ -414,7 +414,7 @@ gtk_printer_new (const gchar *name, ...@@ -414,7 +414,7 @@ gtk_printer_new (const gchar *name,
* *
* Returns the backend of the printer. * Returns the backend of the printer.
* *
* Return value: the backend of @printer * Return value: (transfer none): the backend of @printer
* *
* Since: 2.10 * Since: 2.10
*/ */
......
...@@ -336,7 +336,7 @@ gtk_print_job_new (const gchar *title, ...@@ -336,7 +336,7 @@ gtk_print_job_new (const gchar *title,
* *
* Gets the #GtkPrintSettings of the print job. * Gets the #GtkPrintSettings of the print job.
* *
* Return value: the settings of @job * Return value: (transfer none): the settings of @job
* *
* Since: 2.10 * Since: 2.10
*/ */
...@@ -354,7 +354,7 @@ gtk_print_job_get_settings (GtkPrintJob *job) ...@@ -354,7 +354,7 @@ gtk_print_job_get_settings (GtkPrintJob *job)
* *
* Gets the #GtkPrinter of the print 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 * Since: 2.10
*/ */
...@@ -471,7 +471,7 @@ gtk_print_job_set_source_file (GtkPrintJob *job, ...@@ -471,7 +471,7 @@ gtk_print_job_set_source_file (GtkPrintJob *job,
* Gets a cairo surface onto which the pages of * Gets a cairo surface onto which the pages of
* the print job should be rendered. * 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 * Since: 2.10
**/ **/
......
...@@ -964,7 +964,7 @@ get_page_setup_dialog (GtkWindow *parent, ...@@ -964,7 +964,7 @@ get_page_setup_dialog (GtkWindow *parent,
* setup dialog. See gtk_print_run_page_setup_dialog_async() if this is * setup dialog. See gtk_print_run_page_setup_dialog_async() if this is
* a problem. * a problem.
* *
* Return value: a new #GtkPageSetup * Return value: (transfer full): a new #GtkPageSetup
* *
* Since: 2.10 * Since: 2.10
*/ */
......
...@@ -892,8 +892,8 @@ gtk_print_operation_class_init (GtkPrintOperationClass *class) ...@@ -892,8 +892,8 @@ gtk_print_operation_class_init (GtkPrintOperationClass *class)
* signal is emitted on the operation. Then you can read out any * signal is emitted on the operation. Then you can read out any
* information you need from the widgets. * information you need from the widgets.
* *
* Returns: A custom widget that gets embedded in the print dialog, * Returns: (transfer none): A custom widget that gets embedded in
* or %NULL * the print dialog, or %NULL
* *