diff --git a/gdk/gdk.c b/gdk/gdk.c index f0ff4336eb..003ad34847 100644 --- a/gdk/gdk.c +++ b/gdk/gdk.c @@ -316,8 +316,8 @@ gdk_get_display_arg_name (void) * display has previously been set, simply returns that. An internal * function that should not be used by applications. * - * Return value: the default display, if it could be opened, - * otherwise %NULL. + * Return value: (transfer none): the default display, if it could be + * opened, otherwise %NULL. **/ GdkDisplay * gdk_display_open_default_libgtk_only (void) diff --git a/gdk/gdkdevice.c b/gdk/gdkdevice.c index c8e37795f0..afe8b94ce7 100644 --- a/gdk/gdkdevice.c +++ b/gdk/gdkdevice.c @@ -745,8 +745,8 @@ gdk_device_set_axis_use (GdkDevice *device, * * Returns the #GdkDisplay to which @device pertains. * - * Returns: a #GdkDisplay. This memory is owned by GTK+, - * and must not be freed or unreffed. + * Returns: (transfer none): a #GdkDisplay. This memory is owned + * by GTK+, and must not be freed or unreffed. * * Since: 3.0 **/ @@ -776,7 +776,7 @@ gdk_device_get_display (GdkDevice *device) * If @device is of type %GDK_DEVICE_TYPE_FLOATING, %NULL will be * returned, as there is no associated device. * - * Returns: The associated device, or %NULL + * Returns: (transfer none): The associated device, or %NULL * * Since: 3.0 **/ diff --git a/gdk/gdkdevicemanager.c b/gdk/gdkdevicemanager.c index 2edaa28705..56499bcb64 100644 --- a/gdk/gdkdevicemanager.c +++ b/gdk/gdkdevicemanager.c @@ -260,8 +260,9 @@ gdk_device_manager_get_property (GObject *object, * * Gets the #GdkDisplay associated to @device_manager. * - * Returns: the #GdkDisplay to which @device_manager is - * associated to, or #NULL. + * Returns: (transfer none): the #GdkDisplay to which @device_manager is + * associated to, or #NULL. This memory is owned by GDK and + * must not be freed or unreferenced. * * Since: 3.0 **/ @@ -312,7 +313,8 @@ gdk_device_manager_list_devices (GdkDeviceManager *device_manager, * You should use this function sheldomly, only in code that isn't triggered by a #GdkEvent * and there aren't other means to get a meaningful #GdkDevice to operate on. * - * Returns: The client pointer. + * Returns: (transfer none): The client pointer. This memory is + * owned by GDK and must not be freed or unreferenced. * * Since: 3.0 **/ diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c index 69d8c6a501..564d4b5ca5 100644 --- a/gdk/gdkdisplay.c +++ b/gdk/gdkdisplay.c @@ -654,8 +654,8 @@ gdk_event_send_clientmessage_toall (GdkEvent *event) * * Returns the core pointer device for the default display. * - * Return value: the core pointer device; this is owned by the - * display and should not be freed. + * Return value: (transfer none): the core pointer device; this is owned + * by the display and should not be freed. * * Deprecated: 3.0: Use gdk_device_manager_get_client_pointer() instead, or * gdk_event_get_device() if a #GdkEvent with pointer device @@ -673,7 +673,7 @@ gdk_device_get_core_pointer (void) * * Returns the core pointer device for the given display * - * Return value: the core pointer device; this is owned by the + * Return value: (transfer none): the core pointer device; this is owned by the * display and should not be freed. * * Since: 2.2 @@ -810,7 +810,7 @@ gdk_display_get_device_state (GdkDisplay *display, * Obtains the window underneath @device, returning the location of the device in @win_x and @win_y. Returns * %NULL if the window tree under @device is not known to GDK (for example, belongs to another application). * - * Returns: the #GdkWindow under the device position, or %NULL. + * Returns: (transfer none): the #GdkWindow under the device position, or %NULL. * * Since: 3.0 **/ @@ -846,7 +846,7 @@ gdk_display_get_window_at_device_position (GdkDisplay *display, * #GdkDevice on a particular #GdkDisplay. This is only useful for such low-level tools as * an event recorder. Applications should never have any reason to use this facility. * - * Returns: The previous device hook table. + * Returns: (transfer none): The previous device hook table. * * Since: 3.0 **/ @@ -1067,7 +1067,7 @@ multihead_default_window_at_pointer (GdkDisplay *display, * event recorder. Applications should never have any * reason to use this facility. * - * Return value: the previous pointer hook table + * Return value: (transfer none): the previous pointer hook table * * Since: 2.2 * @@ -1853,7 +1853,7 @@ gdk_display_device_is_grabbed (GdkDisplay *display, * * Returns the #GdkDeviceManager associated to @display. * - * Returns: A #GdkDeviceManager, or %NULL. This memory is + * Returns: (transfer none): A #GdkDeviceManager, or %NULL. This memory is * owned by GDK and must not be freed or unreferenced. * * Since: 3.0 diff --git a/gdk/gdkevents.c b/gdk/gdkevents.c index 8b402fc84c..d60f3b16f9 100644 --- a/gdk/gdkevents.c +++ b/gdk/gdkevents.c @@ -1277,7 +1277,7 @@ gdk_event_set_screen (GdkEvent *event, * to which event->motion.x_root and * event->motion.y_root are relative. * - * Return value: the screen for the event + * Return value: (transfer none): the screen for the event * * Since: 2.2 **/ diff --git a/gdk/gdkkeys.c b/gdk/gdkkeys.c index e72b8eab98..102b6f08e0 100644 --- a/gdk/gdkkeys.c +++ b/gdk/gdkkeys.c @@ -412,7 +412,7 @@ gdk_keyval_is_lower (guint keyval) * * Returns the #GdkKeymap attached to the default display. * - * Returns: the #GdkKeymap attached to the default display. + * Returns: (transfer none): the #GdkKeymap attached to the default display. */ GdkKeymap* gdk_keymap_get_default (void) diff --git a/gdk/gdkoffscreenwindow.c b/gdk/gdkoffscreenwindow.c index f9be9ad6c9..f7c071b16c 100644 --- a/gdk/gdkoffscreenwindow.c +++ b/gdk/gdkoffscreenwindow.c @@ -703,8 +703,8 @@ gdk_offscreen_window_set_embedder (GdkWindow *window, * * Gets the window that @window is embedded in. * - * Returns: the embedding #GdkWindow, or %NULL if @window is not an - * embedded offscreen window + * Returns: (transfer none): the embedding #GdkWindow, or %NULL + * if @window is not an mbedded offscreen window * * Since: 2.18 */ diff --git a/gdk/gdkpango.c b/gdk/gdkpango.c index e21175bd9a..907b51798b 100644 --- a/gdk/gdkpango.c +++ b/gdk/gdkpango.c @@ -317,7 +317,7 @@ gdk_pango_layout_get_clip_region (PangoLayout *layout, * is more convenient if you want to keep a context around and track * changes to the screen's font rendering settings. * - * Return value: a new #PangoContext for the default display + * Return value: (transfer full): a new #PangoContext for the default display **/ PangoContext * gdk_pango_context_get (void) @@ -343,7 +343,7 @@ gdk_pango_context_get (void) * is more convenient if you want to keep a context around and track * changes to the screen's font rendering settings. * - * Return value: a new #PangoContext for @screen + * Return value: (transfer full): a new #PangoContext for @screen * * Since: 2.2 **/ diff --git a/gdk/gdkselection.c b/gdk/gdkselection.c index 0a4b428e40..9468604fe6 100644 --- a/gdk/gdkselection.c +++ b/gdk/gdkselection.c @@ -97,9 +97,9 @@ gdk_selection_owner_set (GdkWindow *owner, * * Determines the owner of the given selection. * - * Returns: if there is a selection owner for this window, - * and it is a window known to the current process, - * the #GdkWindow that owns the selection, otherwise + * Returns: (transfer none): if there is a selection owner for + * this window, and it is a window known to the current + * process, the #GdkWindow that owns the selection, otherwise * %NULL. Note that the return value may be owned * by a different process if a foreign window * was previously created for that window, but diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c index 62644365d1..dca9df1fd3 100644 --- a/gdk/gdkwindow.c +++ b/gdk/gdkwindow.c @@ -2212,7 +2212,7 @@ gdk_window_get_window_type (GdkWindow *window) * * Gets the #GdkVisual describing the pixel format of @window. * - * Return value: a #GdkVisual + * Return value: (transfer none): a #GdkVisual * * Since: 2.24 **/ @@ -2234,7 +2234,7 @@ gdk_window_get_visual (GdkWindow *window) * * Gets the #GdkScreen associated with a #GdkWindow. * - * Return value: the #GdkScreen associated with @window + * Return value: (transfer none): the #GdkScreen associated with @window * * Since: 2.24 **/ @@ -2256,7 +2256,7 @@ gdk_window_get_screen (GdkWindow *window) * * Gets the #GdkDisplay associated with a #GdkWindow. * - * Return value: the #GdkDisplay associated with @window + * Return value: (transfer none): the #GdkDisplay associated with @window * * Since: 2.24 **/ @@ -5130,7 +5130,7 @@ gdk_window_at_pointer (gint *win_x, * Obtains the root window (parent all other windows are inside) * for the default display and screen. * - * Return value: the default root window + * Return value: (transfer none): the default root window **/ GdkWindow * gdk_get_default_root_window (void) @@ -5148,8 +5148,8 @@ gdk_get_default_root_window (void) * For example in the X backend, a native window handle is an Xlib * XID. * - * Return value: the newly-created #GdkWindow wrapper for the - * native window or %NULL if the window has been destroyed. + * Return value: (transfer full): the newly-created #GdkWindow wrapper + * for the native window, or %NULL if the window has been destroyed. **/ GdkWindow * gdk_window_foreign_new (GdkNativeWindow anid) diff --git a/gdk/x11/gdkcursor-x11.c b/gdk/x11/gdkcursor-x11.c index b01325b232..60380672c2 100644 --- a/gdk/x11/gdkcursor-x11.c +++ b/gdk/x11/gdkcursor-x11.c @@ -362,7 +362,7 @@ gdk_x11_cursor_get_xcursor (GdkCursor *cursor) * * Returns the display on which the #GdkCursor is defined. * - * Returns: the #GdkDisplay associated to @cursor + * Returns: (transfer none): the #GdkDisplay associated to @cursor * * Since: 2.2 */ @@ -387,7 +387,7 @@ gdk_cursor_get_display (GdkCursor *cursor) * on the cursor, GDK may not be able to obtain the image data. In this * case, %NULL is returned. * - * Returns: a #GdkPixbuf representing @cursor, or %NULL + * Returns: (transfer full): a #GdkPixbuf representing @cursor, or %NULL * * Since: 2.8 */ diff --git a/gdk/x11/gdkdisplay-x11.c b/gdk/x11/gdkdisplay-x11.c index 148d167d43..0ced13753b 100644 --- a/gdk/x11/gdkdisplay-x11.c +++ b/gdk/x11/gdkdisplay-x11.c @@ -1187,11 +1187,12 @@ _gdk_input_init (GdkDisplay *display) /** * gdk_display_open: * @display_name: the name of the display to open - * @returns: a #GdkDisplay, or %NULL if the display - * could not be opened. * * Opens a display. * + * Return value: (transfer none): a #GdkDisplay, or %NULL if the display + * could not be opened. + * * Since: 2.2 */ GdkDisplay * @@ -1581,7 +1582,7 @@ gdk_display_get_n_screens (GdkDisplay *display) * * Returns a screen object for one of the screens of the display. * - * Returns: the #GdkScreen object + * Returns: (transfer none): the #GdkScreen object * * Since: 2.2 */ @@ -1601,7 +1602,7 @@ gdk_display_get_screen (GdkDisplay *display, * * Get the default #GdkScreen for @display. * - * Returns: the default #GdkScreen object for @display + * Returns: (transfer none): the default #GdkScreen object for @display * * Since: 2.2 */ @@ -1771,7 +1772,8 @@ gdk_display_flush (GdkDisplay *display) * on @display. This window is implicitly created by GDK. * See gdk_window_set_group(). * - * Return value: The default group leader window for @display + * Return value: (transfer none): The default group leader window + * for @display * * Since: 2.4 **/ @@ -1935,7 +1937,7 @@ gdk_display_x11_finalize (GObject *object) * * Find the #GdkDisplay corresponding to @display, if any exists. * - * Return value: the #GdkDisplay, if found, otherwise %NULL. + * Return value: (transfer none): the #GdkDisplay, if found, otherwise %NULL. * * Since: 2.2 **/ diff --git a/gdk/x11/gdkdnd-x11.c b/gdk/x11/gdkdnd-x11.c index 74e874b078..e4d8cffc91 100644 --- a/gdk/x11/gdkdnd-x11.c +++ b/gdk/x11/gdkdnd-x11.c @@ -257,7 +257,7 @@ gdk_drag_context_set_device (GdkDragContext *context, * * Returns the #GdkDevice associated to the drag context. * - * Returns: The #GdkDevice associated to @context. + * Returns: (transfer none): The #GdkDevice associated to @context. **/ GdkDevice * gdk_drag_context_get_device (GdkDragContext *context) @@ -3162,7 +3162,7 @@ gdk_drag_do_leave (GdkDragContext *context, guint32 time) * * This function is called by the drag source. * - * Return value: a newly created #GdkDragContext. + * Return value: (transfer full): a newly created #GdkDragContext. **/ GdkDragContext * gdk_drag_begin (GdkWindow *window, diff --git a/gdk/x11/gdkkeys-x11.c b/gdk/x11/gdkkeys-x11.c index cb09d1f328..20bb6ee4ef 100644 --- a/gdk/x11/gdkkeys-x11.c +++ b/gdk/x11/gdkkeys-x11.c @@ -289,10 +289,11 @@ get_xkb (GdkKeymapX11 *keymap_x11) /** * gdk_keymap_get_for_display: * @display: the #GdkDisplay. - * @returns: the #GdkKeymap attached to @display. * * Returns the #GdkKeymap attached to @display. * + * Return value: (transfer none): the #GdkKeymap attached to @display. + * * Since: 2.2 **/ GdkKeymap* diff --git a/gdk/x11/gdkscreen-x11.c b/gdk/x11/gdkscreen-x11.c index 8fb9ffc333..90d35dc5d8 100644 --- a/gdk/x11/gdkscreen-x11.c +++ b/gdk/x11/gdkscreen-x11.c @@ -117,7 +117,7 @@ _gdk_screen_x11_init (GdkScreenX11 *screen) * * Gets the display to which the @screen belongs. * - * Returns: the display to which @screen belongs + * Returns: (transfer none): the display to which @screen belongs * * Since: 2.2 **/ @@ -1229,7 +1229,7 @@ gdk_screen_make_display_name (GdkScreen *screen) } /** - * gdk_screen_get_active_window + * gdk_screen_get_active_window: * @screen: a #GdkScreen * * Returns the screen's currently active window. @@ -1247,7 +1247,7 @@ gdk_screen_make_display_name (GdkScreen *screen) * The returned window should be unrefed using g_object_unref() when * no longer needed. * - * Return value: the currently active window, or %NULL. + * Return value: (transfer full): the currently active window, or %NULL. * * Since: 2.10 **/ diff --git a/gdk/x11/gdkselection-x11.c b/gdk/x11/gdkselection-x11.c index 03ec39670e..41be49ed93 100644 --- a/gdk/x11/gdkselection-x11.c +++ b/gdk/x11/gdkselection-x11.c @@ -197,9 +197,9 @@ gdk_selection_owner_set_for_display (GdkDisplay *display, * process if a foreign window was previously created for that * window, but a new foreign window will never be created by this call. * - * Returns: if there is a selection owner for this window, and it is a - * window known to the current process, the #GdkWindow that owns the - * selection, otherwise %NULL. + * Returns: (transfer none): if there is a selection owner for this window, + * and it is a window known to the current process, the #GdkWindow that + * owns the selection, otherwise %NULL. * * Since: 2.2 */ diff --git a/gdk/x11/gdkwindow-x11.c b/gdk/x11/gdkwindow-x11.c index b369e2c63e..ec9071077e 100644 --- a/gdk/x11/gdkwindow-x11.c +++ b/gdk/x11/gdkwindow-x11.c @@ -841,9 +841,9 @@ x_event_mask_to_gdk_event_mask (long mask) * For example in the X backend, a native window handle is an Xlib * XID. * - * Return value: a #GdkWindow wrapper for the native window or - * %NULL if the window has been destroyed. The wrapper will be - * newly created, if one doesn't exist already. + * Return value: (transfer full): a #GdkWindow wrapper for the native + * window, or %NULL if the window has been destroyed. The wrapper + * will be newly created, if one doesn't exist already. * * Since: 2.2 **/ @@ -945,8 +945,8 @@ gdk_window_foreign_new_for_display (GdkDisplay *display, * For example in the X backend, a native window handle is an Xlib * XID. * - * Return value: the #GdkWindow wrapper for the native window, - * or %NULL if there is none. + * Return value: (transfer none): the #GdkWindow wrapper for the native + * window, or %NULL if there is none. * * Since: 2.2 **/ @@ -965,8 +965,8 @@ gdk_window_lookup_for_display (GdkDisplay *display, GdkNativeWindow anid) * For example in the X backend, a native window handle is an Xlib * XID. * - * Return value: the #GdkWindow wrapper for the native window, - * or %NULL if there is none. + * Return value: (transfer none): the #GdkWindow wrapper for the native + * window, or %NULL if there is none. **/ GdkWindow * gdk_window_lookup (GdkNativeWindow anid) diff --git a/gdk/x11/gdkxid.c b/gdk/x11/gdkxid.c index 94649b9ae1..52b86c9e64 100644 --- a/gdk/x11/gdkxid.c +++ b/gdk/x11/gdkxid.c @@ -80,8 +80,8 @@ _gdk_xid_table_remove (GdkDisplay *display, * * Returns the GDK object associated with the given X id. * - * Return value: the associated #GdkWindow or %NULL if no - * object is associated with the X id. + * Return value: (transfer none): the associated #GdkWindow, or %NULL + * of no object is associated with the X id. * * Since: 2.2 */ @@ -110,8 +110,8 @@ gdk_xid_table_lookup_for_display (GdkDisplay *display, * Returns the Gdk object associated with the given X id for the default * display. * - * Return value: the associated #GdkWindow or %NULL if no - * object is associated with the X id. + * Return value: (transfer none): the associated #GdkWindow, or %NULL + * if no object is associated with the X id. */ gpointer gdk_xid_table_lookup (XID xid)