[gtk+/gi-annotations-2: 2/8] [GI] add (out), (array), (transfer) and (scope) annotations
- From: Pavel Holejsovsky <pholejs src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+/gi-annotations-2: 2/8] [GI] add (out), (array), (transfer) and (scope) annotations
- Date: Tue, 18 Jan 2011 05:49:05 +0000 (UTC)
commit 58f05e53e56e51e61d514be8ae957f4b9dbc513a
Author: Pavel Holejsovsky <pholejs src gnome org>
Date: Tue Jan 18 06:45:11 2011 +0100
[GI] add (out), (array), (transfer) and (scope) annotations
gdk/gdk.c | 2 +-
gdk/gdkcursor.c | 2 +-
gdk/gdkdevice.c | 11 ++++---
gdk/gdkdisplay.c | 9 +++--
gdk/gdkdisplaymanager.c | 4 +-
gdk/gdkdnd.c | 2 +-
gdk/gdkevents.c | 8 ++--
gdk/gdkkeys.c | 10 ++++--
gdk/gdkoffscreenwindow.c | 2 +-
gdk/gdkrectangle.c | 2 +-
gdk/gdkselection.c | 7 ++--
gdk/gdkvisual.c | 3 +-
gdk/gdkwindow.c | 65 +++++++++++++++++++++++------------------
gdk/x11/gdkdisplay-x11.c | 3 +-
gdk/x11/gdkselection-x11.c | 15 +++++----
gdk/x11/gdkvisual-x11.c | 4 +-
gtk/Makefile.am | 1 +
gtk/gtkaboutdialog.c | 24 ++++++++--------
gtk/gtkaccelgroup.c | 17 +++++++----
gtk/gtkaccelmap.c | 7 ++--
gtk/gtkaction.c | 5 ++-
gtk/gtkalignment.c | 12 +++++--
gtk/gtkapplication.c | 2 +-
gtk/gtkbindings.c | 2 +-
gtk/gtkbox.c | 12 +++++--
gtk/gtkbuildable.c | 6 ++--
gtk/gtkbuilder.c | 4 +-
gtk/gtkbutton.c | 4 +-
gtk/gtkcalendar.c | 9 ++++--
gtk/gtkcellarea.c | 24 ++++++++-------
gtk/gtkcellareacontext.c | 2 +-
gtk/gtkcellrenderer.c | 40 +++++++++++++-------------
gtk/gtkcellview.c | 2 +-
gtk/gtkclipboard.c | 26 +++++++++--------
gtk/gtkcolorsel.c | 9 +++--
gtk/gtkcombobox.c | 4 +-
gtk/gtkcontainer.c | 20 +++++++------
gtk/gtkcssprovider.c | 2 +-
gtk/gtkdialog.c | 3 +-
gtk/gtkdnd.c | 10 +++---
gtk/gtkeditable.c | 8 ++--
gtk/gtkentry.c | 8 ++--
gtk/gtkframe.c | 6 ++-
gtk/gtkhsv.c | 22 +++++++-------
gtk/gtkiconfactory.c | 4 +-
gtk/gtkicontheme.c | 29 +++++++++++--------
gtk/gtkiconview.c | 34 ++++++++++++---------
gtk/gtkimcontext.c | 24 ++++++++--------
gtk/gtklabel.c | 11 ++++---
gtk/gtklayout.c | 6 ++-
gtk/gtkmain.c | 15 +++++----
gtk/gtkmenu.c | 10 +++---
gtk/gtkmenushell.c | 4 +-
gtk/gtkmisc.c | 10 ++++--
gtk/gtknotebook.c | 3 +-
gtk/gtknumerableicon.c | 4 +-
gtk/gtkpagesetupunixdialog.c | 4 +-
gtk/gtkprintcontext.c | 10 +++---
gtk/gtkprinter.c | 10 +++---
gtk/gtkprintjob.c | 13 +++++---
gtk/gtkprintoperation-unix.c | 5 ++-
gtk/gtkprintoperation.c | 4 +-
gtk/gtkprintsettings.c | 9 +++--
gtk/gtkprintunixdialog.c | 4 +-
gtk/gtkradiobutton.c | 15 +++++----
gtk/gtkradiomenuitem.c | 3 +-
gtk/gtkrange.c | 8 +++--
gtk/gtkrc.c | 17 ++++++----
gtk/gtkrecentchooser.c | 5 ++-
gtk/gtkrecentmanager.c | 2 +-
gtk/gtkscale.c | 4 +-
gtk/gtkscalebutton.c | 7 ++--
gtk/gtkscrolledwindow.c | 8 ++--
gtk/gtkselection.c | 40 +++++++++++++------------
gtk/gtkspinbutton.c | 10 +++---
gtk/gtkstatusicon.c | 11 ++++---
gtk/gtkstock.c | 6 ++--
gtk/gtkstyle.c | 4 +-
gtk/gtkstylecontext.c | 7 ++--
gtk/gtkstyleprovider.c | 5 ++-
gtk/gtktestutils.c | 14 +++++----
gtk/gtktextbuffer.c | 4 +-
gtk/gtktextbufferrichtext.c | 29 +++++++++---------
gtk/gtktextiter.c | 2 +-
gtk/gtktextview.c | 2 +-
gtk/gtkthemingengine.c | 15 +++++----
gtk/gtktreednd.c | 7 ++--
gtk/gtktreemodelfilter.c | 2 +-
gtk/gtktreeview.c | 39 +++++++++++++------------
gtk/gtktreeviewcolumn.c | 15 +++++----
gtk/gtkwidget.c | 9 +++--
gtk/gtkwindow.c | 14 ++++----
92 files changed, 522 insertions(+), 435 deletions(-)
---
diff --git a/gdk/gdk.c b/gdk/gdk.c
index 9bf97e5..4943525 100644
--- a/gdk/gdk.c
+++ b/gdk/gdk.c
@@ -268,7 +268,7 @@ gdk_pre_parse_libgtk_only (void)
/**
* gdk_parse_args:
* @argc: the number of command line arguments.
- * @argv: the array of command line arguments.
+ * @argv: (inout) (array length=argc): the array of command line arguments.
*
* Parse command line arguments, and store for future
* use by calls to gdk_display_open().
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/gdkdevice.c b/gdk/gdkdevice.c
index 1156755..e351b3d 100644
--- a/gdk/gdkdevice.c
+++ b/gdk/gdkdevice.c
@@ -697,8 +697,8 @@ gdk_device_get_n_keys (GdkDevice *device)
* gdk_device_get_key:
* @device: a #GdkDevice.
* @index_: the index of the macro button to get.
- * @keyval: return value for the keyval.
- * @modifiers: return value for modifiers.
+ * @keyval: (out): return value for the keyval.
+ * @modifiers: (out): return value for modifiers.
*
* If @index_ has a valid keyval, this function will return %TRUE
* and fill in @keyval and @modifiers with the keyval settings.
@@ -912,9 +912,10 @@ _gdk_device_set_associated_device (GdkDevice *device,
* the list of slave devices attached to it, otherwise it will return
* %NULL
*
- * Returns: (transfer container): the list of slave devices, or %NULL. The
- * list must be freed with g_list_free(), the contents of the list
- * are owned by GTK+ and should not be freed.
+ * Returns: (transfer container) (element-type GdkDevice): the list of
+ * slave devices, or %NULL. The list must be freed with
+ * g_list_free(), the contents of the list are owned by GTK+
+ * and should not be freed.
**/
GList *
gdk_device_list_slave_devices (GdkDevice *device)
diff --git a/gdk/gdkdisplay.c b/gdk/gdkdisplay.c
index fa2e645..32f2b94 100644
--- a/gdk/gdkdisplay.c
+++ b/gdk/gdkdisplay.c
@@ -597,7 +597,7 @@ _gdk_display_enable_motion_hints (GdkDisplay *display,
/**
* gdk_display_get_pointer:
* @display: a #GdkDisplay
- * @screen: (allow-none): location to store the screen that the
+ * @screen: (out) (allow-none): location to store the screen that the
* cursor is on, or %NULL.
* @x: (out) (allow-none): location to store root window X coordinate of pointer, or %NULL.
* @y: (out) (allow-none): location to store root window Y coordinate of pointer, or %NULL.
@@ -1571,7 +1571,8 @@ gdk_display_supports_clipboard_persistence (GdkDisplay *display)
* @display: a #GdkDisplay
* @clipboard_window: a #GdkWindow belonging to the clipboard owner
* @time_: a timestamp
- * @targets: an array of targets that should be saved, or %NULL
+ * @targets: (array length=n_targets): an array of targets
+ * that should be saved, or %NULL
* if all available targets should be saved.
* @n_targets: length of the @targets array
*
@@ -1756,7 +1757,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
@@ -1771,7 +1772,7 @@ gdk_display_get_app_launch_context (GdkDisplay *display)
* gdk_drag_get_protocol_for_display:
* @display: the #GdkDisplay where the destination window resides
* @xid: the windowing system id of the destination window.
- * @protocol: location where the supported DND protocol is returned.
+ * @protocol: (out): location where the supported DND protocol is returned.
*
* Finds out the DND protocol supported by a window.
*
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..bc81cf2 100644
--- a/gdk/gdkevents.c
+++ b/gdk/gdkevents.c
@@ -917,7 +917,7 @@ gdk_event_get_root_coords (const GdkEvent *event,
/**
* gdk_event_get_axis:
* @event: a #GdkEvent
- * @axis_use: (out): the axis use to look for
+ * @axis_use: the axis use to look for
* @value: (out): location to store the value found
*
* Extract the axis value for a particular axis use from
@@ -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
**/
@@ -1256,7 +1256,7 @@ gdk_events_get_axis_distances (GdkEvent *event1,
* gdk_events_get_distance:
* @event1: first #GdkEvent
* @event2: second #GdkEvent
- * @distance: return location for the distance
+ * @distance: (out): return location for the distance
*
* If both events have X/Y information, the distance between both coordinates
* (as in a straight line going from @event1 to @event2) will be returned.
@@ -1279,7 +1279,7 @@ gdk_events_get_distance (GdkEvent *event1,
* gdk_events_get_angle:
* @event1: first #GdkEvent
* @event2: second #GdkEvent
- * @angle: return location for the relative angle between both events
+ * @angle: (out): return location for the relative angle between both events
*
* If both events contain X/Y information, this function will return %TRUE
* and return in @angle the relative angle from @event1 to @event2. The rotation
diff --git a/gdk/gdkkeys.c b/gdk/gdkkeys.c
index a3ae2af..4b89188 100644
--- a/gdk/gdkkeys.c
+++ b/gdk/gdkkeys.c
@@ -397,8 +397,10 @@ gdk_keymap_get_entries_for_keyval (GdkKeymap *keymap,
* gdk_keymap_get_entries_for_keycode:
* @keymap: a #GdkKeymap
* @hardware_keycode: a keycode
- * @keys: (out): return location for array of #GdkKeymapKey, or %NULL
- * @keyvals: (out): return location for array of keyvals, or %NULL
+ * @keys: (out) (array length=n_entries) (transfer full): return
+ * location for array of #GdkKeymapKey, or %NULL
+ * @keyvals: (out) (array length=n_entries) (transfer full): return
+ * location for array of keyvals, or %NULL
* @n_entries: length of @keys and @keyvals
*
* Returns the keyvals bound to @hardware_keycode.
@@ -532,7 +534,7 @@ gdk_keymap_translate_keyboard_state (GdkKeymap *keymap,
/**
* gdk_keymap_add_virtual_modifiers:
* @keymap: a #GdkKeymap
- * @state: pointer to the modifier mask to change
+ * @state: (out): pointer to the modifier mask to change
*
* Adds virtual modifiers (i.e. Super, Hyper and Meta) which correspond
* to the real modifiers (i.e Mod2, Mod3, ...) in @modifiers.
@@ -558,7 +560,7 @@ gdk_keymap_add_virtual_modifiers (GdkKeymap *keymap,
/**
* gdk_keymap_map_virtual_modifiers:
* @keymap: a #GdkKeymap
- * @state: pointer to the modifier state to map
+ * @state: (out): pointer to the modifier state to map
*
* Maps the virtual modifiers (i.e. Super, Hyper and Meta) which
* are set in @state to their non-virtual counterparts (i.e. Mod2,
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/gdkrectangle.c b/gdk/gdkrectangle.c
index ff68aa5..2e104c3 100644
--- a/gdk/gdkrectangle.c
+++ b/gdk/gdkrectangle.c
@@ -53,7 +53,7 @@
* gdk_rectangle_union:
* @src1: a #GdkRectangle
* @src2: a #GdkRectangle
- * @dest: return location for the union of @src1 and @src2
+ * @dest: (out): return location for the union of @src1 and @src2
*
* Calculates the union of two rectangles.
* The union of rectangles @src1 and @src2 is the smallest rectangle which
diff --git a/gdk/gdkselection.c b/gdk/gdkselection.c
index 27adfdf..8a59723 100644
--- a/gdk/gdkselection.c
+++ b/gdk/gdkselection.c
@@ -282,10 +282,11 @@ gdk_selection_convert (GdkWindow *requestor,
* @display: a #GdkDisplay
* @encoding: an atom representing the encoding of the text
* @format: the format of the property
- * @text: the text to convert
+ * @text: (array length=length): the text to convert
* @length: the length of @text, in bytes
- * @list: location to store the list of strings or %NULL. The
- * list should be freed with g_strfreev().
+ * @list: (out) (array zero-terminated=1): location to store the list
+ * of strings or %NULL. The list should be freed with
+ * g_strfreev().
*
* Converts a text property in the given encoding to
* a list of UTF-8 strings.
diff --git a/gdk/gdkvisual.c b/gdk/gdkvisual.c
index 4a25402..a2338a9 100644
--- a/gdk/gdkvisual.c
+++ b/gdk/gdkvisual.c
@@ -241,7 +241,8 @@ gdk_query_depths (gint **depths,
/**
* gdk_query_visual_types:
- * @visual_types: return location for the available visual types
+ * @visual_types: (out) (array length=count) (transfer none): return
+ * location for the available visual types
* @count: return location for the number of available visual types
*
* This function returns the available visual types for the default
diff --git a/gdk/gdkwindow.c b/gdk/gdkwindow.c
index 30d5c8d..51b1fd2 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
*/
@@ -405,8 +406,10 @@ gdk_window_class_init (GdkWindowClass *klass)
* @window: the offscreen window on which the signal is emitted
* @offscreen-x: x coordinate in the offscreen window
* @offscreen-y: y coordinate in the offscreen window
- * @embedder-x: return location for the x coordinate in the embedder window
- * @embedder-y: return location for the y coordinate in the embedder window
+ * @embedder-x: (out) (type double): return location for the x
+ * coordinate in the embedder window
+ * @embedder-y: (out) (type double): return location for the y
+ * coordinate in the embedder window
*
* The ::to-embedder signal is emitted to translate coordinates
* in an offscreen window to its embedder.
@@ -434,8 +437,10 @@ gdk_window_class_init (GdkWindowClass *klass)
* @window: the offscreen window on which the signal is emitted
* @embedder-x: x coordinate in the embedder window
* @embedder-y: y coordinate in the embedder window
- * @offscreen-x: return location for the x coordinate in the offscreen window
- * @offscreen-y: return location for the y coordinate in the offscreen window
+ * @offscreen-x: (out) (type double): return location for the x
+ * coordinate in the offscreen window
+ * @offscreen-y: (out) (type double): return location for the y
+ * coordinate in the offscreen window
*
* The ::from-embedder signal is emitted to translate coordinates
* in the embedder of an offscreen window to the offscreen window.
@@ -2075,7 +2080,7 @@ gdk_window_set_user_data (GdkWindow *window,
/**
* gdk_window_get_user_data:
* @window: a #GdkWindow
- * @data: return location for user data
+ * @data: (out): return location for user data
*
* Retrieves the user data for @window, which is normally the widget
* that @window belongs to. See gdk_window_set_user_data().
@@ -4431,8 +4436,8 @@ gdk_window_invalidate_maybe_recurse_full (GdkWindow *window,
* gdk_window_invalidate_maybe_recurse:
* @window: a #GdkWindow
* @region: a #cairo_region_t
- * @child_func: function to use to decide if to recurse to a child,
- * %NULL means never recurse.
+ * @child_func: (scope call): function to use to decide if to recurse
+ * to a child, %NULL means never recurse.
* @user_data: data passed to @child_func
*
* Adds @region to the update area for @window. The update area is the
@@ -4780,8 +4785,8 @@ gdk_window_set_debug_updates (gboolean setting)
* @flags: a mask indicating what portions of @geometry are set
* @width: desired width of window
* @height: desired height of the window
- * @new_width: location to store resulting width
- * @new_height: location to store resulting height
+ * @new_width: (out): location to store resulting width
+ * @new_height: (out): location to store resulting height
*
* Constrains a desired width and height according to a
* set of geometry hints (such as minimum and maximum size).
@@ -6584,8 +6589,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 +6627,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 +6692,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
**/
@@ -6921,8 +6928,8 @@ gdk_window_get_origin (GdkWindow *window,
* @window: a #GdkWindow
* @x: X coordinate in window
* @y: Y coordinate in window
- * @root_x: return location for X coordinate
- * @root_y: return location for Y coordinate
+ * @root_x: (out): return location for X coordinate
+ * @root_y: (out): return location for Y coordinate
*
* Obtains the position of a window position in root
* window coordinates. This is similar to
@@ -10060,8 +10067,8 @@ gdk_window_set_transient_for (GdkWindow *window,
/**
* gdk_window_get_root_origin:
* @window: a toplevel #GdkWindow
- * @x: return location for X position of window frame
- * @y: return location for Y position of window frame
+ * @x: (out): return location for X position of window frame
+ * @y: (out): return location for Y position of window frame
*
* Obtains the top-left corner of the window manager frame in root
* window coordinates.
@@ -10484,7 +10491,7 @@ gdk_window_set_decorations (GdkWindow *window,
/**
* gdk_window_get_decorations:
* @window: The toplevel #GdkWindow to get the decorations from
- * @decorations: The window decorations will be written here
+ * @decorations: (out): The window decorations will be written here
*
* Returns the decorations set on the GdkWindow with
* gdk_window_set_decorations().
@@ -10834,9 +10841,9 @@ gdk_test_simulate_button (GdkWindow *window,
* when rounded up).
* @pdelete: if %TRUE, delete the property after retrieving the
* data.
- * @actual_property_type: location to store the actual type of
-* the property.
- * @actual_format: location to store the actual return format of the
+ * @actual_property_type: (out) (transfer none): location to store the
+ * actual type of the property.
+ * @actual_format: (out): location to store the actual return format of the
* data; either 8, 16 or 32 bits.
* @actual_length: location to store the length of the retrieved data, in
* bytes. Data returned in the 32 bit format is stored
@@ -10844,9 +10851,9 @@ gdk_test_simulate_button (GdkWindow *window,
* elements should be be calculated via
* @actual_length / sizeof(glong) to ensure portability to
* 64 bit systems.
- * @data: location to store a pointer to the data. The retrieved
- * data should be freed with g_free() when you are finished
- * using it.
+ * @data: (out) (array length=actual_length) (transfer full): location
+ * to store a pointer to the data. The retrieved data should be
+ * freed with g_free() when you are finished using it.
*
* Retrieves a portion of the contents of a property. If the
* property does not exist, then the function returns %FALSE,
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/gdkselection-x11.c b/gdk/x11/gdkselection-x11.c
index f13207b..66ddd21 100644
--- a/gdk/x11/gdkselection-x11.c
+++ b/gdk/x11/gdkselection-x11.c
@@ -576,11 +576,12 @@ _gdk_x11_display_text_property_to_utf8_list (GdkDisplay *display,
* gdk_x11_display_string_to_compound_text:
* @display: the #GdkDisplay where the encoding is defined
* @str: a nul-terminated string
- * @encoding: location to store the encoding atom
+ * @encoding: (out) (transfer none): location to store the encoding atom
* (to be used as the type for the property)
- * @format: location to store the format of the property
- * @ctext: location to store newly allocated data for the property
- * @length: the length of @text, in bytes
+ * @format: (out): location to store the format of the property
+ * @ctext: (out) (array length=length): location to store newly
+ * allocated data for the property
+ * @length: the length of @ctext, in bytes
*
* Convert a string from the encoding of the current
* locale into a form suitable for storing in a window property.
@@ -696,9 +697,9 @@ _gdk_x11_display_utf8_to_string_target (GdkDisplay *display,
* gdk_x11_display_utf8_to_compound_text:
* @display: a #GdkDisplay
* @str: a UTF-8 string
- * @encoding: location to store resulting encoding
- * @format: location to store format of the result
- * @ctext: location to store the data of the result
+ * @encoding: (out): location to store resulting encoding
+ * @format: (out): location to store format of the result
+ * @ctext: (out) (array length=length): location to store the data of the result
* @length: location to store the length of the data
* stored in @ctext
*
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/Makefile.am b/gtk/Makefile.am
index 04bbadd..225341f 100644
--- a/gtk/Makefile.am
+++ b/gtk/Makefile.am
@@ -965,6 +965,7 @@ if HAVE_INTROSPECTION
introspection_files = \
$(filter-out %private.h gtktextlayout.h, $(gtkinclude_HEADERS)) \
$(gtk_base_c_sources) \
+ gtkprintoperation-unix.c \
gtktypebuiltins.h \
gtktypebuiltins.c
diff --git a/gtk/gtkaboutdialog.c b/gtk/gtkaboutdialog.c
index 414355e..7e34c99 100644
--- a/gtk/gtkaboutdialog.c
+++ b/gtk/gtkaboutdialog.c
@@ -1480,9 +1480,9 @@ gtk_about_dialog_set_website_label (GtkAboutDialog *about,
* Returns the string which are displayed in the authors tab
* of the secondary credits dialog.
*
- * Return value: A %NULL-terminated string array containing
- * the authors. The array is owned by the about dialog
- * and must not be modified.
+ * Return value: (array zero-terminated=1) (transfer none): A
+ * %NULL-terminated string array containing the authors. The array is
+ * owned by the about dialog and must not be modified.
*
* Since: 2.6
*/
@@ -1535,9 +1535,9 @@ gtk_about_dialog_set_authors (GtkAboutDialog *about,
* Returns the string which are displayed in the documenters
* tab of the secondary credits dialog.
*
- * Return value: A %NULL-terminated string array containing
- * the documenters. The array is owned by the about dialog
- * and must not be modified.
+ * Return value: (array zero-terminated=1) (transfer none): A
+ * %NULL-terminated string array containing the documenters. The
+ * array is owned by the about dialog and must not be modified.
*
* Since: 2.6
*/
@@ -1590,9 +1590,9 @@ gtk_about_dialog_set_documenters (GtkAboutDialog *about,
* Returns the string which are displayed in the artists tab
* of the secondary credits dialog.
*
- * Return value: A %NULL-terminated string array containing
- * the artists. The array is owned by the about dialog
- * and must not be modified.
+ * Return value: (array zero-terminated=1) (transfer none): A
+ * %NULL-terminated string array containing the artists. The array is
+ * owned by the about dialog and must not be modified.
*
* Since: 2.6
*/
@@ -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 9e43cca..a036005 100644
--- a/gtk/gtkaccelgroup.c
+++ b/gtk/gtkaccelgroup.c
@@ -375,10 +375,11 @@ gtk_accel_groups_from_object (GObject *object)
/**
* gtk_accel_group_find:
* @accel_group: a #GtkAccelGroup
- * @find_func: a function to filter the entries of @accel_group with
+ * @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.
@@ -819,8 +820,11 @@ _gtk_accel_group_get_accelerables (GtkAccelGroup *accel_group)
* @accel_group: the accelerator group to query
* @accel_key: key value of the accelerator
* @accel_mods: modifier combination of the accelerator
- * @n_entries: (allow-none): location to return the number of entries found, or %NULL
- * @returns: (allow-none): an array of @n_entries #GtkAccelGroupEntry elements, or %NULL. The array is owned by GTK+ and must not be freed.
+ * @n_entries: (allow-none): location to return the number of entries found,
+ * or %NULL
+ * @returns: (transfer none) (array length=n_entries): an array of
+ * @n_entries #GtkAccelGroupEntry elements, or %NULL. The array is
+ * owned by GTK+ and must not be freed.
*
* Queries an accelerator group for all entries matching @accel_key and
* @accel_mods.
@@ -847,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/gtkaccelmap.c b/gtk/gtkaccelmap.c
index 2b0fc3d..f678f02 100644
--- a/gtk/gtkaccelmap.c
+++ b/gtk/gtkaccelmap.c
@@ -807,8 +807,8 @@ gtk_accel_map_save (const gchar *file_name)
/**
* gtk_accel_map_foreach:
* @data: data to be passed into @foreach_func
- * @foreach_func: function to be executed for each accel map entry which
- * is not filtered out
+ * @foreach_func: (scope call): function to be executed for each accel
+ * map entry which is not filtered out
*
* Loops over the entries in the accelerator map whose accel path
* doesn't match any of the filters added with gtk_accel_map_add_filter(),
@@ -844,7 +844,8 @@ gtk_accel_map_foreach (gpointer data,
/**
* gtk_accel_map_foreach_unfiltered:
* @data: data to be passed into @foreach_func
- * @foreach_func: function to be executed for each accel map entry
+ * @foreach_func: (scope call): function to be executed for each accel
+ * map entry
*
* Loops over all entries in the accelerator map, and execute
* @foreach_func on each. The signature of @foreach_func is that of
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/gtkalignment.c b/gtk/gtkalignment.c
index 78f21aa..281fa9c 100644
--- a/gtk/gtkalignment.c
+++ b/gtk/gtkalignment.c
@@ -753,10 +753,14 @@ gtk_alignment_set_padding (GtkAlignment *alignment,
/**
* gtk_alignment_get_padding:
* @alignment: a #GtkAlignment
- * @padding_top: (allow-none): location to store the padding for the top of the widget, or %NULL
- * @padding_bottom: (allow-none): location to store the padding for the bottom of the widget, or %NULL
- * @padding_left: (allow-none): location to store the padding for the left of the widget, or %NULL
- * @padding_right: (allow-none): location to store the padding for the right of the widget, or %NULL
+ * @padding_top: (out) (allow-none): location to store the padding for
+ * the top of the widget, or %NULL
+ * @padding_bottom: (out) (allow-none): location to store the padding
+ * for the bottom of the widget, or %NULL
+ * @padding_left: (out) (allow-none): location to store the padding
+ * for the left of the widget, or %NULL
+ * @padding_right: (out) (allow-none): location to store the padding
+ * for the right of the widget, or %NULL
*
* Gets the padding on the different sides of the widget.
* See gtk_alignment_set_padding ().
diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index 2d68b09..701a0e8 100644
--- a/gtk/gtkapplication.c
+++ b/gtk/gtkapplication.c
@@ -253,7 +253,7 @@ gtk_application_remove_window (GtkApplication *application,
*
* The list that is returned should not be modified in any way.
*
- * Returns: a #GList of #GtkWindow
+ * Returns: (element-type GtkWindow) (transfer none): a #GList of #GtkWindow
*
* Since: 3.0
**/
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/gtkbox.c b/gtk/gtkbox.c
index 8c7f867..6292ca8 100644
--- a/gtk/gtkbox.c
+++ b/gtk/gtkbox.c
@@ -1505,10 +1505,14 @@ gtk_box_reorder_child (GtkBox *box,
* gtk_box_query_child_packing:
* @box: a #GtkBox
* @child: the #GtkWidget of the child to query
- * @expand: pointer to return location for #GtkBox:expand child property
- * @fill: pointer to return location for #GtkBox:fill child property
- * @padding: pointer to return location for #GtkBox:padding child property
- * @pack_type: pointer to return location for #GtkBox:pack-type child property
+ * @expand: (out): pointer to return location for #GtkBox:expand child
+ * property
+ * @fill: (out): pointer to return location for #GtkBox:fill child
+ * property
+ * @padding: (out): pointer to return location for #GtkBox:padding
+ * child property
+ * @pack_type: (out): pointer to return location for #GtkBox:pack-type
+ * child property
*
* Obtains information about how @child is packed into @box.
*/
diff --git a/gtk/gtkbuildable.c b/gtk/gtkbuildable.c
index 25c9fc2..9dfb64c 100644
--- a/gtk/gtkbuildable.c
+++ b/gtk/gtkbuildable.c
@@ -235,8 +235,8 @@ gtk_buildable_construct_child (GtkBuildable *buildable,
* @builder: a #GtkBuilder used to construct this object
* @child: (allow-none): child object or %NULL for non-child tags
* @tagname: name of tag
- * @parser: a #GMarkupParser structure to fill in
- * @data: return location for user data that will be passed in
+ * @parser: (out): a #GMarkupParser structure to fill in
+ * @data: (out): return location for user data that will be passed in
* to parser functions
*
* This is called for each unknown element under <child>.
@@ -273,7 +273,7 @@ gtk_buildable_custom_tag_start (GtkBuildable *buildable,
* @builder: #GtkBuilder used to construct this object
* @child: (allow-none): child object or %NULL for non-child tags
* @tagname: name of tag
- * @data: user data that will be passed in to parser functions
+ * @data: (type gpointer): user data that will be passed in to parser functions
*
* This is called at the end of each custom element handled by
* the buildable.
diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c
index faa3ef7..b658654 100644
--- a/gtk/gtkbuilder.c
+++ b/gtk/gtkbuilder.c
@@ -1341,7 +1341,7 @@ gtk_builder_connect_signals_full (GtkBuilder *builder,
* @builder: a #GtkBuilder
* @pspec: the #GParamSpec for the property
* @string: the string representation of the value
- * @value: the #GValue to store the result in
+ * @value: (out): the #GValue to store the result in
* @error: (allow-none): return location for an error, or %NULL
*
* This function demarshals a value from a string. This function
@@ -1397,7 +1397,7 @@ gtk_builder_value_from_string (GtkBuilder *builder,
* @builder: a #GtkBuilder
* @type: the #GType of the value
* @string: the string representation of the value
- * @value: the #GValue to store the result in
+ * @value: (out): the #GValue to store the result in
* @error: (allow-none): return location for an error, or %NULL
*
* Like gtk_builder_value_from_string(), this function demarshals
diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c
index d86ca46..8e01c22 100644
--- a/gtk/gtkbutton.c
+++ b/gtk/gtkbutton.c
@@ -2240,8 +2240,8 @@ gtk_button_set_alignment (GtkButton *button,
/**
* gtk_button_get_alignment:
* @button: a #GtkButton
- * @xalign: return location for horizontal alignment
- * @yalign: return location for vertical alignment
+ * @xalign: (out): return location for horizontal alignment
+ * @yalign: (out): return location for vertical alignment
*
* Gets the alignment of the child in the button.
*
diff --git a/gtk/gtkcalendar.c b/gtk/gtkcalendar.c
index c393d2f..3aa1be4 100644
--- a/gtk/gtkcalendar.c
+++ b/gtk/gtkcalendar.c
@@ -3878,9 +3878,12 @@ gtk_calendar_unmark_day (GtkCalendar *calendar,
/**
* gtk_calendar_get_date:
* @calendar: a #GtkCalendar
- * @year: (allow-none): location to store the year as a decimal number (e.g. 2011), or %NULL
- * @month: (allow-none): location to store the month number (between 0 and 11), or %NULL
- * @day: (allow-none): location to store the day number (between 1 and 31), or %NULL
+ * @year: (out) (allow-none): location to store the year as a decimal
+ * number (e.g. 2011), or %NULL
+ * @month: (out) (allow-none): location to store the month number
+ * (between 0 and 11), or %NULL
+ * @day: (out) (allow-none): location to store the day number (between
+ * 1 and 31), or %NULL
*
* Obtains the selected date from a #GtkCalendar.
*/
diff --git a/gtk/gtkcellarea.c b/gtk/gtkcellarea.c
index 2175f50..2315871 100644
--- a/gtk/gtkcellarea.c
+++ b/gtk/gtkcellarea.c
@@ -1624,7 +1624,7 @@ gtk_cell_area_has_renderer (GtkCellArea *area,
/**
* gtk_cell_area_foreach:
* @area: a #GtkCellArea
- * @callback: the #GtkCellCallback to call
+ * @callback: (scope call): the #GtkCellCallback to call
* @callback_data: user provided data pointer
*
* Calls @callback for every #GtkCellRenderer in @area.
@@ -1657,7 +1657,7 @@ gtk_cell_area_foreach (GtkCellArea *area,
* @widget: the #GtkWidget that @area is rendering to
* @cell_area: the @widget relative coordinates and size for @area
* @background_area: the @widget relative coordinates of the background area
- * @callback: the #GtkCellAllocCallback to call
+ * @callback: (scope call): the #GtkCellAllocCallback to call
* @callback_data: user provided data pointer
*
* Calls @callback for every #GtkCellRenderer in @area with the
@@ -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
*/
@@ -2458,8 +2458,9 @@ gtk_cell_area_class_find_cell_property (GtkCellAreaClass *aclass,
*
* Returns all cell properties of a cell area class.
*
- * Return value: a newly allocated %NULL-terminated array of #GParamSpec*.
- * The array must be freed with g_free().
+ * Return value: (array length=n_properties) (transfer container): a newly
+ * allocated %NULL-terminated array of #GParamSpec*. The array
+ * must be freed with g_free().
*
* Since: 3.0
*/
@@ -2993,7 +2994,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 +3178,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 +3322,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 +3345,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/gtkcellrenderer.c b/gtk/gtkcellrenderer.c
index 36a6120..ced210e 100644
--- a/gtk/gtkcellrenderer.c
+++ b/gtk/gtkcellrenderer.c
@@ -613,10 +613,10 @@ set_cell_bg_color (GtkCellRenderer *cell,
* @cell: a #GtkCellRenderer
* @widget: the widget the renderer is rendering to
* @cell_area: (allow-none): The area a cell will be allocated, or %NULL
- * @x_offset: (allow-none): location to return x offset of cell relative to @cell_area, or %NULL
- * @y_offset: (allow-none): location to return y offset of cell relative to @cell_area, or %NULL
- * @width: (allow-none): location to return width needed to render a cell, or %NULL
- * @height: (allow-none): location to return height needed to render a cell, or %NULL
+ * @x_offset: (out) (allow-none): location to return x offset of cell relative to @cell_area, or %NULL
+ * @y_offset: (out) (allow-none): location to return y offset of cell relative to @cell_area, or %NULL
+ * @width: (out) (allow-none): location to return width needed to render a cell, or %NULL
+ * @height: (out) (allow-none): location to return height needed to render a cell, or %NULL
*
* Obtains the width and height needed to render the cell. Used by view
* widgets to determine the appropriate size for the cell_area passed to
@@ -857,8 +857,8 @@ gtk_cell_renderer_set_fixed_size (GtkCellRenderer *cell,
/**
* gtk_cell_renderer_get_fixed_size:
* @cell: A #GtkCellRenderer
- * @width: (allow-none): location to fill in with the fixed width of the cell, or %NULL
- * @height: (allow-none): location to fill in with the fixed height of the cell, or %NULL
+ * @width: (out) (allow-none): location to fill in with the fixed width of the cell, or %NULL
+ * @height: (out) (allow-none): location to fill in with the fixed height of the cell, or %NULL
*
* Fills in @width and @height with the appropriate size of @cell.
**/
@@ -925,8 +925,8 @@ gtk_cell_renderer_set_alignment (GtkCellRenderer *cell,
/**
* gtk_cell_renderer_get_alignment:
* @cell: A #GtkCellRenderer
- * @xalign: (allow-none): location to fill in with the x alignment of the cell, or %NULL
- * @yalign: (allow-none): location to fill in with the y alignment of the cell, or %NULL
+ * @xalign: (out) (allow-none): location to fill in with the x alignment of the cell, or %NULL
+ * @yalign: (out) (allow-none): location to fill in with the y alignment of the cell, or %NULL
*
* Fills in @xalign and @yalign with the appropriate values of @cell.
*
@@ -994,8 +994,8 @@ gtk_cell_renderer_set_padding (GtkCellRenderer *cell,
/**
* gtk_cell_renderer_get_padding:
* @cell: A #GtkCellRenderer
- * @xpad: (allow-none): location to fill in with the x padding of the cell, or %NULL
- * @ypad: (allow-none): location to fill in with the y padding of the cell, or %NULL
+ * @xpad: (out) (allow-none): location to fill in with the x padding of the cell, or %NULL
+ * @ypad: (out) (allow-none): location to fill in with the y padding of the cell, or %NULL
*
* Fills in @xpad and @ypad with the appropriate values of @cell.
*
@@ -1374,8 +1374,8 @@ gtk_cell_renderer_get_request_mode (GtkCellRenderer *cell)
* gtk_cell_renderer_get_preferred_width:
* @cell: a #GtkCellRenderer instance
* @widget: the #GtkWidget this cell will be rendering to
- * @minimum_size: location to store the minimum size, or %NULL
- * @natural_size: location to store the natural size, or %NULL
+ * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL
+ * @natural_size: (out) (allow-none): location to store the natural size, or %NULL
*
* Retreives a renderer's natural size when rendered to @widget.
*
@@ -1422,8 +1422,8 @@ gtk_cell_renderer_get_preferred_width (GtkCellRenderer *cell,
* gtk_cell_renderer_get_preferred_height:
* @cell: a #GtkCellRenderer instance
* @widget: the #GtkWidget this cell will be rendering to
- * @minimum_size: location to store the minimum size, or %NULL
- * @natural_size: location to store the natural size, or %NULL
+ * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL
+ * @natural_size: (out) (allow-none): location to store the natural size, or %NULL
*
* Retreives a renderer's natural size when rendered to @widget.
*
@@ -1471,8 +1471,8 @@ gtk_cell_renderer_get_preferred_height (GtkCellRenderer *cell,
* @cell: a #GtkCellRenderer instance
* @widget: the #GtkWidget this cell will be rendering to
* @height: the size which is available for allocation
- * @minimum_width: location for storing the minimum size, or %NULL
- * @natural_width: location for storing the preferred size, or %NULL
+ * @minimum_width: (out) (allow-none): location for storing the minimum size, or %NULL
+ * @natural_width: (out) (allow-none): location for storing the preferred size, or %NULL
*
* Retreives a cell renderers's minimum and natural width if it were rendered to
* @widget with the specified @height.
@@ -1521,8 +1521,8 @@ gtk_cell_renderer_get_preferred_width_for_height (GtkCellRenderer *cell,
* @cell: a #GtkCellRenderer instance
* @widget: the #GtkWidget this cell will be rendering to
* @width: the size which is available for allocation
- * @minimum_height: location for storing the minimum size, or %NULL
- * @natural_height: location for storing the preferred size, or %NULL
+ * @minimum_height: (out) (allow-none): location for storing the minimum size, or %NULL
+ * @natural_height: (out) (allow-none): location for storing the preferred size, or %NULL
*
* Retreives a cell renderers's minimum and natural height if it were rendered to
* @widget with the specified @width.
@@ -1633,8 +1633,8 @@ gtk_cell_renderer_get_preferred_size (GtkCellRenderer *cell,
* @widget: the #GtkWidget this cell will be rendering to
* @flags: render flags
* @cell_area: cell area which would be passed to gtk_cell_renderer_render()
- * @aligned_area: the return location for the space inside @cell_area that
- * would acually be used to render.
+ * @aligned_area: (out): the return location for the space inside @cell_area
+ * that would acually be used to render.
*
* Gets the aligned area used by @cell inside @cell_area. Used for finding
* the appropriate edit and focus rectangle.
diff --git a/gtk/gtkcellview.c b/gtk/gtkcellview.c
index e47d5ea..e47f861 100644
--- a/gtk/gtkcellview.c
+++ b/gtk/gtkcellview.c
@@ -1179,7 +1179,7 @@ gtk_cell_view_get_displayed_row (GtkCellView *cell_view)
* gtk_cell_view_get_size_of_row:
* @cell_view: a #GtkCellView
* @path: a #GtkTreePath
- * @requisition: return location for the size
+ * @requisition: (out): return location for the size
*
* Sets @requisition to the size needed by @cell_view to display
* the model row pointed to by @path.
diff --git a/gtk/gtkclipboard.c b/gtk/gtkclipboard.c
index 0c40639..1fdc44d 100644
--- a/gtk/gtkclipboard.c
+++ b/gtk/gtkclipboard.c
@@ -1405,19 +1405,20 @@ clipboard_rich_text_received_func (GtkClipboard *clipboard,
* gtk_clipboard_wait_for_rich_text:
* @clipboard: a #GtkClipboard
* @buffer: a #GtkTextBuffer
- * @format: return location for the format of the returned data
+ * @format: (out): return location for the format of the returned data
* @length: return location for the length of the returned data
*
* Requests the contents of the clipboard as rich text. This function
* waits for the data to be received using the main loop, so events,
* timeouts, etc, may be dispatched during the wait.
*
- * Return value: a newly-allocated binary block of data which must
- * be freed with g_free(), or %NULL if retrieving
- * the selection data failed. (This could happen
- * for various reasons, in particular if the
- * clipboard was empty or if the contents of the
- * clipboard could not be converted into text form.)
+ * Return value: (array length=length) (transfer full): a
+ * newly-allocated binary block of data which must be
+ * freed with g_free(), or %NULL if retrieving the
+ * selection data failed. (This could happen for various
+ * reasons, in particular if the clipboard was empty or
+ * if the contents of the clipboard could not be
+ * converted into text form.)
*
* Since: 2.10
**/
@@ -1730,8 +1731,9 @@ gtk_clipboard_wait_is_uris_available (GtkClipboard *clipboard)
/**
* gtk_clipboard_wait_for_targets
* @clipboard: a #GtkClipboard
- * @targets: location to store an array of targets. The result
- * stored here must be freed with g_free().
+ * @targets: (out) (array length=n_targets) (transfer container): location
+ * to store an array of targets. The result stored here must
+ * be freed with g_free().
* @n_targets: location to store number of items in @targets.
*
* Returns a list of targets that are present on the clipboard, or %NULL
@@ -1932,9 +1934,9 @@ gtk_clipboard_store_timeout (GtkClipboard *clipboard)
/**
* gtk_clipboard_set_can_store:
* @clipboard: a #GtkClipboard
- * @targets: (allow-none): array containing information about which forms
- * should be stored or %NULL to indicate that all forms should
- * be stored.
+ * @targets: (allow-none) (array length=n_targets): array containing
+ * information about which forms should be stored or %NULL
+ * to indicate that all forms should be stored.
* @n_targets: number of elements in @targets
*
* Hints that the clipboard data should be stored somewhere when the
diff --git a/gtk/gtkcolorsel.c b/gtk/gtkcolorsel.c
index f60d1e7..ef2d2a8 100644
--- a/gtk/gtkcolorsel.c
+++ b/gtk/gtkcolorsel.c
@@ -2650,7 +2650,7 @@ gtk_color_selection_set_previous_alpha (GtkColorSelection *colorsel,
/**
* gtk_color_selection_get_previous_color:
* @colorsel: a #GtkColorSelection.
- * @color: a #GdkColor to fill in with the original color value.
+ * @color: (out): a #GdkColor to fill in with the original color value.
*
* Fills @color in with the original color value.
**/
@@ -2802,7 +2802,7 @@ gtk_color_selection_set_previous_rgba (GtkColorSelection *colorsel,
/**
* gtk_color_selection_get_previous_rgba:
* @colorsel: a #GtkColorSelection.
- * @rgba: a #GdkRGBA to fill in with the original color value.
+ * @rgba: (out): a #GdkRGBA to fill in with the original color value.
*
* Fills @rgba in with the original color value.
*
@@ -2881,7 +2881,8 @@ gtk_color_selection_is_adjusting (GtkColorSelection *colorsel)
/**
* gtk_color_selection_palette_from_string:
* @str: a string encoding a color palette.
- * @colors: return location for allocated array of #GdkColor.
+ * @colors: (out) (array length=n_colors): return location for allocated
+ * array of #GdkColor.
* @n_colors: return location for length of array.
*
* Parses a color palette string; the string is a colon-separated
@@ -2966,7 +2967,7 @@ gtk_color_selection_palette_from_string (const gchar *str,
/**
* gtk_color_selection_palette_to_string:
- * @colors: an array of colors.
+ * @colors: (array length=n_colors): an array of colors.
* @n_colors: length of the array.
*
* Encodes a palette as a string, useful for persistent storage.
diff --git a/gtk/gtkcombobox.c b/gtk/gtkcombobox.c
index b2adcfb..b655225 100644
--- a/gtk/gtkcombobox.c
+++ b/gtk/gtkcombobox.c
@@ -4965,8 +4965,8 @@ gtk_combo_box_get_row_separator_func (GtkComboBox *combo_box)
* gtk_combo_box_set_row_separator_func:
* @combo_box: a #GtkComboBox
* @func: a #GtkTreeViewRowSeparatorFunc
- * @data: (allow-none): user data to pass to @func, or %NULL
- * @destroy: (allow-none): destroy notifier for @data, or %NULL
+ * @data: user data to pass to @func, or %NULL
+ * @destroy: destroy notifier for @data, or %NULL
*
* Sets the row separator function, which is used to determine
* whether a row should be drawn as a separator. If the row separator
diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index cd400b3..d1c8c2a 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.
*/
@@ -1218,10 +1218,11 @@ gtk_container_class_find_child_property (GObjectClass *cclass,
/**
* gtk_container_class_list_child_properties:
- * @cclass: a #GtkContainerClass
+ * @cclass: (type GtkContainerClass): a #GtkContainerClass
* @n_properties: location to return the number of child properties found
- * @returns: a newly allocated %NULL-terminated array of #GParamSpec*.
- * The array must be freed with g_free().
+ * @returns: (array length=n_properties) (transfer container): a newly
+ * allocated %NULL-terminated array of #GParamSpec*. The
+ * array must be freed with g_free().
*
* Returns all child properties of a container class.
*/
@@ -1865,7 +1866,7 @@ gtk_container_class_handle_border_width (GtkContainerClass *klass)
/**
* gtk_container_forall:
* @container: a #GtkContainer
- * @callback: a callback
+ * @callback: (scope call): a callback
* @callback_data: callback user data
*
* Invokes @callback on each child of @container, including children
@@ -1951,8 +1952,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/gtkcssprovider.c b/gtk/gtkcssprovider.c
index 7461fbf..43383d0 100644
--- a/gtk/gtkcssprovider.c
+++ b/gtk/gtkcssprovider.c
@@ -3446,7 +3446,7 @@ gtk_css_provider_load_from_data (GtkCssProvider *css_provider,
* gtk_css_provider_load_from_file:
* @css_provider: a #GtkCssProvider
* @file: #GFile pointing to a file to load
- * @error: (out) (allow-none): return location for a #GError, or %NULL
+ * @error: return location for a #GError, or %NULL
*
* Loads the data contained in @file into @css_provider, making it
* clear any previously loaded information.
diff --git a/gtk/gtkdialog.c b/gtk/gtkdialog.c
index eb0eb5d..975a202 100644
--- a/gtk/gtkdialog.c
+++ b/gtk/gtkdialog.c
@@ -1322,7 +1322,8 @@ gtk_dialog_set_alternative_button_order (GtkDialog *dialog,
* gtk_dialog_set_alternative_button_order_from_array:
* @dialog: a #GtkDialog
* @n_params: the number of response ids in @new_order
- * @new_order: an array of response ids of @dialog's buttons
+ * @new_order: (array length=n_params): an array of response ids of
+ * @dialog's buttons
*
* Sets an alternative button order. If the
* #GtkSettings:gtk-alternative-button-order setting is set to %TRUE,
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/gtkeditable.c b/gtk/gtkeditable.c
index e85b1f1..f9be37e 100644
--- a/gtk/gtkeditable.c
+++ b/gtk/gtkeditable.c
@@ -113,10 +113,10 @@ gtk_editable_base_init (gpointer g_class)
* @new_text: the new text to insert
* @new_text_length: the length of the new text, in bytes,
* or -1 if new_text is nul-terminated
- * @position: the position, in characters, at which to insert
- * the new text. this is an in-out parameter.
- * After the signal emission is finished, it should
- * point after the newly inserted text.
+ * @position: (inout) (type int): the position, in characters,
+ * at which to insert the new text. this is an in-out
+ * parameter. After the signal emission is finished, it
+ * should point after the newly inserted text.
*
* This signal is emitted when text is inserted into
* the widget by the user. The default handler for
diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 0b905db..880db89 100644
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -6814,7 +6814,7 @@ gtk_entry_set_buffer (GtkEntry *entry,
/**
* gtk_entry_get_text_area:
* @entry: a #GtkEntry
- * @text_area: Return location for the text area.
+ * @text_area: (out): Return location for the text area.
*
* Gets the area where the entry's text is drawn. This function is
* useful when drawing something to the entry in a draw callback.
@@ -7485,8 +7485,8 @@ gtk_entry_text_index_to_layout_index (GtkEntry *entry,
/**
* gtk_entry_get_layout_offsets:
* @entry: a #GtkEntry
- * @x: (allow-none): location to store X offset of layout, or %NULL
- * @y: (allow-none): location to store Y offset of layout, or %NULL
+ * @x: (out) (allow-none): location to store X offset of layout, or %NULL
+ * @y: (out) (allow-none): location to store Y offset of layout, or %NULL
*
*
* Obtains the position of the #PangoLayout used to render text
@@ -8293,7 +8293,7 @@ gtk_entry_get_current_icon_drag_source (GtkEntry *entry)
* gtk_entry_get_icon_area:
* @entry: A #GtkEntry
* @icon_pos: Icon position
- * @icon_area: Return location for the icon's area
+ * @icon_area: (out): Return location for the icon's area
*
* Gets the area where entry's icon at @icon_pos is drawn.
* This function is useful when drawing something to the
diff --git a/gtk/gtkframe.c b/gtk/gtkframe.c
index 5e6e2fc..62e0dc1 100644
--- a/gtk/gtkframe.c
+++ b/gtk/gtkframe.c
@@ -522,8 +522,10 @@ gtk_frame_set_label_align (GtkFrame *frame,
/**
* gtk_frame_get_label_align:
* @frame: a #GtkFrame
- * @xalign: (allow-none): location to store X alignment of frame's label, or %NULL
- * @yalign: (allow-none): location to store X alignment of frame's label, or %NULL
+ * @xalign: (out) (allow-none): location to store X alignment of
+ * frame's label, or %NULL
+ * @yalign: (out) (allow-none): location to store X alignment of
+ * frame's label, or %NULL
*
* Retrieves the X and Y alignment of the frame's label. See
* gtk_frame_set_label_align().
diff --git a/gtk/gtkhsv.c b/gtk/gtkhsv.c
index 62356bc..427a7d5 100644
--- a/gtk/gtkhsv.c
+++ b/gtk/gtkhsv.c
@@ -1330,9 +1330,9 @@ gtk_hsv_set_color (GtkHSV *hsv,
/**
* gtk_hsv_get_color:
* @hsv: An HSV color selector
- * @h: Return value for the hue
- * @s: Return value for the saturation
- * @v: Return value for the value
+ * @h: (out): Return value for the hue
+ * @s: (out): Return value for the saturation
+ * @v: (out): Return value for the value
*
* Queries the current color in an HSV color selector.
* Returned values will be in the [0.0, 1.0] range.
@@ -1400,8 +1400,8 @@ gtk_hsv_set_metrics (GtkHSV *hsv,
/**
* gtk_hsv_get_metrics:
* @hsv: An HSV color selector
- * @size: Return value for the diameter of the hue ring
- * @ring_width: Return value for the width of the hue ring
+ * @size: (out): Return value for the diameter of the hue ring
+ * @ring_width: (out): Return value for the width of the hue ring
*
* Queries the size and ring width of an HSV color selector.
*
@@ -1457,9 +1457,9 @@ gtk_hsv_is_adjusting (GtkHSV *hsv)
* @h: Hue
* @s: Saturation
* @v: Value
- * @r: Return value for the red component
- * @g: Return value for the green component
- * @b: Return value for the blue component
+ * @r: (out): Return value for the red component
+ * @g: (out): Return value for the green component
+ * @b: (out): Return value for the blue component
*
* Converts a color from HSV space to RGB.
* Input values must be in the [0.0, 1.0] range;
@@ -1496,9 +1496,9 @@ gtk_hsv_to_rgb (gdouble h,
* @r: Red
* @g: Green
* @b: Blue
- * @h: Return value for the hue component
- * @s: Return value for the saturation component
- * @v: Return value for the value component
+ * @h: (out): Return value for the hue component
+ * @s: (out): Return value for the saturation component
+ * @v: (out): Return value for the value component
*
* Converts a color from RGB space to HSV.
* Input values must be in the [0.0, 1.0] range;
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/gtkicontheme.c b/gtk/gtkicontheme.c
index d4f2229..e35894a 100644
--- a/gtk/gtkicontheme.c
+++ b/gtk/gtkicontheme.c
@@ -688,7 +688,8 @@ gtk_icon_theme_finalize (GObject *object)
/**
* gtk_icon_theme_set_search_path:
* @icon_theme: a #GtkIconTheme
- * @path: array of directories that are searched for icon themes
+ * @path: (array length=n_elements) (element-type filename): array of
+ * directories that are searched for icon themes
* @n_elements: number of elements in @path.
*
* Sets the search path for the icon theme object. When looking
@@ -1438,7 +1439,8 @@ gtk_icon_theme_lookup_icon (GtkIconTheme *icon_theme,
/**
* gtk_icon_theme_choose_icon:
* @icon_theme: a #GtkIconTheme
- * @icon_names: %NULL-terminated array of icon names to lookup
+ * @icon_names: (array zero-terminated=1): %NULL-terminated array of
+ * icon names to lookup
* @size: desired icon size
* @flags: flags modifying the behavior of the icon lookup
*
@@ -1614,9 +1616,9 @@ add_size (gpointer key,
* that the icon is available in a scalable format. The array
* is zero-terminated.
*
- * Return value: An newly allocated array describing the sizes at
- * which the icon is available. The array should be freed with g_free()
- * when it is no longer needed.
+ * Return value: (array zero-terminated=1): An newly allocated array
+ * describing the sizes at which the icon is available. The array
+ * should be freed with g_free() when it is no longer needed.
*
* Since: 2.6
**/
@@ -3163,8 +3165,9 @@ _gtk_icon_info_load_symbolic_internal (GtkIconInfo *icon_info,
* of the icon or %NULL to use the default color
* @error_color: (allow-none): a #GdkRGBA representing the error color
* of the icon or %NULL to use the default color (allow-none)
- * @was_symbolic: (allow-none): a #gboolean, returns whether the loaded icon
- * was a symbolic one and whether the @fg color was applied to it.
+ * @was_symbolic: (out) (allow-none): a #gboolean, returns whether the
+ * loaded icon was a symbolic one and whether the @fg color was
+ * applied to it.
* @error: (allow-none): location to store error information on failure,
* or %NULL.
*
@@ -3246,8 +3249,9 @@ gtk_icon_info_load_symbolic (GtkIconInfo *icon_info,
* gtk_icon_info_load_symbolic_for_context:
* @icon_info: a #GtkIconInfo
* @context: a #GtkStyleContext
- * @was_symbolic: (allow-none): a #gboolean, returns whether the loaded icon
- * was a symbolic one and whether the @fg color was applied to it.
+ * @was_symbolic: (out) (allow-none): a #gboolean, returns whether the
+ * loaded icon was a symbolic one and whether the @fg color was
+ * applied to it.
* @error: (allow-none): location to store error information on failure,
* or %NULL.
*
@@ -3327,8 +3331,9 @@ gtk_icon_info_load_symbolic_for_context (GtkIconInfo *icon_info,
* @icon_info: a #GtkIconInfo
* @style: a #GtkStyle to take the colors from
* @state: the widget state to use for colors
- * @was_symbolic: (allow-none): a #gboolean, returns whether the loaded icon
- * was a symbolic one and whether the @fg color was applied to it.
+ * @was_symbolic: (out) (allow-none): a #gboolean, returns whether the
+ * loaded icon was a symbolic one and whether the @fg color was
+ * applied to it.
* @error: (allow-none): location to store error information on failure,
* or %NULL.
*
@@ -3462,7 +3467,7 @@ icon_info_scale_point (GtkIconInfo *icon_info,
/**
* gtk_icon_info_get_embedded_rect:
* @icon_info: a #GtkIconInfo
- * @rectangle: #GdkRectangle in which to store embedded
+ * @rectangle: (out): #GdkRectangle in which to store embedded
* rectangle coordinates; coordinates are only stored
* when this function returns %TRUE.
*
diff --git a/gtk/gtkiconview.c b/gtk/gtkiconview.c
index 522d864..cea7b10 100644
--- a/gtk/gtkiconview.c
+++ b/gtk/gtkiconview.c
@@ -1934,8 +1934,9 @@ gtk_icon_view_set_cursor (GtkIconView *icon_view,
/**
* gtk_icon_view_get_cursor:
* @icon_view: A #GtkIconView
- * @path: (allow-none): Return location for the current cursor path, or %NULL
- * @cell: (allow-none): Return location the current focus cell, or %NULL
+ * @path: (out) (allow-none): Return location for the current cursor path,
+ * or %NULL
+ * @cell: (out) (allow-none): Return location the current focus cell, or %NULL
*
* Fills in @path and @cell with the current cursor path and cell.
* If the cursor isn't currently set, then * path will be %NULL.
@@ -4202,8 +4203,8 @@ gtk_icon_view_new_with_model (GtkTreeModel *model)
* @icon_view: a #GtkIconView
* @wx: X coordinate relative to the widget
* @wy: Y coordinate relative to the widget
- * @bx: return location for bin_window X coordinate
- * @by: return location for bin_window Y coordinate
+ * @bx: (out): return location for bin_window X coordinate
+ * @by: (out): return location for bin_window Y coordinate
*
* Converts widget coordinates to coordinates for the bin_window,
* as expected by e.g. gtk_icon_view_get_path_at_pos().
@@ -4274,9 +4275,9 @@ gtk_icon_view_get_path_at_pos (GtkIconView *icon_view,
* @icon_view: A #GtkIconView.
* @x: The x position to be identified
* @y: The y position to be identified
- * @path: (allow-none): Return location for the path, or %NULL
- * @cell: Return location for the renderer responsible for the cell
- * at (@x, @y), or %NULL
+ * @path: (out) (allow-none): Return location for the path, or %NULL
+ * @cell: (out) (allow-none): Return location for the renderer
+ * responsible for the cell at (@x, @y), or %NULL
*
* Finds the path at the point (@x, @y), relative to bin_window coordinates.
* In contrast to gtk_icon_view_get_path_at_pos(), this function also
@@ -4407,8 +4408,8 @@ gtk_icon_view_set_tooltip_cell (GtkIconView *icon_view,
/**
* gtk_icon_view_get_tooltip_context:
* @icon_view: an #GtkIconView
- * @x: the x coordinate (relative to widget coordinates)
- * @y: the y coordinate (relative to widget coordinates)
+ * @x: (inout): the x coordinate (relative to widget coordinates)
+ * @y: (inout): the y coordinate (relative to widget coordinates)
* @keyboard_tip: whether this is a keyboard tooltip or not
* @model: (out) (allow-none): a pointer to receive a #GtkTreeModel or %NULL
* @path: (out) (allow-none): a pointer to receive a #GtkTreePath or %NULL
@@ -4585,8 +4586,9 @@ gtk_icon_view_get_tooltip_column (GtkIconView *icon_view)
/**
* gtk_icon_view_get_visible_range:
* @icon_view: A #GtkIconView
- * @start_path: (allow-none): Return location for start of region, or %NULL
- * @end_path: (allow-none): Return location for end of region, or %NULL
+ * @start_path: (out) (allow-none): Return location for start of region,
+ * or %NULL
+ * @end_path: (out) (allow-none): Return location for end of region, or %NULL
*
* Sets @start_path and @end_path to be the first and last visible path.
* Note that there may be invisible paths in between.
@@ -6718,8 +6720,9 @@ gtk_icon_view_set_drag_dest_item (GtkIconView *icon_view,
/**
* gtk_icon_view_get_drag_dest_item:
* @icon_view: a #GtkIconView
- * @path: (allow-none): Return location for the path of the highlighted item, or %NULL.
- * @pos: (allow-none): Return location for the drop position, or %NULL
+ * @path: (out) (allow-none): Return location for the path of
+ * the highlighted item, or %NULL.
+ * @pos: (out) (allow-none): Return location for the drop position, or %NULL
*
* Gets information about the item that is highlighted for feedback.
*
@@ -6749,8 +6752,9 @@ gtk_icon_view_get_drag_dest_item (GtkIconView *icon_view,
* @icon_view: a #GtkIconView
* @drag_x: the position to determine the destination item for
* @drag_y: the position to determine the destination item for
- * @path: (allow-none): Return location for the path of the item, or %NULL.
- * @pos: (allow-none): Return location for the drop position, or %NULL
+ * @path: (out) (allow-none): Return location for the path of the item,
+ * or %NULL.
+ * @pos: (out) (allow-none): Return location for the drop position, or %NULL
*
* Determines the destination item for a given position.
*
diff --git a/gtk/gtkimcontext.c b/gtk/gtkimcontext.c
index 245c59b..3569ba7 100644
--- a/gtk/gtkimcontext.c
+++ b/gtk/gtkimcontext.c
@@ -419,12 +419,12 @@ gtk_im_context_set_client_window (GtkIMContext *context,
/**
* gtk_im_context_get_preedit_string:
* @context: a #GtkIMContext
- * @str: location to store the retrieved string. The
- * string retrieved must be freed with g_free ().
- * @attrs: location to store the retrieved attribute list.
- * When you are done with this list, you must
- * unreference it with pango_attr_list_unref().
- * @cursor_pos: location to store position of cursor (in characters)
+ * @str: (out) (transfer full): location to store the retrieved
+ * string. The string retrieved must be freed with g_free().
+ * @attrs: (out) (transfer full): location to store the retrieved
+ * attribute list. When you are done with this list, you
+ * must unreference it with pango_attr_list_unref().
+ * @cursor_pos: (out): location to store position of cursor (in characters)
* within the preedit string.
*
* Retrieve the current preedit string for the input context,
@@ -620,12 +620,12 @@ gtk_im_context_set_surrounding (GtkIMContext *context,
/**
* gtk_im_context_get_surrounding:
* @context: a #GtkIMContext
- * @text: location to store a UTF-8 encoded string of text
- * holding context around the insertion point.
- * If the function returns %TRUE, then you must free
- * the result stored in this location with g_free().
- * @cursor_index: location to store byte index of the insertion cursor
- * within @text.
+ * @text: (out) (transfer full): location to store a UTF-8 encoded
+ * string of text holding context around the insertion point.
+ * If the function returns %TRUE, then you must free the result
+ * stored in this location with g_free().
+ * @cursor_index: (out) location to store byte index of the insertion
+ * cursor within @text.
*
* Retrieves context around the insertion point. Input methods
* typically want context in order to constrain input text based on
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index 7fff547..272e6de 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)
@@ -5468,8 +5469,8 @@ gtk_label_select_region (GtkLabel *label,
/**
* gtk_label_get_selection_bounds:
* @label: a #GtkLabel
- * @start: return location for start of selection, as a character offset
- * @end: return location for end of selection, as a character offset
+ * @start: (out): return location for start of selection, as a character offset
+ * @end: (out): return location for end of selection, as a character offset
*
* Gets the selected range of characters in the label, returning %TRUE
* if there's a selection.
@@ -5567,8 +5568,8 @@ gtk_label_get_layout (GtkLabel *label)
/**
* gtk_label_get_layout_offsets:
* @label: a #GtkLabel
- * @x: (allow-none): location to store X offset of layout, or %NULL
- * @y: (allow-none): location to store Y offset of layout, or %NULL
+ * @x: (out) (allow-none): location to store X offset of layout, or %NULL
+ * @y: (out) (allow-none): location to store Y offset of layout, or %NULL
*
* Obtains the coordinates where the label will draw the #PangoLayout
* representing the text in the label; useful to convert mouse events
diff --git a/gtk/gtklayout.c b/gtk/gtklayout.c
index 3cb0a82..f9ac989 100644
--- a/gtk/gtklayout.c
+++ b/gtk/gtklayout.c
@@ -582,8 +582,10 @@ gtk_layout_set_size (GtkLayout *layout,
/**
* gtk_layout_get_size:
* @layout: a #GtkLayout
- * @width: (allow-none): location to store the width set on @layout, or %NULL
- * @height: (allow-none): location to store the height set on @layout, or %NULL
+ * @width: (out) (allow-none): location to store the width set on
+ * @layout, or %NULL
+ * @height: (out) (allow-none): location to store the height set on
+ * @layout, or %NULL
*
* Gets the size that has been set on the layout, and that determines
* the total extents of the layout's scrollbar area. See
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index ae6980f..7004e15 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -975,12 +975,13 @@ gtk_get_option_group (gboolean open_default_display)
/**
* gtk_init_with_args:
* @argc: a pointer to the number of command line arguments
- * @argv: a pointer to the array of command line arguments
+ * @argv: (inout) (array length=argc): a pointer to the array of
+ * command line arguments
* @parameter_string: a string which is displayed in
* the first line of <option>--help</option> output, after
* <literal><replaceable>programname</replaceable> [OPTION...]</literal>
- * @entries: a %NULL-terminated array of #GOptionEntrys
- * describing the options of your program
+ * @entries: (array zero-terminated=1): a %NULL-terminated array
+ * of #GOptionEntrys describing the options of your program
* @translation_domain: a translation domain to use for translating
* the <option>--help</option> output for the options in @entries
* and the @parameter_string with gettext(), or %NULL
@@ -2384,9 +2385,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)
@@ -2417,7 +2418,7 @@ gtk_get_current_event_time (void)
/**
* gtk_get_current_event_state:
- * @state: a location to store the state of the current event
+ * @state: (out): a location to store the state of the current event
*
* If there is a current event and it has a state field, place
* that state field in @state and return %TRUE, otherwise return
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/gtkmisc.c b/gtk/gtkmisc.c
index bc24ae6..c35bd73 100644
--- a/gtk/gtkmisc.c
+++ b/gtk/gtkmisc.c
@@ -239,8 +239,8 @@ gtk_misc_set_alignment (GtkMisc *misc,
/**
* gtk_misc_get_alignment:
* @misc: a #GtkMisc
- * @xalign: (allow-none): location to store X alignment of @misc, or %NULL
- * @yalign: (allow-none): location to store Y alignment of @misc, or %NULL
+ * @xalign: (out) (allow-none): location to store X alignment of @misc, or %NULL
+ * @yalign: (out) (allow-none): location to store Y alignment of @misc, or %NULL
*
* Gets the X and Y alignment of the widget within its allocation.
* See gtk_misc_set_alignment().
@@ -300,8 +300,10 @@ gtk_misc_set_padding (GtkMisc *misc,
/**
* gtk_misc_get_padding:
* @misc: a #GtkMisc
- * @xpad: (allow-none): location to store padding in the X direction, or %NULL
- * @ypad: (allow-none): location to store padding in the Y direction, or %NULL
+ * @xpad: (out) (allow-none): location to store padding in the X
+ * direction, or %NULL
+ * @ypad: (out) (allow-none): location to store padding in the Y
+ * direction, or %NULL
*
* Gets the padding in the X and Y directions of the widget.
* See gtk_misc_set_padding().
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..d37278c 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
*/
@@ -383,10 +383,10 @@ gtk_print_context_get_dpi_y (GtkPrintContext *context)
/**
* gtk_print_context_get_hard_margins:
* @context: a #GtkPrintContext
- * @top: top hardware printer margin
- * @bottom: bottom hardware printer margin
- * @left: left hardware printer margin
- * @right: right hardware printer margin
+ * @top: (out): top hardware printer margin
+ * @bottom: (out): bottom hardware printer margin
+ * @left: (out): left hardware printer margin
+ * @right: (out): right hardware printer margin
*
* Obtains the hardware printer margins of the #GtkPrintContext, in units.
*
diff --git a/gtk/gtkprinter.c b/gtk/gtkprinter.c
index 4d5112b..95df2f0 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
*/
@@ -994,10 +994,10 @@ gtk_printer_get_default_page_size (GtkPrinter *printer)
/**
* gtk_printer_get_hard_margins:
* @printer: a #GtkPrinter
- * @top: a location to store the top margin in
- * @bottom: a location to store the bottom margin in
- * @left: a location to store the left margin in
- * @right: a location to store the right margin in
+ * @top: (out): a location to store the top margin in
+ * @bottom: (out): a location to store the bottom margin in
+ * @left: (out): a location to store the left margin in
+ * @right: (out): a location to store the right margin in
*
* Retrieve the hard margins of @printer, i.e. the margins that define
* the area at the borders of the paper that the printer cannot print to.
diff --git a/gtk/gtkprintjob.c b/gtk/gtkprintjob.c
index d37e122..fc9407c 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
**/
@@ -749,7 +749,8 @@ gtk_print_job_set_pages (GtkPrintJob *job,
*
* Gets the page ranges for this job.
*
- * Returns: a pointer to an array of #GtkPageRange structs
+ * Returns: (array length=n_ranges) (transfer none): a pointer to an
+ * array of #GtkPageRange structs
*
* Since: 3.0
*/
@@ -764,7 +765,9 @@ gtk_print_job_get_page_ranges (GtkPrintJob *job,
/**
* gtk_print_job_set_page_ranges:
* @job: a #GtkPrintJob
- * @ranges: pointer to an array of #GtkPageRange structs
+
+ * @ranges: (array length=n_ranges): pointer to an array of
+ * #GtkPageRange structs
* @n_ranges: the length of the @ranges array
*
* Sets the page ranges for this job.
diff --git a/gtk/gtkprintoperation-unix.c b/gtk/gtkprintoperation-unix.c
index 2431371..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
*/
@@ -999,7 +999,8 @@ gtk_print_run_page_setup_dialog (GtkWindow *parent,
* @parent: (allow-none): transient parent, or %NULL
* @page_setup: (allow-none): an existing #GtkPageSetup, or %NULL
* @settings: a #GtkPrintSettings
- * @done_cb: a function to call when the user saves the modified page setup
+ * @done_cb: (scope async): a function to call when the user saves
+ * the modified page setup
* @data: user data to pass to @done_cb
*
* Runs a page setup dialog, letting the user modify the values from @page_setup.
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/gtkprintsettings.c b/gtk/gtkprintsettings.c
index 7507bd7..da3d60d 100644
--- a/gtk/gtkprintsettings.c
+++ b/gtk/gtkprintsettings.c
@@ -1409,12 +1409,13 @@ gtk_print_settings_set_print_pages (GtkPrintSettings *settings,
/**
* gtk_print_settings_get_page_ranges:
* @settings: a #GtkPrintSettings
- * @num_ranges: return location for the length of the returned array
+ * @num_ranges: (out): return location for the length of the returned array
*
* Gets the value of %GTK_PRINT_SETTINGS_PAGE_RANGES.
*
- * Return value: (transfer full): an array of #GtkPageRange<!-- -->s.
- * Use g_free() to free the array when it is no longer needed.
+ * Return value: (array length=num_ranges) (transfer full): an array
+ * of #GtkPageRange<!-- -->s. Use g_free() to free the array when
+ * it is no longer needed.
*
* Since: 2.10
*/
@@ -1471,7 +1472,7 @@ gtk_print_settings_get_page_ranges (GtkPrintSettings *settings,
/**
* gtk_print_settings_set_page_ranges:
* @settings: a #GtkPrintSettings
- * @page_ranges: an array of #GtkPageRange<!-- -->s
+ * @page_ranges: (array length=num_ranges): an array of #GtkPageRange<!-- -->s
* @num_ranges: the length of @page_ranges
*
* Sets the value of %GTK_PRINT_SETTINGS_PAGE_RANGES.
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..c2380d7 100644
--- a/gtk/gtkradiobutton.c
+++ b/gtk/gtkradiobutton.c
@@ -403,8 +403,8 @@ gtk_radio_button_join_group (GtkRadioButton *radio_button,
/**
* gtk_radio_button_new:
- * @group: (allow-none): an existing radio button group, or %NULL if you are
- * creating a new group.
+ * @group: (element-type GtkRadioButton) (allow-none): an existing
+ * radio button group, or %NULL if you are creating a new group.
*
* Creates a new #GtkRadioButton. To be of any practical value, a widget should
* then be packed into the radio button.
@@ -426,13 +426,13 @@ gtk_radio_button_new (GSList *group)
/**
* gtk_radio_button_new_with_label:
- * @group: (allow-none): an existing radio button group, or %NULL if you are
- * creating a new group.
+ * @group: (element-type GtkRadioButton) (allow-none): an existing
+ * radio button group, or %NULL if you are creating a new group.
* @label: the text label to display next to the radio button.
*
* 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,
@@ -451,7 +451,8 @@ gtk_radio_button_new_with_label (GSList *group,
/**
* gtk_radio_button_new_with_mnemonic:
- * @group: (allow-none): the radio button group
+ * @group: (element-type GtkRadioButton) (allow-none): the radio button
+ * group
* @label: the text of the button, with an underscore in front of the
* mnemonic character
*
@@ -460,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/gtkradiomenuitem.c b/gtk/gtkradiomenuitem.c
index 709147f..8da604d 100644
--- a/gtk/gtkradiomenuitem.c
+++ b/gtk/gtkradiomenuitem.c
@@ -331,7 +331,8 @@ gtk_radio_menu_item_new_with_label_from_widget (GtkRadioMenuItem *group,
* Returns the group to which the radio menu item belongs, as a #GList of
* #GtkRadioMenuItem. The list belongs to GTK+ and should not be freed.
*
- * Returns: (transfer none): the group of @radio_menu_item
+ * Returns: (element-type GtkRadioMenuItem) (transfer none): the group
+ * of @radio_menu_item
*/
GSList*
gtk_radio_menu_item_get_group (GtkRadioMenuItem *radio_menu_item)
diff --git a/gtk/gtkrange.c b/gtk/gtkrange.c
index 91431e1..5d67ae3 100644
--- a/gtk/gtkrange.c
+++ b/gtk/gtkrange.c
@@ -1030,7 +1030,7 @@ gtk_range_get_min_slider_size (GtkRange *range)
/**
* gtk_range_get_range_rect:
* @range: a #GtkRange
- * @range_rect: return location for the range rectangle
+ * @range_rect: (out): return location for the range rectangle
*
* This function returns the area that contains the range's trough
* and its steppers, in widget->window coordinates.
@@ -1058,8 +1058,10 @@ gtk_range_get_range_rect (GtkRange *range,
/**
* gtk_range_get_slider_range:
* @range: a #GtkRange
- * @slider_start: (allow-none): return location for the slider's start, or %NULL
- * @slider_end: (allow-none): return location for the slider's end, or %NULL
+ * @slider_start: (out) (allow-none): return location for the slider's
+ * start, or %NULL
+ * @slider_end: (out) (allow-none): return location for the slider's
+ * end, or %NULL
*
* This function returns sliders range along the long dimension,
* in widget->window coordinates.
diff --git a/gtk/gtkrc.c b/gtk/gtkrc.c
index 5e37a56..68b2240 100644
--- a/gtk/gtkrc.c
+++ b/gtk/gtkrc.c
@@ -365,9 +365,10 @@ gtk_rc_set_default_files (gchar **filenames)
* Retrieves the current list of RC files that will be parsed
* at the end of gtk_init().
*
- * Return value: (transfer none): A %NULL-terminated array of filenames.
- * This memory is owned by GTK+ and must not be freed by the application.
- * If you want to store this information, you should make a copy.
+ * Return value: (transfer none) (array zero-terminated=1) (element-type filename):
+ * A %NULL-terminated array of filenames. This memory is owned
+ * by GTK+ and must not be freed by the application. If you want
+ * to store this information, you should make a copy.
*
* Deprecated:3.0: Use #GtkStyleContext instead
**/
@@ -967,7 +968,7 @@ gtk_rc_find_module_in_path (const gchar *module_file)
/**
* gtk_rc_parse_state:
* @scanner:
- * @state:
+ * @state: (out):
*
* Deprecated:3.0: Use #GtkCssProvider instead
*/
@@ -1025,7 +1026,7 @@ gtk_rc_parse_state (GScanner *scanner,
/**
* gtk_rc_parse_priority:
* @scanner:
- * @priority:
+ * @priority: (out):
*
* Deprecated:3.0: Use #GtkCssProvider instead
*/
@@ -1082,7 +1083,8 @@ gtk_rc_parse_priority (GScanner *scanner,
/**
* gtk_rc_parse_color:
* @scanner: a #GScanner
- * @color: a pointer to a #GdkColor structure in which to store the result
+ * @color: (out): a pointer to a #GdkColor structure in which to store
+ * the result
*
* Parses a color in the <link linkend="color=format">format</link> expected
* in a RC file.
@@ -1106,7 +1108,8 @@ gtk_rc_parse_color (GScanner *scanner,
* gtk_rc_parse_color_full:
* @scanner: a #GScanner
* @style: (allow-none): a #GtkRcStyle, or %NULL
- * @color: a pointer to a #GdkColor structure in which to store the result
+ * @color: (out): a pointer to a #GdkColor structure in which to store
+ * the result
*
* Parses a color in the <link linkend="color=format">format</link> expected
* in a RC file. If @style is not %NULL, it will be consulted to resolve
diff --git a/gtk/gtkrecentchooser.c b/gtk/gtkrecentchooser.c
index 6011ba6..b6873ec 100644
--- a/gtk/gtkrecentchooser.c
+++ b/gtk/gtkrecentchooser.c
@@ -859,8 +859,9 @@ gtk_recent_chooser_get_items (GtkRecentChooser *chooser)
*
* Since the returned array is %NULL terminated, @length may be %NULL.
*
- * Return value: (transfer full): A newly allocated, %NULL-terminated array
- * of strings. Use g_strfreev() to free it.
+ * Return value: (array length=length zero-terminated=1) (transfer full):
+ * A newly allocated, %NULL-terminated array of strings. Use
+ * g_strfreev() to free it.
*
* Since: 2.10
*/
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/gtkscale.c b/gtk/gtkscale.c
index 486e647..6b878b9 100644
--- a/gtk/gtkscale.c
+++ b/gtk/gtkscale.c
@@ -1400,8 +1400,8 @@ gtk_scale_get_layout (GtkScale *scale)
/**
* gtk_scale_get_layout_offsets:
* @scale: a #GtkScale
- * @x: (allow-none): location to store X offset of layout, or %NULL
- * @y: (allow-none): location to store Y offset of layout, or %NULL
+ * @x: (out) (allow-none): location to store X offset of layout, or %NULL
+ * @y: (out) (allow-none): location to store Y offset of layout, or %NULL
*
* Obtains the coordinates where the scale will draw the
* #PangoLayout representing the text in the scale. Remember
diff --git a/gtk/gtkscalebutton.c b/gtk/gtkscalebutton.c
index 7be5660..a688705 100644
--- a/gtk/gtkscalebutton.c
+++ b/gtk/gtkscalebutton.c
@@ -559,8 +559,9 @@ gtk_scale_button_dispose (GObject *object)
* @max: the maximum value of the scale (usually 100)
* @step: the stepping of value when a scroll-wheel event,
* or up/down arrow event occurs (usually 2)
- * @icons: (allow-none): a %NULL-terminated array of icon names, or %NULL if
- * you want to set the list later with gtk_scale_button_set_icons()
+ * @icons: (allow-none) (array zero-terminated=1): a %NULL-terminated
+ * array of icon names, or %NULL if you want to set the list
+ * later with gtk_scale_button_set_icons()
*
* Creates a #GtkScaleButton, with a range between @min and @max, with
* a stepping of @step.
@@ -640,7 +641,7 @@ gtk_scale_button_set_value (GtkScaleButton *button,
/**
* gtk_scale_button_set_icons:
* @button: a #GtkScaleButton
- * @icons: a %NULL-terminated array of icon names
+ * @icons: (array zero-terminated=1): a %NULL-terminated array of icon names
*
* Sets the icons to be used by the scale button.
* For details, see the #GtkScaleButton:icons property.
diff --git a/gtk/gtkscrolledwindow.c b/gtk/gtkscrolledwindow.c
index f4a0299..c8f4539 100644
--- a/gtk/gtkscrolledwindow.c
+++ b/gtk/gtkscrolledwindow.c
@@ -796,10 +796,10 @@ gtk_scrolled_window_set_policy (GtkScrolledWindow *scrolled_window,
/**
* gtk_scrolled_window_get_policy:
* @scrolled_window: a #GtkScrolledWindow
- * @hscrollbar_policy: location to store the policy for the horizontal
- * scrollbar, or %NULL.
- * @vscrollbar_policy: location to store the policy for the vertical
- * scrollbar, or %NULL.
+ * @hscrollbar_policy: (out) (allow-none): location to store the policy
+ * for the horizontal scrollbar, or %NULL.
+ * @vscrollbar_policy: (out) (allow-none): location to store the policy
+ * for the vertical scrollbar, or %NULL.
*
* Retrieves the current policy values for the horizontal and vertical
* scrollbars. See gtk_scrolled_window_set_policy().
diff --git a/gtk/gtkselection.c b/gtk/gtkselection.c
index 67bc241..daa5081 100644
--- a/gtk/gtkselection.c
+++ b/gtk/gtkselection.c
@@ -216,12 +216,12 @@ static const char gtk_selection_handler_key[] = "gtk-selection-handlers";
/**
* gtk_target_list_new:
- * @targets: Pointer to an array of #GtkTargetEntry
- * @ntargets: number of entries in @targets.
+ * @targets: (array length=ntargets): Pointer to an array of #GtkTargetEntry
+ * @ntargets: number of entries in @targets.
*
* 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,
@@ -499,7 +499,7 @@ gtk_target_list_add_uri_targets (GtkTargetList *list,
/**
* gtk_target_list_add_table:
* @list: a #GtkTargetList
- * @targets: the table of #GtkTargetEntry
+ * @targets: (array length=ntargets): the table of #GtkTargetEntry
* @ntargets: number of targets in the table
*
* Prepends a table of #GtkTargetEntry to a target list.
@@ -598,14 +598,14 @@ gtk_target_list_find (GtkTargetList *list,
/**
* gtk_target_table_new_from_list:
* @list: a #GtkTargetList
- * @n_targets: return location for the number ot targets in the table
+ * @n_targets: (out): return location for the number ot targets in the table
*
* This function creates an #GtkTargetEntry array that contains the
* same targets as the passed %list. The returned table is newly
* allocated and should be freed using gtk_target_table_free() when no
* longer needed.
*
- * Return value: the new table.
+ * Return value: (array length=n_targets) (transfer full): the new table.
*
* Since: 2.10
**/
@@ -639,7 +639,7 @@ gtk_target_table_new_from_list (GtkTargetList *list,
/**
* gtk_target_table_free:
- * @targets: a #GtkTargetEntry array
+ * @targets: (array length=n_targets): a #GtkTargetEntry array
* @n_targets: the number of entries in the array
*
* This function frees a target table as returned by
@@ -931,7 +931,7 @@ gtk_selection_add_target (GtkWidget *widget,
* gtk_selection_add_targets:
* @widget: a #GtkWidget
* @selection: the selection
- * @targets: a table of targets to add
+ * @targets: (array length=ntargets): a table of targets to add
* @ntargets: number of entries in @targets
*
* Prepends a table of targets to the list of supported 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
**/
@@ -1251,7 +1251,7 @@ gtk_selection_data_get_length (const GtkSelectionData *selection_data)
/**
* gtk_selection_data_get_data_with_length:
* @selection_data: a pointer to a #GtkSelectionData structure
- * @length: return location for length of the data segment
+ * @length: (out): return location for length of the data segment
*
* Retrieves the raw data of the selection along with its length.
*
@@ -1752,7 +1752,8 @@ gtk_selection_data_get_pixbuf (const GtkSelectionData *selection_data)
/**
* gtk_selection_data_set_uris:
* @selection_data: a #GtkSelectionData
- * @uris: a %NULL-terminated array of strings holding URIs
+ * @uris: (array zero-terminated=1): a %NULL-terminated array of
+ * strings holding URIs
*
* Sets the contents of the selection from a list of URIs.
* The string is converted to the form determined by
@@ -1852,8 +1853,9 @@ gtk_selection_data_get_uris (const GtkSelectionData *selection_data)
/**
* gtk_selection_data_get_targets:
* @selection_data: a #GtkSelectionData object
- * @targets: location to store an array of targets. The result
- * stored here must be freed with g_free().
+ * @targets: (out) (array length=n_atoms) (transfer container):
+ * location to store an array of targets. The result stored
+ * here must be freed with g_free().
* @n_atoms: location to store number of items in @targets.
*
* Gets the contents of @selection_data as an array of targets.
@@ -1895,7 +1897,7 @@ gtk_selection_data_get_targets (const GtkSelectionData *selection_data,
/**
* gtk_targets_include_text:
- * @targets: an array of #GdkAtom<!-- -->s
+ * @targets: (array length=n_targets): an array of #GdkAtom<!-- -->s
* @n_targets: the length of @targets
*
* Determines if any of the targets in @targets can be used to
@@ -1940,7 +1942,7 @@ gtk_targets_include_text (GdkAtom *targets,
/**
* gtk_targets_include_rich_text:
- * @targets: an array of #GdkAtom<!-- -->s
+ * @targets: (array length=n_targets): an array of #GdkAtom<!-- -->s
* @n_targets: the length of @targets
* @buffer: a #GtkTextBuffer
*
@@ -2058,7 +2060,7 @@ gtk_selection_data_targets_include_rich_text (const GtkSelectionData *selection_
/**
* gtk_targets_include_image:
- * @targets: an array of #GdkAtom<!-- -->s
+ * @targets: (array length=n_targets): an array of #GdkAtom<!-- -->s
* @n_targets: the length of @targets
* @writable: whether to accept only targets for which GTK+ knows
* how to convert a pixbuf into the format
@@ -2140,7 +2142,7 @@ gtk_selection_data_targets_include_image (const GtkSelectionData *selection_data
/**
* gtk_targets_include_uri:
- * @targets: an array of #GdkAtom<!-- -->s
+ * @targets: (array length=n_targets): an array of #GdkAtom<!-- -->s
* @n_targets: the length of @targets
*
* Determines if any of the targets in @targets can be used to
diff --git a/gtk/gtkspinbutton.c b/gtk/gtkspinbutton.c
index 5ba8036..e317968 100644
--- a/gtk/gtkspinbutton.c
+++ b/gtk/gtkspinbutton.c
@@ -397,7 +397,7 @@ gtk_spin_button_class_init (GtkSpinButtonClass *class)
/**
* GtkSpinButton::input:
* @spin_button: the object on which the signal was emitted
- * @new_value: return location for the new value
+ * @new_value: (out) (type double): return location for the new value
*
* The ::input signal can be used to influence the conversion of
* the users input into a double value. The signal handler is
@@ -2133,8 +2133,8 @@ gtk_spin_button_set_increments (GtkSpinButton *spin_button,
/**
* gtk_spin_button_get_increments:
* @spin_button: a #GtkSpinButton
- * @step: (allow-none): location to store step increment, or %NULL
- * @page: (allow-none): location to store page increment, or %NULL
+ * @step: (out) (allow-none): location to store step increment, or %NULL
+ * @page: (out) (allow-none): location to store page increment, or %NULL
*
* Gets the current step and page the increments used by @spin_button. See
* gtk_spin_button_set_increments().
@@ -2187,8 +2187,8 @@ gtk_spin_button_set_range (GtkSpinButton *spin_button,
/**
* gtk_spin_button_get_range:
* @spin_button: a #GtkSpinButton
- * @min: (allow-none): location to store minimum allowed value, or %NULL
- * @max: (allow-none): location to store maximum allowed value, or %NULL
+ * @min: (out) (allow-none): location to store minimum allowed value, or %NULL
+ * @max: (out) (allow-none): location to store maximum allowed value, or %NULL
*
* Gets the range allowed for @spin_button.
* See gtk_spin_button_set_range().
diff --git a/gtk/gtkstatusicon.c b/gtk/gtkstatusicon.c
index 6e0751e..c4c0533 100644
--- a/gtk/gtkstatusicon.c
+++ b/gtk/gtkstatusicon.c
@@ -2337,11 +2337,12 @@ gtk_status_icon_is_embedded (GtkStatusIcon *status_icon)
/**
* gtk_status_icon_position_menu:
* @menu: the #GtkMenu
- * @x: return location for the x position
- * @y: return location for the y position
- * @push_in: whether the first menu item should be offset (pushed in) to be
- * aligned with the menu popup position (only useful for GtkOptionMenu).
- * @user_data: the status icon to position the menu on
+ * @x: (out): return location for the x position
+ * @y: (out): return location for the y position
+ * @push_in: (out): whether the first menu item should be offset
+ * (pushed in) to be aligned with the menu popup position
+ * (only useful for GtkOptionMenu).
+ * @user_data: (type GtkStatusIcon): the status icon to position the menu on
*
* Menu positioning function to use with gtk_menu_popup()
* to position @menu aligned to the status icon @user_data.
diff --git a/gtk/gtkstock.c b/gtk/gtkstock.c
index d697719..fb8deff 100644
--- a/gtk/gtkstock.c
+++ b/gtk/gtkstock.c
@@ -122,7 +122,7 @@ real_add (const GtkStockItem *items,
/**
* gtk_stock_add:
- * @items: a #GtkStockItem or array of items
+ * @items: (array length=n_items): a #GtkStockItem or array of items
* @n_items: number of #GtkStockItem in @items
*
* Registers each of the stock items in @items. If an item already
@@ -144,7 +144,7 @@ gtk_stock_add (const GtkStockItem *items,
/**
* gtk_stock_add_static:
- * @items: a #GtkStockItem or array of #GtkStockItem
+ * @items: (array length=n_items): a #GtkStockItem or array of #GtkStockItem
* @n_items: number of items
*
* Same as gtk_stock_add(), but doesn't copy @items, so
@@ -163,7 +163,7 @@ gtk_stock_add_static (const GtkStockItem *items,
/**
* gtk_stock_lookup:
* @stock_id: a stock item name
- * @item: stock item to initialize with values
+ * @item: (out): stock item to initialize with values
*
* Fills @item with the registered values for @stock_id, returning %TRUE
* if @stock_id was known.
diff --git a/gtk/gtkstyle.c b/gtk/gtkstyle.c
index 9fd3bfb..dd445ec 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
*/
@@ -944,7 +944,7 @@ gtk_style_lookup_icon_set (GtkStyle *style,
* gtk_style_lookup_color:
* @style: a #GtkStyle
* @color_name: the name of the logical color to look up
- * @color: the #GdkColor to fill in
+ * @color: (out): the #GdkColor to fill in
*
* Looks up @color_name in the style's logical color mappings,
* filling in @color and returning %TRUE if found, otherwise
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/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..bdd374b 100644
--- a/gtk/gtktestutils.c
+++ b/gtk/gtktestutils.c
@@ -39,7 +39,8 @@
* gtk_test_init:
* @argcp: Address of the <parameter>argc</parameter> parameter of the
* main() function. Changed if any arguments were handled.
- * @argvp: Address of the <parameter>argv</parameter> parameter of main().
+ * @argvp: (inout) (array length=argcp): Address of the
+ * <parameter>argv</parameter> parameter of main().
* Any parameters understood by g_test_init() or gtk_init() are
* stripped before return.
* @Varargs: currently unused
@@ -230,7 +231,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 +334,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 +376,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 +621,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
**/
@@ -642,7 +643,8 @@ static guint n_all_registered_types = 0;
/**
* gtk_test_list_all_types
* @n_types: location to store number of types
- * @returns: 0-terminated array of type ids
+ * @returns: (array length=n_types zero-terminated=1) (transfer none):
+ * 0-terminated array of type ids
*
* Return the type ids that have been registered after
* calling gtk_test_register_all_types().
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..e4e6836 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
**/
@@ -408,8 +408,8 @@ gtk_text_buffer_deserialize_get_can_create_tags (GtkTextBuffer *buffer,
* with @buffer using gtk_text_buffer_register_serialize_format() or
* gtk_text_buffer_register_serialize_tagset()
*
- * Return value: an array of #GdkAtom<!-- -->s representing the registered
- * formats.
+ * Return value: (array length=n_formats) (transfer container): an array of
+ * #GdkAtom<!-- -->s representing the registered formats.
*
* Since: 2.10
**/
@@ -436,8 +436,8 @@ gtk_text_buffer_get_serialize_formats (GtkTextBuffer *buffer,
* with @buffer using gtk_text_buffer_register_deserialize_format() or
* gtk_text_buffer_register_deserialize_tagset()
*
- * Return value: an array of #GdkAtom<!-- -->s representing the registered
- * formats.
+ * Return value: (array length=n_formats) (transfer container): an array of
+ * #GdkAtom<!-- -->s representing the registered formats.
*
* Since: 2.10
**/
@@ -471,7 +471,8 @@ gtk_text_buffer_get_deserialize_formats (GtkTextBuffer *buffer,
* gtk_text_buffer_register_serialize_format() or
* gtk_text_buffer_register_serialize_tagset() beforehand.
*
- * Return value: the serialized data, encoded as @format
+ * Return value: (array length=length) (transfer full): the serialized
+ * data, encoded as @format
*
* Since: 2.10
**/
@@ -520,7 +521,7 @@ gtk_text_buffer_serialize (GtkTextBuffer *register_buffer,
* @content_buffer: the #GtkTextBuffer to deserialize into
* @format: the rich text format to use for deserializing
* @iter: insertion point for the deserialized text
- * @data: data to deserialize
+ * @data: (array length=length): data to deserialize
* @length: length of @data
* @error: return location for a #GError
*
diff --git a/gtk/gtktextiter.c b/gtk/gtktextiter.c
index 6ee68bd..51c8f8f 100644
--- a/gtk/gtktextiter.c
+++ b/gtk/gtktextiter.c
@@ -1717,7 +1717,7 @@ gtk_text_iter_get_bytes_in_line (const GtkTextIter *iter)
/**
* gtk_text_iter_get_attributes:
* @iter: an iterator
- * @values: a #GtkTextAttributes to be filled in
+ * @values: (out): a #GtkTextAttributes to be filled in
*
* Computes the effect of any tags applied to this spot in the
* text. The @values parameter should be initialized to the default
diff --git a/gtk/gtktextview.c b/gtk/gtktextview.c
index f06250c..319da16 100644
--- a/gtk/gtktextview.c
+++ b/gtk/gtktextview.c
@@ -2293,7 +2293,7 @@ gtk_text_view_move_mark_onscreen (GtkTextView *text_view,
/**
* gtk_text_view_get_visible_rect:
* @text_view: a #GtkTextView
- * @visible_rect: rectangle to fill
+ * @visible_rect: (out): rectangle to fill
*
* Fills @visible_rect with the currently-visible
* region of the buffer, in buffer coordinates. Convert to window coordinates
diff --git a/gtk/gtkthemingengine.c b/gtk/gtkthemingengine.c
index e2e78e4..80e4be1 100644
--- a/gtk/gtkthemingengine.c
+++ b/gtk/gtkthemingengine.c
@@ -392,9 +392,9 @@ gtk_theming_engine_register_property (const gchar *name_space,
* @engine: a #GtkThemingEngine
* @property: the property name
* @state: state to retrieve the value for
- * @value: (out) (transfer full): return location for the property value,
- * you must free this memory using g_value_unset() once you are
- * done with it.
+ * @value: (out): return location for the property value, you must
+ * free this memory using g_value_unset() once you are done
+ * with it.
*
* Gets a property value as retrieved from the style settings that apply
* to the currently rendered element.
@@ -473,7 +473,7 @@ gtk_theming_engine_get (GtkThemingEngine *engine,
* gtk_theming_engine_get_style_property:
* @engine: a #GtkThemingEngine
* @property_name: the name of the widget style property
- * @value: (out) (transfer full): Return location for the property value, free with
+ * @value: Return location for the property value, free with
* g_value_unset() after use.
*
* Gets the value for a widget style property.
@@ -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/gtktreednd.c b/gtk/gtktreednd.c
index 68cc171..367fbd6 100644
--- a/gtk/gtktreednd.c
+++ b/gtk/gtktreednd.c
@@ -159,7 +159,8 @@ gtk_tree_drag_source_drag_data_delete (GtkTreeDragSource *drag_source,
* gtk_tree_drag_source_drag_data_get:
* @drag_source: a #GtkTreeDragSource
* @path: row that was dragged
- * @selection_data: a #GtkSelectionData to fill with data from the dragged row
+ * @selection_data: (out): a #GtkSelectionData to fill with data
+ * from the dragged row
*
* Asks the #GtkTreeDragSource to fill in @selection_data with a
* representation of the row at @path. @selection_data->target gives
@@ -306,8 +307,8 @@ gtk_tree_set_row_drag_data (GtkSelectionData *selection_data,
/**
* gtk_tree_get_row_drag_data:
* @selection_data: a #GtkSelectionData
- * @tree_model: a #GtkTreeModel
- * @path: row in @tree_model
+ * @tree_model: (out): a #GtkTreeModel
+ * @path: (out): row in @tree_model
*
* Obtains a @tree_model and @path from selection data of target type
* %GTK_TREE_MODEL_ROW. Normally called from a drag_data_received handler.
diff --git a/gtk/gtktreemodelfilter.c b/gtk/gtktreemodelfilter.c
index 18e0d59..37886ba 100644
--- a/gtk/gtktreemodelfilter.c
+++ b/gtk/gtktreemodelfilter.c
@@ -3171,7 +3171,7 @@ gtk_tree_model_filter_set_visible_func (GtkTreeModelFilter *filter,
* gtk_tree_model_filter_set_modify_func:
* @filter: A #GtkTreeModelFilter.
* @n_columns: The number of columns in the filter model.
- * @types: The #GType<!-- -->s of the columns.
+ * @types: (array length=n_columns): The #GType<!-- -->s of the columns.
* @func: A #GtkTreeModelFilterModifyFunc
* @data: (allow-none): User data to pass to the modify function, or %NULL.
* @destroy: (allow-none): Destroy notifier of @data, or %NULL.
diff --git a/gtk/gtktreeview.c b/gtk/gtktreeview.c
index 7014f67..5b70479 100644
--- a/gtk/gtktreeview.c
+++ b/gtk/gtktreeview.c
@@ -13583,7 +13583,7 @@ gtk_tree_view_get_cell_area_y_offset (GtkTreeView *tree_view,
* @tree_view: a #GtkTreeView
* @path: (allow-none): a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
* @column: (allow-none): a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordinates
- * @rect: rectangle to fill with cell rect
+ * @rect: (out): rectangle to fill with cell rect
*
* Fills the bounding rectangle in bin_window coordinates for the cell at the
* row specified by @path and the column specified by @column. If @path is
@@ -13716,7 +13716,7 @@ gtk_tree_view_get_row_y_offset (GtkTreeView *tree_view,
* @tree_view: a #GtkTreeView
* @path: (allow-none): a #GtkTreePath for the row, or %NULL to get only horizontal coordinates
* @column: (allow-none): a #GtkTreeViewColumn for the column, or %NULL to get only vertical coordiantes
- * @rect: rectangle to fill with cell background rect
+ * @rect: (out): rectangle to fill with cell background rect
*
* Fills the bounding rectangle in bin_window coordinates for the cell at the
* row specified by @path and the column specified by @column. If @path is
@@ -13771,7 +13771,7 @@ gtk_tree_view_get_background_area (GtkTreeView *tree_view,
/**
* gtk_tree_view_get_visible_rect:
* @tree_view: a #GtkTreeView
- * @visible_rect: rectangle to fill
+ * @visible_rect: (out): rectangle to fill
*
* Fills @visible_rect with the currently-visible region of the
* buffer, in tree coordinates. Convert to bin_window coordinates with
@@ -13805,8 +13805,8 @@ gtk_tree_view_get_visible_rect (GtkTreeView *tree_view,
* @tree_view: a #GtkTreeView
* @wx: X coordinate relative to the widget
* @wy: Y coordinate relative to the widget
- * @tx: return location for tree X coordinate
- * @ty: return location for tree Y coordinate
+ * @tx: (out): return location for tree X coordinate
+ * @ty: (out): return location for tree Y coordinate
*
* Converts widget coordinates to coordinates for the
* tree (the full scrollable area of the tree).
@@ -13837,8 +13837,8 @@ gtk_tree_view_convert_widget_to_tree_coords (GtkTreeView *tree_view,
* @tree_view: a #GtkTreeView
* @tx: X coordinate relative to the tree
* @ty: Y coordinate relative to the tree
- * @wx: return location for widget X coordinate
- * @wy: return location for widget Y coordinate
+ * @wx: (out): return location for widget X coordinate
+ * @wy: (out): return location for widget Y coordinate
*
* Converts tree coordinates (coordinates in full scrollable area of the tree)
* to widget coordinates.
@@ -13869,8 +13869,8 @@ gtk_tree_view_convert_tree_to_widget_coords (GtkTreeView *tree_view,
* @tree_view: a #GtkTreeView
* @wx: X coordinate relative to the widget
* @wy: Y coordinate relative to the widget
- * @bx: return location for bin_window X coordinate
- * @by: return location for bin_window Y coordinate
+ * @bx: (out): return location for bin_window X coordinate
+ * @by: (out): return location for bin_window Y coordinate
*
* Converts widget coordinates to coordinates for the bin_window
* (see gtk_tree_view_get_bin_window()).
@@ -13897,8 +13897,8 @@ gtk_tree_view_convert_widget_to_bin_window_coords (GtkTreeView *tree_view,
* @tree_view: a #GtkTreeView
* @bx: bin_window X coordinate
* @by: bin_window Y coordinate
- * @wx: return location for widget X coordinate
- * @wy: return location for widget Y coordinate
+ * @wx: (out): return location for widget X coordinate
+ * @wy: (out): return location for widget Y coordinate
*
* Converts bin_window coordinates (see gtk_tree_view_get_bin_window())
* to widget relative coordinates.
@@ -13925,8 +13925,8 @@ gtk_tree_view_convert_bin_window_to_widget_coords (GtkTreeView *tree_view,
* @tree_view: a #GtkTreeView
* @tx: tree X coordinate
* @ty: tree Y coordinate
- * @bx: return location for X coordinate relative to bin_window
- * @by: return location for Y coordinate relative to bin_window
+ * @bx: (out): return location for X coordinate relative to bin_window
+ * @by: (out): return location for Y coordinate relative to bin_window
*
* Converts tree coordinates (coordinates in full scrollable area of the tree)
* to bin_window coordinates.
@@ -13953,8 +13953,8 @@ gtk_tree_view_convert_tree_to_bin_window_coords (GtkTreeView *tree_view,
* @tree_view: a #GtkTreeView
* @bx: X coordinate relative to bin_window
* @by: Y coordinate relative to bin_window
- * @tx: return location for tree X coordinate
- * @ty: return location for tree Y coordinate
+ * @tx: (out): return location for tree X coordinate
+ * @ty: (out): return location for tree Y coordinate
*
* Converts bin_window coordinates to coordinates for the
* tree (the full scrollable area of the tree).
@@ -13981,8 +13981,9 @@ gtk_tree_view_convert_bin_window_to_tree_coords (GtkTreeView *tree_view,
/**
* gtk_tree_view_get_visible_range:
* @tree_view: A #GtkTreeView
- * @start_path: (allow-none): Return location for start of region, or %NULL.
- * @end_path: (allow-none): Return location for end of region, or %NULL.
+ * @start_path: (out) (allow-none): Return location for start of region,
+ * or %NULL.
+ * @end_path: (out) (allow-none): Return location for end of region, or %NULL.
*
* Sets @start_path and @end_path to be the first and last visible path.
* Note that there may be invisible paths in between.
@@ -16267,8 +16268,8 @@ gtk_tree_view_set_tooltip_cell (GtkTreeView *tree_view,
/**
* gtk_tree_view_get_tooltip_context:
* @tree_view: a #GtkTreeView
- * @x: the x coordinate (relative to widget coordinates)
- * @y: the y coordinate (relative to widget coordinates)
+ * @x: (inout): the x coordinate (relative to widget coordinates)
+ * @y: (inout): the y coordinate (relative to widget coordinates)
* @keyboard_tip: whether this is a keyboard tooltip or not
* @model: (out) (allow-none): a pointer to receive a #GtkTreeModel or %NULL
* @path: (out) (allow-none): a pointer to receive a #GtkTreePath or %NULL
diff --git a/gtk/gtktreeviewcolumn.c b/gtk/gtktreeviewcolumn.c
index eebcf5e..2f93f65 100644
--- a/gtk/gtktreeviewcolumn.c
+++ b/gtk/gtktreeviewcolumn.c
@@ -2792,10 +2792,10 @@ gtk_tree_view_column_cell_set_cell_data (GtkTreeViewColumn *tree_column,
* gtk_tree_view_column_cell_get_size:
* @tree_column: A #GtkTreeViewColumn.
* @cell_area: (allow-none): The area a cell in the column will be allocated, or %NULL
- * @x_offset: (allow-none): location to return x offset of a cell relative to @cell_area, or %NULL
- * @y_offset: (allow-none): location to return y offset of a cell relative to @cell_area, or %NULL
- * @width: (allow-none): location to return width needed to render a cell, or %NULL
- * @height: (allow-none): location to return height needed to render a cell, or %NULL
+ * @x_offset: (out) (allow-none): location to return x offset of a cell relative to @cell_area, or %NULL
+ * @y_offset: (out) (allow-none): location to return y offset of a cell relative to @cell_area, or %NULL
+ * @width: (out) (allow-none): location to return width needed to render a cell, or %NULL
+ * @height: (out) (allow-none): location to return height needed to render a cell, or %NULL
*
* Obtains the width and height needed to render the column. This is used
* primarily by the #GtkTreeView.
@@ -2994,9 +2994,10 @@ _gtk_tree_view_column_cell_get_dirty (GtkTreeViewColumn *tree_column)
* gtk_tree_view_column_cell_get_position:
* @tree_column: a #GtkTreeViewColumn
* @cell_renderer: a #GtkCellRenderer
- * @x_offset: return location for the horizontal position of @cell within
- * @tree_column, may be %NULL
- * @width: return location for the width of @cell, may be %NULL
+ * @x_offset: (out) (allow-none): return location for the horizontal
+ * position of @cell within @tree_column, may be %NULL
+ * @width: (out) (allow-none): return location for the width of @cell,
+ * may be %NULL
*
* Obtains the horizontal position and size of a cell in a column. If the
* cell is not found in the column, @start_pos and @width are not changed and
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index cd408cc..07eaba7 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.
*
@@ -11538,8 +11538,9 @@ gtk_widget_class_find_style_property (GtkWidgetClass *klass,
* gtk_widget_class_list_style_properties:
* @klass: a #GtkWidgetClass
* @n_properties: location to return the number of style properties found
- * @returns: an newly allocated array of #GParamSpec*. The array must
- * be freed with g_free().
+ * @returns: (array length=n_properties) (transfer container): an
+ * newly allocated array of #GParamSpec*. The array must be
+ * freed with g_free().
*
* Returns all style properties of a widget class.
*
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index a5840a2..b914294 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
**/
@@ -3426,7 +3426,7 @@ gtk_window_unrealize_icon (GtkWindow *window)
/**
* gtk_window_set_icon_list:
* @window: a #GtkWindow
- * @list: (element-type GdkPixbuf) (transfer container): list of #GdkPixbuf
+ * @list: (element-type GdkPixbuf): list of #GdkPixbuf
*
* Sets up the icon representing a #GtkWindow. The icon is used when
* the window is minimized (also known as iconified). Some window
@@ -3719,7 +3719,7 @@ gtk_window_set_icon_from_file (GtkWindow *window,
/**
* gtk_window_set_default_icon_list:
- * @list: (element-type GdkPixbuf) (transfer container): a list of #GdkPixbuf
+ * @list: (element-type GdkPixbuf): a list of #GdkPixbuf
*
* Sets an icon list to be used as fallback for windows that haven't
* had gtk_window_set_icon_list() called on them to set up a
@@ -5581,8 +5581,8 @@ gtk_window_get_has_resize_grip (GtkWindow *window)
/**
* gtk_window_get_resize_grip_area:
* @window: a #GtkWindow
- * @rect: a pointer to a #GdkRectangle which we should store the
- * resize grip area
+ * @rect: (out): a pointer to a #GdkRectangle which we should store
+ * the resize grip area
*
* If a window has a resize grip, this will retrieve the grip
* position, width and height into the specified #GdkRectangle.
@@ -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]