diff options
45 files changed, 126 insertions, 113 deletions
diff --git a/gdk/gdkcursor.c b/gdk/gdkcursor.c index 1418b1bd0a..f9a5a6e2ee 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 fa2e645467..0cbf3879be 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 79ed85aebd..160404d75c 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 bb2e6a854e..fd54a8a71b 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 43fc086077..5fa240fe9d 100644 --- a/gdk/gdkevents.c +++ b/gdk/gdkevents.c @@ -1165,7 +1165,7 @@ gdk_event_set_source_device (GdkEvent *event, * If the event does not contain a 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 fa1518f0d7..b3c53afca9 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 aa9fb3c3d4..0ea4d40a60 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 e406bb83e3..b3d77cb3a8 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 eb394f6fc2..7d80a12ac7 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 414355e971..8da802fd81 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 f575c54a30..a0360055e4 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. @@ -851,7 +851,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 002a352a3d..45a93a0ccf 100644 --- a/gtk/gtkaction.c +++ b/gtk/gtkaction.c @@ -1706,8 +1706,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 733c9b1060..21820b7c1e 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 8976c2225d..39a4ebcf04 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 ca1ac3a0d8..d085494289 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 d531bbae10..d6d1877330 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 933172ba9c..4131f13529 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 7b428e4e46..a890a46813 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 7fff5474bd..5f4ba06642 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 ae6980f090..79077b8d91 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 0a125adacc..929983001a 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 172b5766c0..f210cab85e 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 e94518d29c..a237602f4b 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 2522102b10..adb1cc6b3c 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 ed1190d62c..0a4e141258 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 c512869467..9cd0298f46 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 4d5112b038..0a416d69e2 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 010669303c..062beaf19c 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 d3a8a37513..e220e590b9 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 456a6ab7e0..15eadf1c38 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 d4d1211759..d555c1b865 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 75fa843348..476f37ba1e 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, @@ -461,7 +461,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 2dc8a50d02..5ed4cb1994 100644 --- a/gtk/gtkrc.c +++ b/gtk/gtkrc.c @@ -752,9 +752,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 ccdea45310..4c4f70a376 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 9665a9848b..1970bc855a 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 9fd3bfbe6f..7d9e5ef6b4 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 4af7a2aa63..1ca794be7b 100644 --- a/gtk/gtkstylecontext.c +++ b/gtk/gtkstylecontext.c @@ -2638,7 +2638,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) @@ -3571,8 +3571,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 99cbf73e8f..c22da446f7 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 5cd63e4f06..d43808f1aa 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 76fcc772e1..e1fe5e79ac 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 050ac9bcff..3a4535777b 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 8db902f673..74a934fd35 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 5d406c2b0c..c99e1d4355 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 cd408cc7b9..90c0ad9cbb 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 45a11fb177..48b776cd69 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 */ |