AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-09-19 13:30:02 +00:00
Code Issues Projects Releases Wiki Activity

introspection: Stop using allow-none

Browse Source 
allow-none has been deprecated for a long time
already. Instead use optional and nullable everywhere.
This commit is contained in:
Matthias Clasen 2021-05-19 07:24:34 -04:00
parent 8ba16eb4f1
commit 7fe0610b68
148 changed files with 525 additions and 525 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
gdk/gdkapplaunchcontext.c
View File

@ -237,7 +237,7 @@ gdk_app_launch_context_set_timestamp (GdkAppLaunchContext *context,
/**
* gdk_app_launch_context_set_icon:
* @context: a `GdkAppLaunchContext`
* @icon: (allow-none): a #GIcon, or %NULL
* @icon: (nullable): a #GIcon, or %NULL
*
* Sets the icon for applications that are launched with this
* context.
@ -267,7 +267,7 @@ gdk_app_launch_context_set_icon (GdkAppLaunchContext *context,
/**
* gdk_app_launch_context_set_icon_name:
* @context: a `GdkAppLaunchContext`
* @icon_name: (allow-none): an icon name, or %NULL
* @icon_name: (nullable): an icon name, or %NULL
*
* Sets the icon for applications that are launched with this context.
*

4
gdk/gdkclipboard.c
View File

@ -676,7 +676,7 @@ gdk_clipboard_read_async (GdkClipboard *clipboard,
* gdk_clipboard_read_finish:
* @clipboard: a `GdkClipboard`
* @result: a `GAsyncResult`
* @out_mime_type: (out) (allow-none) (transfer none): pointer to store
* @out_mime_type: (out) (optional) (transfer none): pointer to store
* the chosen mime type
* @error: a `GError` location to store the error occurring
*
@ -1194,7 +1194,7 @@ gdk_clipboard_claim_remote (GdkClipboard *clipboard,
/**
* gdk_clipboard_set_content:
* @clipboard: a `GdkClipboard`
* @provider: (transfer none) (allow-none): the new contents of @clipboard
* @provider: (transfer none) (nullable): the new contents of @clipboard
* or %NULL to clear the clipboard
*
* Sets a new content provider on @clipboard.

2
gdk/gdkcontentformats.c
View File

@ -125,7 +125,7 @@ gdk_content_formats_new_take (GType * gtypes,
/**
* gdk_content_formats_new:
* @mime_types: (array length=n_mime_types) (allow-none): Pointer to an
* @mime_types: (array length=n_mime_types) (nullable): Pointer to an
* array of mime types
* @n_mime_types: number of entries in @mime_types.
*

4
gdk/gdkcursor.c
View File

@ -298,7 +298,7 @@ gdk_cursor_equal (gconstpointer a,
/**
* gdk_cursor_new_from_name:
* @name: the name of the cursor
* @fallback: (allow-none): %NULL or the `GdkCursor` to fall back to when
* @fallback: (nullable): %NULL or the `GdkCursor` to fall back to when
* this one cannot be supported
*
* Creates a new cursor by looking up @name in the current cursor
@ -340,7 +340,7 @@ gdk_cursor_new_from_name (const char *name,
* @texture: the texture providing the pixel data
* @hotspot_x: the horizontal offset of the “hotspot” of the cursor
* @hotspot_y: the vertical offset of the “hotspot” of the cursor
* @fallback: (allow-none): %NULL or the `GdkCursor` to fall back to when
* @fallback: (nullable): %NULL or the `GdkCursor` to fall back to when
* this one cannot be supported
*
* Creates a new cursor from a `GdkTexture`.

4
gdk/gdkdevice.c
View File

@ -520,9 +520,9 @@ gdk_device_get_property (GObject *object,
/**
* gdk_device_get_surface_at_position:
* @device: pointer `GdkDevice` to query info to
* @win_x: (out) (allow-none): return location for the X coordinate
* @win_x: (out) (optional): return location for the X coordinate
* of the device location relative to the surface origin
* @win_y: (out) (allow-none): return location for the Y coordinate
* @win_y: (out) (optional): return location for the Y coordinate
* of the device location relative to the surface origin
*
* Obtains the surface underneath @device, returning the location of the

4
gdk/gdkdrop.c
View File

@ -659,7 +659,7 @@ gdk_drop_read_internal (GdkDrop *self,
* @mime_types: (array zero-terminated=1) (element-type utf8):
* pointer to an array of mime types
* @io_priority: the I/O priority for the read operation
* @cancellable: (allow-none): optional `GCancellable` object
* @cancellable: (nullable): optional `GCancellable` object
* @callback: (scope async): a `GAsyncReadyCallback` to call when
* the request is satisfied
* @user_data: (closure): the data to pass to @callback
@ -694,7 +694,7 @@ gdk_drop_read_async (GdkDrop *self,
* @self: a `GdkDrop`
* @result: a `GAsyncResult`
* @out_mime_type: (out) (type utf8): return location for the used mime type
* @error: (allow-none): location to store error information on failure, or %NULL
* @error: (nullable): location to store error information on failure, or %NULL
*
* Finishes an async drop read operation.
*

8
gdk/gdkkeys.c
View File

@ -551,10 +551,10 @@ gdk_keymap_lookup_key (GdkKeymap *keymap,
* @hardware_keycode: a keycode
* @state: a modifier state
* @group: active keyboard group
* @keyval: (out) (allow-none): return location for keyval
* @effective_group: (out) (allow-none): return location for effective group
* @level: (out) (allow-none): return location for level
* @consumed_modifiers: (out) (allow-none): return location for modifiers
* @keyval: (out) (optional): return location for keyval
* @effective_group: (out) (optional): return location for effective group
* @level: (out) (optional): return location for level
* @consumed_modifiers: (out) (optional): return location for modifiers
* that were used to determine the group or level
*
* Translates the contents of a #GdkEventKey into a keyval, effective

2
gdk/gdkrectangle.c
View File

@ -91,7 +91,7 @@ gdk_rectangle_union (const GdkRectangle *src1,
* gdk_rectangle_intersect:
* @src1: a `GdkRectangle`
* @src2: a `GdkRectangle`
* @dest: (out caller-allocates) (allow-none): return location for the
* @dest: (out caller-allocates) (optional): return location for the
* intersection of @src1 and @src2, or %NULL
*
* Calculates the intersection of two rectangles.

20
gdk/gdksurface.c
View File

@ -1438,7 +1438,7 @@ gdk_surface_paint_on_clock (GdkFrameClock *clock,
/*
* gdk_surface_invalidate_rect:
* @surface: a `GdkSurface`
* @rect: (allow-none): rectangle to invalidate or %NULL to
* @rect: (nullable): rectangle to invalidate or %NULL to
* invalidate the whole surface
*
* Invalidate a rectangular region of @surface.
@ -1696,9 +1696,9 @@ gdk_surface_constrain_size (GdkGeometry *geometry,
* gdk_surface_get_device_position:
* @surface: a `GdkSurface`
* @device: pointer `GdkDevice` to query to
* @x: (out) (allow-none): return locatio for the X coordinate of @device, or %NULL
* @y: (out) (allow-none): return location for the Y coordinate of @device, or %NULL
* @mask: (out) (allow-none): return location for the modifier mask, or %NULL
* @x: (out) (optional): return locatio for the X coordinate of @device, or %NULL
* @y: (out) (optional): return location for the Y coordinate of @device, or %NULL
* @mask: (out) (optional): return location for the modifier mask, or %NULL
*
* Obtains the current device position and modifier state.
*
@ -1855,7 +1855,7 @@ gdk_surface_get_cursor (GdkSurface *surface)
/**
* gdk_surface_set_cursor: (attributes org.gtk.Method.set_property=cursor)
* @surface: a `GdkSurface`
* @cursor: (allow-none): a `GdkCursor`
* @cursor: (nullable): a `GdkCursor`
*
* Sets the default mouse pointer for a `GdkSurface`.
*
@ -1970,10 +1970,10 @@ gdk_surface_set_device_cursor (GdkSurface *surface,
/*
* gdk_surface_get_geometry:
* @surface: a `GdkSurface`
* @x: (out) (allow-none): return location for X coordinate of surface (relative to its parent)
* @y: (out) (allow-none): return location for Y coordinate of surface (relative to its parent)
* @width: (out) (allow-none): return location for width of surface
* @height: (out) (allow-none): return location for height of surface
* @x: (out) (optional): return location for X coordinate of surface (relative to its parent)
* @y: (out) (optional): return location for Y coordinate of surface (relative to its parent)
* @width: (out) (optional): return location for width of surface
* @height: (out) (optional): return location for height of surface
*
* Get the geometry of the surface.
*
@ -2624,7 +2624,7 @@ gdk_surface_get_scale_factor (GdkSurface *surface)
/**
* gdk_surface_set_opaque_region:
* @surface: a top-level `GdkSurface`
* @region: (allow-none): a region, or %NULL
* @region: (nullable): a region, or %NULL
*
* Marks a region of the `GdkSurface` as opaque.
*

2
gdk/win32/gdkdisplay-win32.c
View File

@ -328,7 +328,7 @@ _gdk_win32_display_init_monitors (GdkWin32Display *win32_display)
/**
* gdk_win32_display_set_cursor_theme:
* @display: (type GdkWin32Display): a `GdkDisplay`
* @name: (allow-none): the name of the cursor theme to use, or %NULL
* @name: (nullable): the name of the cursor theme to use, or %NULL
* to unset a previously set value
* @size: the cursor size to use, or 0 to keep the previous size
*

2
gdk/x11/gdkdevicemanager-x11.c
View File

@ -71,7 +71,7 @@ _gdk_x11_device_manager_new (GdkDisplay *display)
*
* Returns the #GdkDevice that wraps the given device ID.
*
* Returns: (transfer none) (allow-none) (type GdkX11DeviceXI2): The
* Returns: (transfer none) (nullable) (type GdkX11DeviceXI2): The
* `GdkDevice` wrapping the device ID,
* or %NULL if the given ID doesn’t currently represent a device.
**/

2
gdk/x11/gdkdisplay-x11.c
View File

@ -1357,7 +1357,7 @@ gdk_display_setup_window_visual (GdkDisplay *display,
/**
* gdk_x11_display_open:
* @display_name: (allow-none): name of the X display.
* @display_name: (nullable): name of the X display.
* See the XOpenDisplay() for details.
*
* Tries to open a new display to the X server given by

2
gdk/x11/gdksurface-x11.c
View File

@ -3059,7 +3059,7 @@ gdk_x11_surface_set_user_time (GdkSurface *surface,
* gdk_x11_surface_set_utf8_property:
* @surface: (type GdkX11Surface): a #GdkSurface
* @name: Property name, will be interned as an X atom
* @value: (allow-none): Property value, or %NULL to delete
* @value: (nullable): Property value, or %NULL to delete
*
* This function modifies or removes an arbitrary X11 window
* property of type UTF8_STRING. If the given @surface is

2
gsk/gskrenderer.c
View File

@ -339,7 +339,7 @@ gsk_renderer_unrealize (GskRenderer *renderer)
* gsk_renderer_render_texture:
* @renderer: a realized `GskRenderer`
* @root: a `GskRenderNode`
* @viewport: (allow-none): the section to draw or %NULL to use @root's bounds
* @viewport: (nullable): the section to draw or %NULL to use @root's bounds
*
* Renders the scene graph, described by a tree of `GskRenderNode` instances,
* to a `GdkTexture`.

2
gsk/gskrendernodeimpl.c
View File

@ -3392,7 +3392,7 @@ gsk_repeat_node_draw (GskRenderNode *node,
* gsk_repeat_node_new:
* @bounds: The bounds of the area to be painted
* @child: The child to repeat
* @child_bounds: (allow-none): The area of the child to repeat or %NULL to
* @child_bounds: (nullable): The area of the child to repeat or %NULL to
* use the child's bounds
*
* Creates a `GskRenderNode` that will repeat the drawing of @child across

36
gsk/gsktransform.c
View File

@ -217,7 +217,7 @@ static const GskTransformClass GSK_IDENTITY_TRANSFORM_CLASS =
/*<private>
* gsk_transform_is_identity:
* @transform: (allow-none): A transform or %NULL
* @transform: (nullable): A transform or %NULL
*
* Checks if the transform is a representation of the identity
* transform.
@ -452,7 +452,7 @@ gsk_transform_matrix_with_category (GskTransform *next,
/**
* gsk_transform_matrix:
* @next: (allow-none) (transfer full): the next transform
* @next: (nullable) (transfer full): the next transform
* @matrix: the matrix to multiply @next with
*
* Multiplies @next with the given @matrix.
@ -605,7 +605,7 @@ static const GskTransformClass GSK_TRANSLATE_TRANSFORM_CLASS =
/**
* gsk_transform_translate:
* @next: (allow-none) (transfer full): the next transform
* @next: (nullable) (transfer full): the next transform
* @point: the point to translate the transform by
*
* Translates @next in 2-dimensional space by @point.
@ -625,7 +625,7 @@ gsk_transform_translate (GskTransform *next,
/**
* gsk_transform_translate_3d:
* @next: (allow-none) (transfer full): the next transform
* @next: (nullable) (transfer full): the next transform
* @point: the point to translate the transform by
*
* Translates @next by @point.
@ -840,7 +840,7 @@ normalize_angle (float angle)
/**
* gsk_transform_rotate:
* @next: (allow-none) (transfer full): the next transform
* @next: (nullable) (transfer full): the next transform
* @angle: the rotation angle, in degrees (clockwise)
*
* Rotates @next @angle degrees in 2D - or in 3D-speak, around the z axis.
@ -964,7 +964,7 @@ static const GskTransformClass GSK_ROTATE3D_TRANSFORM_CLASS =
/**
* gsk_transform_rotate_3d:
* @next: (allow-none) (transfer full): the next transform
* @next: (nullable) (transfer full): the next transform
* @angle: the rotation angle, in degrees (clockwise)
* @axis: The rotation axis
*
@ -1137,7 +1137,7 @@ static const GskTransformClass GSK_SCALE_TRANSFORM_CLASS =
/**
* gsk_transform_scale:
* @next: (allow-none) (transfer full): the next transform
* @next: (nullable) (transfer full): the next transform
* @factor_x: scaling factor on the X axis
* @factor_y: scaling factor on the Y axis
*
@ -1157,7 +1157,7 @@ gsk_transform_scale (GskTransform *next,
/**
* gsk_transform_scale_3d:
* @next: (allow-none) (transfer full): the next transform
* @next: (nullable) (transfer full): the next transform
* @factor_x: scaling factor on the X axis
* @factor_y: scaling factor on the Y axis
* @factor_z: scaling factor on the Z axis
@ -1286,7 +1286,7 @@ static const GskTransformClass GSK_PERSPECTIVE_TRANSFORM_CLASS =
/**
* gsk_transform_perspective:
* @next: (allow-none) (transfer full): the next transform
* @next: (nullable) (transfer full): the next transform
* @depth: distance of the z=0 plane. Lower values give a more
* flattened pyramid and therefore a more pronounced
* perspective effect.
@ -1335,7 +1335,7 @@ gsk_transform_finalize (GskTransform *self)
/**
* gsk_transform_ref:
* @self: (allow-none): a `GskTransform`
* @self: (nullable): a `GskTransform`
*
* Acquires a reference on the given `GskTransform`.
*
@ -1352,7 +1352,7 @@ gsk_transform_ref (GskTransform *self)
/**
* gsk_transform_unref:
* @self: (allow-none): a `GskTransform`
* @self: (nullable): a `GskTransform`
*
* Releases a reference on the given `GskTransform`.
*
@ -1370,7 +1370,7 @@ gsk_transform_unref (GskTransform *self)
/**
* gsk_transform_print:
* @self: (allow-none): a `GskTransform`
* @self: (nullable): a `GskTransform`
* @string: The string to print into
*
* Converts @self into a human-readable string representation suitable
@ -1402,7 +1402,7 @@ gsk_transform_print (GskTransform *self,
/**
* gsk_transform_to_string:
* @self: (allow-none): a #GskTransform
* @self: (nullable): a #GskTransform
*
* Converts a matrix into a string that is suitable for printing.
*
@ -1426,7 +1426,7 @@ gsk_transform_to_string (GskTransform *self)
/**
* gsk_transform_to_matrix:
* @self: (allow-none): a `GskTransform`
* @self: (nullable): a `GskTransform`
* @out_matrix: (out caller-allocates): The matrix to set
*
* Computes the actual value of @self and stores it in @out_matrix.
@ -1642,8 +1642,8 @@ gsk_transform_to_translate (GskTransform *self,
/**
* gsk_transform_transform:
* @next: (allow-none) (transfer full): Transform to apply @other to
* @other: (allow-none): Transform to apply
* @next: (nullable) (transfer full): Transform to apply @other to
* @other: (nullable): Transform to apply
*
* Applies all the operations from @other to @next.
*
@ -1673,7 +1673,7 @@ gsk_transform_transform (GskTransform *next,
/**
* gsk_transform_invert:
* @self: (allow-none) (transfer full): Transform to invert
* @self: (nullable) (transfer full): Transform to invert
*
* Inverts the given transform.
*
@ -1736,7 +1736,7 @@ gsk_transform_equal (GskTransform *first,
/**
* gsk_transform_get_category:
* @self: (allow-none): A #GskTransform
* @self: (nullable): A #GskTransform
*
* Returns the category this transform belongs to.
*

2
gtk/css/gtkcsstokenizer.c
View File

@ -214,7 +214,7 @@ gtk_css_token_is_finite (const GtkCssToken *token)
/*
* gtk_css_token_is_preserved:
* @token: a #GtkCssToken
* @out_closing: (allow-none): Type of the token that closes a block
* @out_closing: (nullable): Type of the token that closes a block
* started with this token
*
* A token is considered preserved when it does not start a block.

16
gtk/gtkaccelgroup.c
View File

@ -228,11 +228,11 @@ is_keycode (const char *string)
/**
* gtk_accelerator_parse_with_keycode:
* @accelerator: string representing an accelerator
* @display: (allow-none): the `GdkDisplay` to look up @accelerator_codes in
* @accelerator_key: (out) (allow-none): return location for accelerator keyval
* @accelerator_codes: (out) (array zero-terminated=1) (transfer full) (allow-none):
* @display: (nullable): the `GdkDisplay` to look up @accelerator_codes in
* @accelerator_key: (out) (optional): return location for accelerator keyval
* @accelerator_codes: (out) (array zero-terminated=1) (transfer full) (optional):
* return location for accelerator keycodes
* @accelerator_mods: (out) (allow-none): return location for accelerator
* @accelerator_mods: (out) (optional): return location for accelerator
* modifier mask
*
* Parses a string representing an accelerator.
@ -478,8 +478,8 @@ out:
/**
* gtk_accelerator_parse:
* @accelerator: string representing an accelerator
* @accelerator_key: (out) (allow-none): return location for accelerator keyval
* @accelerator_mods: (out) (allow-none): return location for accelerator
* @accelerator_key: (out) (optional): return location for accelerator keyval
* @accelerator_mods: (out) (optional): return location for accelerator
* modifier mask
*
* Parses a string representing an accelerator.
@ -505,7 +505,7 @@ gtk_accelerator_parse (const char *accelerator,
/**
* gtk_accelerator_name_with_keycode:
* @display: (allow-none): a `GdkDisplay` or %NULL to use the default display
* @display: (nullable): a `GdkDisplay` or %NULL to use the default display
* @accelerator_key: accelerator keyval
* @keycode: accelerator keycode
* @accelerator_mods: accelerator modifier mask
@ -621,7 +621,7 @@ gtk_accelerator_name (guint accelerator_key,
/**
* gtk_accelerator_get_label_with_keycode:
* @display: (allow-none): a `GdkDisplay` or %NULL to use the default display
* @display: (nullable): a `GdkDisplay` or %NULL to use the default display
* @accelerator_key: accelerator keyval
* @keycode: accelerator keycode
* @accelerator_mods: accelerator modifier mask

2
gtk/gtkactionbar.c
View File

@ -291,7 +291,7 @@ gtk_action_bar_remove (GtkActionBar *action_bar,
/**
* gtk_action_bar_set_center_widget:
* @action_bar: a `GtkActionBar`
* @center_widget: (allow-none): a widget to use for the center
* @center_widget: (nullable): a widget to use for the center
*
* Sets the center widget for the `GtkActionBar`.
*/

2
gtk/gtkactionmuxer.c
View File

@ -1346,7 +1346,7 @@ gtk_action_muxer_get_parent (GtkActionMuxer *muxer)
/*< private >
* gtk_action_muxer_set_parent:
* @muxer: a #GtkActionMuxer
* @parent: (allow-none): the new parent #GtkActionMuxer
* @parent: (nullable): the new parent #GtkActionMuxer
*
* Sets the parent of @muxer to @parent.
*/

4
gtk/gtkappchooserdialog.c
View File

@ -666,7 +666,7 @@ set_parent_and_flags (GtkWidget *dialog,
/**
* gtk_app_chooser_dialog_new:
* @parent: (allow-none): a `GtkWindow`, or %NULL
* @parent: (nullable): a `GtkWindow`, or %NULL
* @flags: flags for this dialog
* @file: a `GFile`
*
@ -696,7 +696,7 @@ gtk_app_chooser_dialog_new (GtkWindow *parent,
/**
* gtk_app_chooser_dialog_new_for_content_type:
* @parent: (allow-none): a `GtkWindow`, or %NULL
* @parent: (nullable): a `GtkWindow`, or %NULL
* @flags: flags for this dialog
* @content_type: a content type string
*

2
gtk/gtkaspectframe.c
View File

@ -642,7 +642,7 @@ gtk_aspect_frame_get_request_mode (GtkWidget *widget)
/**
* gtk_aspect_frame_set_child: (attributes org.gtk.Method.set_property=child)
* @self: a `GtkAspectFrame`
* @child: (allow-none): the child widget
* @child: (nullable): the child widget
*
* Sets the child widget of @self.
*/

2
gtk/gtkassistant.c
View File

@ -1776,7 +1776,7 @@ gtk_assistant_remove_page (GtkAssistant *assistant,
/**
* gtk_assistant_set_forward_page_func:
* @assistant: a `GtkAssistant`
* @page_func: (allow-none): the `GtkAssistant`PageFunc, or %NULL
* @page_func: (nullable): the `GtkAssistant`PageFunc, or %NULL
* to use the default one
* @data: user data for @page_func
* @destroy: destroy notifier for @data

4
gtk/gtkbitset.c
View File

@ -56,7 +56,7 @@ G_DEFINE_BOXED_TYPE (GtkBitset, gtk_bitset,
/**
* gtk_bitset_ref:
* @self: (allow-none): a `GtkBitset`
* @self: (nullable): a `GtkBitset`
*
* Acquires a reference on the given `GtkBitset`.
*
@ -74,7 +74,7 @@ gtk_bitset_ref (GtkBitset *self)
/**
* gtk_bitset_unref:
* @self: (allow-none): a `GtkBitset`
* @self: (nullable): a `GtkBitset`
*
* Releases a reference on the given `GtkBitset`.
*

6
gtk/gtkbookmarklist.c
View File

@ -464,8 +464,8 @@ gtk_bookmark_list_get_filename (GtkBookmarkList *self)
/**
* gtk_bookmark_list_new:
* @filename: (allow-none): The bookmark file to load
* @attributes: (allow-none): The attributes to query
* @filename: (nullable): The bookmark file to load
* @attributes: (nullable): The attributes to query
*
* Creates a new `GtkBookmarkList` with the given @attributes.
*
@ -484,7 +484,7 @@ gtk_bookmark_list_new (const char *filename,
/**
* gtk_bookmark_list_set_attributes: (attributes org.gtk.Method.set_property=attributes)
* @self: a `GtkBookmarkList`
* @attributes: (allow-none): the attributes to enumerate
* @attributes: (nullable): the attributes to enumerate
*
* Sets the @attributes to be enumerated and starts the enumeration.
*

6
gtk/gtkbuildable.c
View File

@ -188,7 +188,7 @@ gtk_buildable_construct_child (GtkBuildable *buildable,
* gtk_buildable_custom_tag_start:
* @buildable: a `GtkBuildable`
* @builder: a `GtkBuilder` used to construct this object
* @child: (allow-none): child object or %NULL for non-child tags
* @child: (nullable): child object or %NULL for non-child tags
* @tagname: name of tag
* @parser: (out): a #GMarkupParser to fill in
* @data: (out): return location for user data that will be passed in
@ -224,7 +224,7 @@ gtk_buildable_custom_tag_start (GtkBuildable *buildable,
* gtk_buildable_custom_tag_end:
* @buildable: A `GtkBuildable`
* @builder: `GtkBuilder` used to construct this object
* @child: (allow-none): child object or %NULL for non-child tags
* @child: (nullable): child object or %NULL for non-child tags
* @tagname: name of tag
* @data: user data that will be passed in to parser functions
*
@ -253,7 +253,7 @@ gtk_buildable_custom_tag_end (GtkBuildable *buildable,
* gtk_buildable_custom_finished:
* @buildable: a `GtkBuildable`
* @builder: a `GtkBuilder`
* @child: (allow-none): child object or %NULL for non-child tags
* @child: (nullable): child object or %NULL for non-child tags
* @tagname: the name of the tag
* @data: user data created in custom_tag_start
*

20
gtk/gtkbuilder.c
View File

@ -1176,7 +1176,7 @@ gtk_builder_new (void)
* gtk_builder_add_from_file:
* @builder: a `GtkBuilder`
* @filename: the name of the file to parse
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Parses a file containing a UI definition and merges it with
* the current contents of @builder.
@ -1247,7 +1247,7 @@ gtk_builder_add_from_file (GtkBuilder *builder,
* @builder: a `GtkBuilder`
* @filename: the name of the file to parse
* @object_ids: (array zero-terminated=1) (element-type utf8): nul-terminated array of objects to build
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Parses a file containing a UI definition building only the
* requested objects and merges them with the current contents
@ -1315,7 +1315,7 @@ gtk_builder_add_objects_from_file (GtkBuilder *builder,
* @template_type: the type that the template is for
* @buffer: the string to parse
* @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Main private entry point for building composite components
* from template XML.
@ -1372,7 +1372,7 @@ gtk_builder_extend_with_template (GtkBuilder *builder,
* gtk_builder_add_from_resource:
* @builder: a `GtkBuilder`
* @resource_path: the path of the resource file to parse
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Parses a resource file containing a UI definition
* and merges it with the current contents of @builder.
@ -1450,7 +1450,7 @@ gtk_builder_add_from_resource (GtkBuilder *builder,
* @builder: a `GtkBuilder`
* @resource_path: the path of the resource file to parse
* @object_ids: (array zero-terminated=1) (element-type utf8): nul-terminated array of objects to build
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Parses a resource file containing a UI definition, building
* only the requested objects and merges them with the current
@ -1525,7 +1525,7 @@ gtk_builder_add_objects_from_resource (GtkBuilder *builder,
* @builder: a `GtkBuilder`
* @buffer: the string to parse
* @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Parses a string containing a UI definition and merges it
* with the current contents of @builder.
@ -1584,7 +1584,7 @@ gtk_builder_add_from_string (GtkBuilder *builder,
* @buffer: the string to parse
* @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
* @object_ids: (array zero-terminated=1) (element-type utf8): nul-terminated array of objects to build
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Parses a string containing a UI definition, building only the
* requested objects and merges them with the current contents of
@ -1938,7 +1938,7 @@ _gtk_builder_finish (GtkBuilder *builder,
* @pspec: the `GParamSpec` for the property
* @string: the string representation of the value
* @value: (out): the `GValue` to store the result in
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Demarshals a value from a string.
*
@ -2064,7 +2064,7 @@ error:
* @type: the `GType` of the value
* @string: the string representation of the value
* @value: (out): the #GValue to store the result in
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Demarshals a value from a string.
*
@ -2732,7 +2732,7 @@ _gtk_builder_get_template_type (GtkBuilder *builder)
* @function_name: name of the function to look up
* @flags: closure creation flags
* @object: (nullable): Object to create the closure with
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Creates a closure to invoke the function called @function_name.
*

2
gtk/gtkbutton.c
View File

@ -1018,7 +1018,7 @@ gtk_button_get_gesture (GtkButton *button)
/**
* gtk_button_set_child: (attributes org.gtk.Method.set_property=child)
* @button: a `GtkButton`
* @child: (allow-none): the child widget
* @child: (nullable): the child widget
*
* Sets the child widget of @button.
*/

22
gtk/gtkcellarea.c
View File

@ -1886,7 +1886,7 @@ get_cell_by_position (GtkCellRenderer *renderer,
* for this row
* @x: the x position
* @y: the y position
* @alloc_area: (out) (allow-none): where to store the inner allocated area of the
* @alloc_area: (out) (optional): where to store the inner allocated area of the
* returned cell renderer, or %NULL.
*
* Gets the #GtkCellRenderer at @x and @y coordinates inside @area and optionally
@ -1997,8 +1997,8 @@ gtk_cell_area_get_request_mode (GtkCellArea *area)
* @area: a #GtkCellArea
* @context: the #GtkCellAreaContext to perform this request with
* @widget: the #GtkWidget where @area will be rendering
* @minimum_width: (out) (allow-none): location to store the minimum width, or %NULL
* @natural_width: (out) (allow-none): location to store the natural width, or %NULL
* @minimum_width: (out) (optional): location to store the minimum width, or %NULL
* @natural_width: (out) (optional): location to store the natural width, or %NULL
*
* Retrieves a cell area’s initial minimum and natural width.
*
@ -2028,8 +2028,8 @@ gtk_cell_area_get_preferred_width (GtkCellArea *area,
* @context: the #GtkCellAreaContext which has already been requested for widths.
* @widget: the #GtkWidget where @area will be rendering
* @width: the width for which to check the height of this area
* @minimum_height: (out) (allow-none): location to store the minimum height, or %NULL
* @natural_height: (out) (allow-none): location to store the natural height, or %NULL
* @minimum_height: (out) (optional): location to store the minimum height, or %NULL
* @natural_height: (out) (optional): location to store the natural height, or %NULL
*
* Retrieves a cell area’s minimum and natural height if it would be given
* the specified @width.
@ -2069,8 +2069,8 @@ gtk_cell_area_get_preferred_height_for_width (GtkCellArea *area,
* @area: a #GtkCellArea
* @context: the #GtkCellAreaContext to perform this request with
* @widget: the #GtkWidget where @area will be rendering
* @minimum_height: (out) (allow-none): location to store the minimum height, or %NULL
* @natural_height: (out) (allow-none): location to store the natural height, or %NULL
* @minimum_height: (out) (optional): location to store the minimum height, or %NULL
* @natural_height: (out) (optional): location to store the natural height, or %NULL
*
* Retrieves a cell area’s initial minimum and natural height.
*
@ -2100,8 +2100,8 @@ gtk_cell_area_get_preferred_height (GtkCellArea *area,
* @context: the #GtkCellAreaContext which has already been requested for widths.
* @widget: the #GtkWidget where @area will be rendering
* @height: the height for which to check the width of this area
* @minimum_width: (out) (allow-none): location to store the minimum width, or %NULL
* @natural_width: (out) (allow-none): location to store the natural width, or %NULL
* @minimum_width: (out) (optional): location to store the minimum width, or %NULL
* @natural_width: (out) (optional): location to store the natural width, or %NULL
*
* Retrieves a cell area’s minimum and natural width if it would be given
* the specified @height.
@ -3438,8 +3438,8 @@ gtk_cell_area_inner_cell_area (GtkCellArea *area,
* @widget: the #GtkWidget that @area is rendering onto
* @for_size: the allocation contextual size to request for, or -1 if
* the base request for the orientation is to be returned.
* @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
* @minimum_size: (out) (optional): location to store the minimum size, or %NULL
* @natural_size: (out) (optional): location to store the natural size, or %NULL
*
* This is a convenience function for #GtkCellArea implementations
* to request size for cell renderers. It’s important to use this

20
gtk/gtkcellareacontext.c
View File

@ -395,8 +395,8 @@ gtk_cell_area_context_allocate (GtkCellAreaContext *context,
/**
* gtk_cell_area_context_get_preferred_width:
* @context: a #GtkCellAreaContext
* @minimum_width: (out) (allow-none): location to store the minimum width
* @natural_width: (out) (allow-none): location to store the natural width
* @minimum_width: (out) (optional): location to store the minimum width
* @natural_width: (out) (optional): location to store the natural width
*
* Gets the accumulative preferred width for all rows which have been
* requested with this context.
@ -423,8 +423,8 @@ gtk_cell_area_context_get_preferred_width (GtkCellAreaContext *context,
/**
* gtk_cell_area_context_get_preferred_height:
* @context: a #GtkCellAreaContext
* @minimum_height: (out) (allow-none): location to store the minimum height
* @natural_height: (out) (allow-none): location to store the natural height
* @minimum_height: (out) (optional): location to store the minimum height
* @natural_height: (out) (optional): location to store the natural height
*
* Gets the accumulative preferred height for all rows which have been
* requested with this context.
@ -452,8 +452,8 @@ gtk_cell_area_context_get_preferred_height (GtkCellAreaContext *context,
* gtk_cell_area_context_get_preferred_height_for_width:
* @context: a #GtkCellAreaContext
* @width: a proposed width for allocation
* @minimum_height: (out) (allow-none): location to store the minimum height
* @natural_height: (out) (allow-none): location to store the natural height
* @minimum_height: (out) (optional): location to store the minimum height
* @natural_height: (out) (optional): location to store the natural height
*
* Gets the accumulative preferred height for @width for all rows
* which have been requested for the same said @width with this context.
@ -480,8 +480,8 @@ gtk_cell_area_context_get_preferred_height_for_width (GtkCellAreaContext *contex
* gtk_cell_area_context_get_preferred_width_for_height:
* @context: a #GtkCellAreaContext
* @height: a proposed height for allocation
* @minimum_width: (out) (allow-none): location to store the minimum width
* @natural_width: (out) (allow-none): location to store the natural width
* @minimum_width: (out) (optional): location to store the minimum width
* @natural_width: (out) (optional): location to store the natural width
*
* Gets the accumulative preferred width for @height for all rows which
* have been requested for the same said @height with this context.
@ -507,8 +507,8 @@ gtk_cell_area_context_get_preferred_width_for_height (GtkCellAreaContext *contex
/**
* gtk_cell_area_context_get_allocation:
* @context: a #GtkCellAreaContext
* @width: (out) (allow-none): location to store the allocated width, or %NULL
* @height: (out) (allow-none): location to store the allocated height, or %NULL
* @width: (out) (optional): location to store the allocated width, or %NULL
* @height: (out) (optional): location to store the allocated height, or %NULL
*
* Fetches the current allocation size for @context.
*

2
gtk/gtkcelllayout.c
View File

@ -489,7 +489,7 @@ gtk_cell_layout_add_attribute (GtkCellLayout *cell_layout,
* gtk_cell_layout_set_cell_data_func:
* @cell_layout: a #GtkCellLayout
* @cell: a #GtkCellRenderer
* @func: (allow-none): the #GtkCellLayoutDataFunc to use, or %NULL
* @func: (nullable): the #GtkCellLayoutDataFunc to use, or %NULL
* @func_data: (closure): user data for @func
* @destroy: destroy notify for @func_data
*

32
gtk/gtkcellrenderer.c
View File

@ -877,8 +877,8 @@ gtk_cell_renderer_set_fixed_size (GtkCellRenderer *cell,
/**
* gtk_cell_renderer_get_fixed_size:
* @cell: A #GtkCellRenderer
* @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
* @width: (out) (optional): location to fill in with the fixed width of the cell, or %NULL
* @height: (out) (optional): location to fill in with the fixed height of the cell, or %NULL
*
* Fills in @width and @height with the appropriate size of @cell.
**/
@ -943,8 +943,8 @@ gtk_cell_renderer_set_alignment (GtkCellRenderer *cell,
/**
* gtk_cell_renderer_get_alignment:
* @cell: A #GtkCellRenderer
* @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
* @xalign: (out) (optional): location to fill in with the x alignment of the cell, or %NULL
* @yalign: (out) (optional): location to fill in with the y alignment of the cell, or %NULL
*
* Fills in @xalign and @yalign with the appropriate values of @cell.
**/
@ -1008,8 +1008,8 @@ gtk_cell_renderer_set_padding (GtkCellRenderer *cell,
/**
* gtk_cell_renderer_get_padding:
* @cell: A #GtkCellRenderer
* @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
* @xpad: (out) (optional): location to fill in with the x padding of the cell, or %NULL
* @ypad: (out) (optional): location to fill in with the y padding of the cell, or %NULL
*
* Fills in @xpad and @ypad with the appropriate values of @cell.
**/
@ -1363,8 +1363,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: (out) (allow-none): location to store the minimum size, or %NULL
* @natural_size: (out) (allow-none): location to store the natural size, or %NULL
* @minimum_size: (out) (optional): location to store the minimum size, or %NULL
* @natural_size: (out) (optional): location to store the natural size, or %NULL
*
* Retrieves a renderer’s natural size when rendered to @widget.
*/
@ -1409,8 +1409,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: (out) (allow-none): location to store the minimum size, or %NULL
* @natural_size: (out) (allow-none): location to store the natural size, or %NULL
* @minimum_size: (out) (optional): location to store the minimum size, or %NULL
* @natural_size: (out) (optional): location to store the natural size, or %NULL
*
* Retrieves a renderer’s natural size when rendered to @widget.
*/
@ -1456,8 +1456,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: (out) (allow-none): location for storing the minimum size, or %NULL
* @natural_width: (out) (allow-none): location for storing the preferred size, or %NULL
* @minimum_width: (out) (optional): location for storing the minimum size, or %NULL
* @natural_width: (out) (optional): location for storing the preferred size, or %NULL
*
* Retrieves a cell renderers’s minimum and natural width if it were rendered to
* @widget with the specified @height.
@ -1504,8 +1504,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: (out) (allow-none): location for storing the minimum size, or %NULL
* @natural_height: (out) (allow-none): location for storing the preferred size, or %NULL
* @minimum_height: (out) (optional): location for storing the minimum size, or %NULL
* @natural_height: (out) (optional): location for storing the preferred size, or %NULL
*
* Retrieves a cell renderers’s minimum and natural height if it were rendered to
* @widget with the specified @width.
@ -1551,8 +1551,8 @@ gtk_cell_renderer_get_preferred_height_for_width (GtkCellRenderer *cell,
* gtk_cell_renderer_get_preferred_size:
* @cell: a #GtkCellRenderer instance
* @widget: the #GtkWidget this cell will be rendering to
* @minimum_size: (out) (allow-none): location for storing the minimum size, or %NULL
* @natural_size: (out) (allow-none): location for storing the natural size, or %NULL
* @minimum_size: (out) (optional): location for storing the minimum size, or %NULL
* @natural_size: (out) (optional): location for storing the natural size, or %NULL
*
* Retrieves the minimum and natural size of a cell taking
* into account the widget’s preference for height-for-width management.

4
gtk/gtkcellview.c
View File

@ -977,7 +977,7 @@ gtk_cell_view_set_value (GtkCellView *cell_view,
/**
* gtk_cell_view_set_model:
* @cell_view: a #GtkCellView
* @model: (allow-none): a #GtkTreeModel
* @model: (nullable): a #GtkTreeModel
*
* Sets the model for @cell_view. If @cell_view already has a model
* set, it will remove it before setting the new model. If @model is
@ -1038,7 +1038,7 @@ gtk_cell_view_get_model (GtkCellView *cell_view)
/**
* gtk_cell_view_set_displayed_row:
* @cell_view: a #GtkCellView
* @path: (allow-none): a #GtkTreePath or %NULL to unset.
* @path: (nullable): a #GtkTreePath or %NULL to unset.
*
* Sets the row of the model that is currently displayed
* by the #GtkCellView. If the path is unset, then the

2
gtk/gtkcolorchooser.c
View File

@ -193,7 +193,7 @@ gtk_color_chooser_set_use_alpha (GtkColorChooser *chooser,
* be displayed in rows, %GTK_ORIENTATION_VERTICAL for columns
* @colors_per_line: the number of colors to show in each row/column
* @n_colors: the total number of elements in @colors
* @colors: (allow-none) (array length=n_colors): the colors of the palette, or %NULL
* @colors: (nullable) (array length=n_colors): the colors of the palette, or %NULL
*
* Adds a palette to the color chooser.
*

4
gtk/gtkcolorchooserdialog.c
View File

@ -276,8 +276,8 @@ gtk_color_chooser_dialog_iface_init (GtkColorChooserInterface *iface)
/**
* gtk_color_chooser_dialog_new:
* @title: (allow-none): Title of the dialog, or %NULL
* @parent: (allow-none): Transient parent of the dialog, or %NULL
* @title: (nullable): Title of the dialog, or %NULL
* @parent: (nullable): Transient parent of the dialog, or %NULL
*
* Creates a new `GtkColorChooserDialog`.
*

6
gtk/gtkcolumnview.c
View File

@ -1327,7 +1327,7 @@ gtk_column_view_init (GtkColumnView *self)
/**
* gtk_column_view_new:
* @model: (allow-none) (transfer full): the list model to use, or %NULL
* @model: (nullable) (transfer full): the list model to use, or %NULL
*
* Creates a new `GtkColumnView`.
*
@ -1372,7 +1372,7 @@ gtk_column_view_get_model (GtkColumnView *self)
/**
* gtk_column_view_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a #GtkColumnView
* @model: (allow-none) (transfer none): the model to use or %NULL for none
* @model: (nullable) (transfer none): the model to use or %NULL for none
*
* Sets the model to use.
*
@ -1678,7 +1678,7 @@ gtk_column_view_get_sorter (GtkColumnView *self)
/**
* gtk_column_view_sort_by_column:
* @self: a `GtkColumnView`
* @column: (allow-none): the `GtkColumnViewColumn` to sort by, or %NULL
* @column: (nullable): the `GtkColumnViewColumn` to sort by, or %NULL
* @direction: the direction to sort in
*
* Sets the sorting of the view.

4
gtk/gtkcolumnviewcolumn.c
View File

@ -655,7 +655,7 @@ gtk_column_view_column_get_factory (GtkColumnViewColumn *self)
/**
* gtk_column_view_column_set_factory: (attributes org.gtk.Method.set_property=factory)
* @self: a `GtkColumnViewColumn`
* @factory: (allow-none) (transfer none): the factory to use or %NULL for none
* @factory: (nullable) (transfer none): the factory to use or %NULL for none
*
* Sets the `GtkListItemFactory` to use for populating list items for this
* column.
@ -848,7 +848,7 @@ gtk_column_view_column_get_visible (GtkColumnViewColumn *self)
/**
* gtk_column_view_column_set_header_menu: (attributes org.gtk.Method.set_property=header-menu)
* @self: a `GtkColumnViewColumn`
* @menu: (allow-none): a `GMenuModel`, or %NULL
* @menu: (nullable): a `GMenuModel`, or %NULL
*
* Sets the menu model that is used to create the context menu
* for the column header.

12
gtk/gtkcombobox.c
View File

@ -2060,7 +2060,7 @@ gtk_combo_box_get_active_iter (GtkComboBox *combo_box,
/**
* gtk_combo_box_set_active_iter:
* @combo_box: A `GtkComboBox`
* @iter: (allow-none): The `GtkTreeIter`, or %NULL
* @iter: (nullable): The `GtkTreeIter`, or %NULL
*
* Sets the current active item to be the one referenced by @iter.
*
@ -2084,7 +2084,7 @@ gtk_combo_box_set_active_iter (GtkComboBox *combo_box,
/**
* gtk_combo_box_set_model: (attributes org.gtk.Method.set_property=model)
* @combo_box: A `GtkComboBox`
* @model: (allow-none): A `GtkTreeModel`
* @model: (nullable): A `GtkTreeModel`
*
* Sets the model used by @combo_box to be @model.
*
@ -2569,8 +2569,8 @@ gtk_combo_box_get_row_separator_func (GtkComboBox *combo_box)
* gtk_combo_box_set_row_separator_func:
* @combo_box: a `GtkComboBox`
* @func: (nullable): a `GtkTreeViewRowSeparatorFunc`
* @data: (allow-none): user data to pass to @func, or %NULL
* @destroy: (allow-none): destroy notifier for @data, or %NULL
* @data: (nullable): user data to pass to @func, or %NULL
* @destroy: (nullable): 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.
@ -2887,7 +2887,7 @@ gtk_combo_box_get_active_id (GtkComboBox *combo_box)
/**
* gtk_combo_box_set_active_id: (attributes org.gtk.Method.set_property=active-id)
* @combo_box: a `GtkComboBox`
* @active_id: (allow-none): the ID of the row to select, or %NULL
* @active_id: (nullable): the ID of the row to select, or %NULL
*
* Changes the active row of @combo_box to the one that has an ID equal to
* @active_id.
@ -2962,7 +2962,7 @@ gtk_combo_box_get_popup (GtkComboBox *combo_box)
/**
* gtk_combo_box_set_child: (attributes org.gtk.Method.set_property=child)
* @combo_box: a `GtkComboBox`
* @child: (allow-none): the child widget
* @child: (nullable): the child widget
*
* Sets the child widget of @combo_box.
*/

6
gtk/gtkcomboboxtext.c
View File

@ -431,7 +431,7 @@ gtk_combo_box_text_insert_text (GtkComboBoxText *combo_box,
/**
* gtk_combo_box_text_append:
* @combo_box: A `GtkComboBoxText`
* @id: (allow-none): a string ID for this value, or %NULL
* @id: (nullable): a string ID for this value, or %NULL
* @text: A string
*
* Appends @text to the list of strings stored in @combo_box.
@ -452,7 +452,7 @@ gtk_combo_box_text_append (GtkComboBoxText *combo_box,
/**
* gtk_combo_box_text_prepend:
* @combo_box: A `GtkComboBox`
* @id: (allow-none): a string ID for this value, or %NULL
* @id: (nullable): a string ID for this value, or %NULL
* @text: a string
*
* Prepends @text to the list of strings stored in @combo_box.
@ -475,7 +475,7 @@ gtk_combo_box_text_prepend (GtkComboBoxText *combo_box,
* gtk_combo_box_text_insert:
* @combo_box: A `GtkComboBoxText`
* @position: An index to insert @text
* @id: (allow-none): a string ID for this value, or %NULL
* @id: (nullable): a string ID for this value, or %NULL
* @text: A string to display
*
* Inserts @text at @position in the list of strings stored in @combo_box.

12
gtk/gtkconstraintguide.c
View File

@ -500,8 +500,8 @@ gtk_constraint_guide_set_min_size (GtkConstraintGuide *guide,
/**
* gtk_constraint_guide_get_min_size:
* @guide: a `GtkConstraintGuide` object
* @width: (allow-none): return location for the minimum width
* @height: (allow-none): return location for the minimum height
* @width: (nullable): return location for the minimum width
* @height: (nullable): return location for the minimum height
*
* Gets the minimum size of @guide.
*/
@ -552,8 +552,8 @@ gtk_constraint_guide_set_nat_size (GtkConstraintGuide *guide,
/**
* gtk_constraint_guide_get_nat_size:
* @guide: a `GtkConstraintGuide` object
* @width: (allow-none): return location for the natural width
* @height: (allow-none): return location for the natural height
* @width: (nullable): return location for the natural width
* @height: (nullable): return location for the natural height
*
* Gets the natural size of @guide.
*/
@ -604,8 +604,8 @@ gtk_constraint_guide_set_max_size (GtkConstraintGuide *guide,
/**
* gtk_constraint_guide_get_max_size:
* @guide: a `GtkConstraintGuide` object
* @width: (allow-none): return location for the maximum width
* @height: (allow-none): return location for the maximum height
* @width: (nullable): return location for the maximum width
* @height: (nullable): return location for the maximum height
*
* Gets the maximum size of @guide.
*/

2
gtk/gtkcsslookup.c
View File

@ -51,7 +51,7 @@ _gtk_css_lookup_is_missing (const GtkCssLookup *lookup,
* _gtk_css_lookup_set:
* @lookup: the lookup
* @id: id of the property to set, see _gtk_style_property_get_id()
* @section: (allow-none): The @section the value was defined in or %NULL
* @section: (nullable): The @section the value was defined in or %NULL
* @value: the “cascading value” to use
*
* Sets the @value for a given @id. No value may have been set for @id

2
gtk/gtkcssprovider.c
View File

@ -1320,7 +1320,7 @@ _gtk_css_find_theme (const char *name,
* gtk_css_provider_load_named:
* @provider: a `GtkCssProvider`
* @name: A theme name
* @variant: (allow-none): variant to load, for example, "dark", or
* @variant: (nullable): variant to load, for example, "dark", or
* %NULL for the default
*
* Loads a theme from the usual theme paths.

4
gtk/gtkcustompaperunixdialog.c
View File

@ -385,8 +385,8 @@ gtk_custom_paper_unix_dialog_finalize (GObject *object)
/**
* gtk_custom_paper_unix_dialog_new:
* @title: (allow-none): the title of the dialog, or %NULL
* @parent: (allow-none): transient parent of the dialog, or %NULL
* @title: (nullable): the title of the dialog, or %NULL
* @parent: (nullable): transient parent of the dialog, or %NULL
*
* Creates a new custom paper dialog.
*

6
gtk/gtkdialog.c
View File

@ -724,10 +724,10 @@ gtk_dialog_new_empty (const char *title,
/**
* gtk_dialog_new_with_buttons:
* @title: (allow-none): Title of the dialog, or %NULL
* @parent: (allow-none): Transient parent of the dialog, or %NULL
* @title: (nullable): Title of the dialog, or %NULL
* @parent: (nullable): Transient parent of the dialog, or %NULL
* @flags: from `GtkDialogFlags`
* @first_button_text: (allow-none): text to go in first button, or %NULL
* @first_button_text: (nullable): text to go in first button, or %NULL
* @...: response ID for first button, then additional buttons, ending with %NULL
*
* Creates a new `GtkDialog` with the given title and transient parent.

8
gtk/gtkdirectorylist.c
View File

@ -335,8 +335,8 @@ gtk_directory_list_init (GtkDirectoryList *self)
/**
* gtk_directory_list_new:
* @file: (allow-none): The file to query
* @attributes: (allow-none): The attributes to query with
* @file: (nullable): The file to query
* @attributes: (nullable): The attributes to query with
*
* Creates a new `GtkDirectoryList`.
*
@ -659,7 +659,7 @@ gtk_directory_list_update_monitoring (GtkDirectoryList *self)
/**
* gtk_directory_list_set_file: (attributes org.gtk.Method.set_property=file)
* @self: a `GtkDirectoryList`
* @file: (allow-none): the #GFile to be enumerated
* @file: (nullable): the #GFile to be enumerated
*
* Sets the @file to be enumerated and starts the enumeration.
*
@ -707,7 +707,7 @@ gtk_directory_list_get_file (GtkDirectoryList *self)
/**
* gtk_directory_list_set_attributes: (attributes org.gtk.Method.set_property=attributes)
* @self: a `GtkDirectoryList`
* @attributes: (allow-none): the attributes to enumerate
* @attributes: (nullable): the attributes to enumerate
*
* Sets the @attributes to be enumerated and starts the enumeration.
*

2
gtk/gtkdrawingarea.c
View File

@ -453,7 +453,7 @@ gtk_drawing_area_get_content_height (GtkDrawingArea *self)
/**
* gtk_drawing_area_set_draw_func:
* @self: a `GtkDrawingArea`
* @draw_func: (allow-none): callback that lets you draw
* @draw_func: (nullable): callback that lets you draw
* the drawing area's contents
* @user_data: (closure): user data passed to @draw_func
* @destroy: destroy notifier for @user_data

10
gtk/gtkdropdown.c
View File

@ -662,8 +662,8 @@ gtk_drop_down_init (GtkDropDown *self)
/**
* gtk_drop_down_new:
* @model: (transfer full) (allow-none): the model to use or %NULL for none
* @expression: (transfer full) (allow-none): the expression to use or %NULL for none
* @model: (transfer full) (nullable): the model to use or %NULL for none
* @expression: (transfer full) (nullable): the expression to use or %NULL for none
*
* Creates a new `GtkDropDown`.
*
@ -724,7 +724,7 @@ gtk_drop_down_get_model (GtkDropDown *self)
/**
* gtk_drop_down_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkDropDown`
* @model: (allow-none) (transfer none): the model to use or %NULL for none
* @model: (nullable) (transfer none): the model to use or %NULL for none
*
* Sets the `GListModel` to use.
*/
@ -798,7 +798,7 @@ gtk_drop_down_get_factory (GtkDropDown *self)
/**
* gtk_drop_down_set_factory: (attributes org.gtk.Method.set_property=factory)
* @self: a `GtkDropDown`
* @factory: (allow-none) (transfer none): the factory to use or %NULL for none
* @factory: (nullable) (transfer none): the factory to use or %NULL for none
*
* Sets the `GtkListItemFactory` to use for populating list items.
**/
@ -838,7 +838,7 @@ gtk_drop_down_get_list_factory (GtkDropDown *self)
/**
* gtk_drop_down_set_list_factory: (attributes org.gtk.Method.set_property=list-factory)
* @self: a `GtkDropDown`
* @factory: (allow-none) (transfer none): the factory to use or %NULL for none
* @factory: (nullable) (transfer none): the factory to use or %NULL for none
*
* Sets the `GtkListItemFactory` to use for populating list items in the popup.
*/

4
gtk/gtkeditable.c
View File

@ -666,8 +666,8 @@ gtk_editable_get_position (GtkEditable *editable)
/**
* gtk_editable_get_selection_bounds:
* @editable: a `GtkEditable`
* @start_pos: (out) (allow-none): location to store the starting position, or %NULL
* @end_pos: (out) (allow-none): location to store the end position, or %NULL
* @start_pos: (out) (optional): location to store the starting position, or %NULL
* @end_pos: (out) (optional): location to store the end position, or %NULL
*
* Retrieves the selection bound of the editable.
*

14
gtk/gtkentry.c
View File

@ -2467,7 +2467,7 @@ gtk_entry_get_alignment (GtkEntry *entry)
* gtk_entry_set_icon_from_paintable:
* @entry: a `GtkEntry`
* @icon_pos: Icon position
* @paintable: (allow-none): A `GdkPaintable`, or %NULL
* @paintable: (nullable): A `GdkPaintable`, or %NULL
*
* Sets the icon shown in the specified position using a `GdkPaintable`.
*
@ -2522,7 +2522,7 @@ gtk_entry_set_icon_from_paintable (GtkEntry *entry,
* gtk_entry_set_icon_from_icon_name:
* @entry: A `GtkEntry`
* @icon_pos: The position at which to set the icon
* @icon_name: (allow-none): An icon name, or %NULL
* @icon_name: (nullable): An icon name, or %NULL
*
* Sets the icon shown in the entry at the specified position
* from the current icon theme.
@ -2578,7 +2578,7 @@ gtk_entry_set_icon_from_icon_name (GtkEntry *entry,
* gtk_entry_set_icon_from_gicon:
* @entry: A `GtkEntry`
* @icon_pos: The position at which to set the icon
* @icon: (allow-none): The icon to set, or %NULL
* @icon: (nullable): The icon to set, or %NULL
*
* Sets the icon shown in the entry at the specified position
* from the current icon theme.
@ -3091,7 +3091,7 @@ gtk_entry_get_icon_tooltip_text (GtkEntry *entry,
* gtk_entry_set_icon_tooltip_text:
* @entry: a `GtkEntry`
* @icon_pos: the icon position
* @tooltip: (allow-none): the contents of the tooltip for the
* @tooltip: (nullable): the contents of the tooltip for the
* icon, or %NULL
*
* Sets @tooltip as the contents of the tooltip for the icon
@ -3177,7 +3177,7 @@ gtk_entry_get_icon_tooltip_markup (GtkEntry *entry,
* gtk_entry_set_icon_tooltip_markup:
* @entry: a `GtkEntry`
* @icon_pos: the icon position
* @tooltip: (allow-none): the contents of the tooltip for the
* @tooltip: (nullable): the contents of the tooltip for the
* icon, or %NULL
*
* Sets @tooltip as the contents of the tooltip for the icon at
@ -3261,7 +3261,7 @@ gtk_entry_query_tooltip (GtkWidget *widget,
/**
* gtk_entry_set_completion: (attributes org.gtk.Method.set_property=completion)
* @entry: A `GtkEntry`
* @completion: (allow-none): The `GtkEntryCompletion` or %NULL
* @completion: (nullable): The `GtkEntryCompletion` or %NULL
*
* Sets @completion to be the auxiliary completion object
* to use with @entry.
@ -3772,7 +3772,7 @@ gtk_entry_get_text_widget (GtkEntry *entry)
/**
* gtk_entry_set_extra_menu: (attributes org.gtk.Method.set_property=extra-menu)
* @entry: a `GtkEntry`
* @model: (allow-none): a `GMenuModel`
* @model: (nullable): a `GMenuModel`
*
* Sets a menu model to add when constructing
* the context menu for @entry.

2
gtk/gtkentrybuffer.c
View File

@ -424,7 +424,7 @@ gtk_entry_buffer_class_init (GtkEntryBufferClass *klass)
/**
* gtk_entry_buffer_new:
* @initial_chars: (allow-none): initial buffer text, or %NULL
* @initial_chars: (nullable): initial buffer text, or %NULL
* @n_initial_chars: number of characters in @initial_chars, or -1
*
* Create a new `GtkEntryBuffer` object.

2
gtk/gtkentrycompletion.c
View File

@ -877,7 +877,7 @@ gtk_entry_completion_get_entry (GtkEntryCompletion *completion)
/**
* gtk_entry_completion_set_model: (attributes org.gtk.Method.set_property=model)
* @completion: a `GtkEntryCompletion`
* @model: (allow-none): the `GtkTreeModel`
* @model: (nullable): the `GtkTreeModel`
*
* Sets the model for a `GtkEntryCompletion`.
*

2
gtk/gtkexpander.c
View File

@ -1186,7 +1186,7 @@ gtk_expander_get_resize_toplevel (GtkExpander *expander)
/**
* gtk_expander_set_child: (attributes org.gtk.Method.set_property=child)
* @expander: a `GtkExpander`
* @child: (allow-none): the child widget
* @child: (nullable): the child widget
*
* Sets the child widget of @expander.
*/

2
gtk/gtkfilechooser.c
View File

@ -450,7 +450,7 @@ gtk_file_chooser_get_files (GtkFileChooser *chooser)
* gtk_file_chooser_set_file:
* @chooser: a `GtkFileChooser`
* @file: the `GFile` to set as current
* @error: (allow-none): location to store the error, or %NULL to ignore errors.
* @error: (nullable): location to store the error, or %NULL to ignore errors.
*
* Sets @file as the current filename for the file chooser.
*

6
gtk/gtkfilechooserdialog.c
View File

@ -707,10 +707,10 @@ gtk_file_chooser_dialog_new_valist (const char *title,
/**
* gtk_file_chooser_dialog_new:
* @title: (allow-none): Title of the dialog, or %NULL
* @parent: (allow-none): Transient parent of the dialog, or %NULL
* @title: (nullable): Title of the dialog, or %NULL
* @parent: (nullable): Transient parent of the dialog, or %NULL
* @action: Open or save mode for the dialog
* @first_button_text: (allow-none): text to go in the first button, or %NULL
* @first_button_text: (nullable): text to go in the first button, or %NULL
* @...: response ID for the first button, then additional (button, id) pairs, ending with %NULL
*
* Creates a new `GtkFileChooserDialog`.

12
gtk/gtkfilechoosernative.c
View File

@ -231,7 +231,7 @@ gtk_file_chooser_native_get_accept_label (GtkFileChooserNative *self)
/**
* gtk_file_chooser_native_set_accept_label: (attributes org.gtk.Method.set_property=accept-label)
* @self: a `GtkFileChooserNative`
* @accept_label: (allow-none): custom label or %NULL for the default
* @accept_label: (nullable): custom label or %NULL for the default
*
* Sets the custom label text for the accept button.
*
@ -274,7 +274,7 @@ gtk_file_chooser_native_get_cancel_label (GtkFileChooserNative *self)
/**
* gtk_file_chooser_native_set_cancel_label: (attributes org.gtk.Method.set_property=cancel-label)
* @self: a `GtkFileChooserNative`
* @cancel_label: (allow-none): custom label or %NULL for the default
* @cancel_label: (nullable): custom label or %NULL for the default
*
* Sets the custom label text for the cancel button.
*
@ -520,11 +520,11 @@ gtk_file_chooser_native_init (GtkFileChooserNative *self)
/**
* gtk_file_chooser_native_new:
* @title: (allow-none): Title of the native, or %NULL
* @parent: (allow-none): Transient parent of the native, or %NULL
* @title: (nullable): Title of the native, or %NULL
* @parent: (nullable): Transient parent of the native, or %NULL
* @action: Open or save mode for the dialog
* @accept_label: (allow-none): text to go in the accept button, or %NULL for the default
* @cancel_label: (allow-none): text to go in the cancel button, or %NULL for the default
* @accept_label: (nullable): text to go in the accept button, or %NULL for the default
* @cancel_label: (nullable): text to go in the cancel button, or %NULL for the default
*
* Creates a new `GtkFileChooserNative`.
*

2
gtk/gtkfilefilter.c
View File

@ -442,7 +442,7 @@ gtk_file_filter_new (void)
/**
* gtk_file_filter_set_name: (attributes org.gtk.Method.set_property=name)
* @filter: a `GtkFileFilter`
* @name: (allow-none): the human-readable-name for the filter, or %NULL
* @name: (nullable): the human-readable-name for the filter, or %NULL
* to remove any existing name.
*
* Sets a human-readable name of the filter.

4
gtk/gtkfilesystemmodel.c
View File

@ -1370,7 +1370,7 @@ _gtk_file_system_model_new (GtkFileSystemModelGetValue get_func,
/**
* _gtk_file_system_model_new_for_directory:
* @directory: the directory to show.
* @attributes: (allow-none): attributes to immediately load or %NULL for all
* @attributes: (nullable): attributes to immediately load or %NULL for all
* @get_func: function that the model should call to query data about a file
* @get_data: user data to pass to the @get_func
* @n_columns: number of columns
@ -1933,7 +1933,7 @@ _gtk_file_system_model_update_files (GtkFileSystemModel *model,
/**
* _gtk_file_system_model_set_filter:
* @mode: a #GtkFileSystemModel
* @filter: (allow-none): %NULL or filter to use
* @filter: (nullable): %NULL or filter to use
*
* Sets a filter to be used for deciding if a row should be visible or not.
* Whether this filter applies to directories can be toggled with

8
gtk/gtkfilterlistmodel.c
View File

@ -610,8 +610,8 @@ gtk_filter_list_model_init (GtkFilterListModel *self)
/**
* gtk_filter_list_model_new:
* @model: (allow-none) (transfer full): the model to sort, or %NULL
* @filter: (allow-none) (transfer full): filter or %NULL to not filter items
* @model: (nullable) (transfer full): the model to sort, or %NULL
* @filter: (nullable) (transfer full): filter or %NULL to not filter items
*
* Creates a new `GtkFilterListModel` that will filter @model using the given
* @filter.
@ -642,7 +642,7 @@ gtk_filter_list_model_new (GListModel *model,
/**
* gtk_filter_list_model_set_filter: (attributes org.gtk.Method.set_property=filter)
* @self: a `GtkFilterListModel`
* @filter: (allow-none) (transfer none): filter to use or %NULL to not filter items
* @filter: (nullable) (transfer none): filter to use or %NULL to not filter items
*
* Sets the filter used to filter items.
**/
@ -691,7 +691,7 @@ gtk_filter_list_model_get_filter (GtkFilterListModel *self)
/**
* gtk_filter_list_model_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkFilterListModel`
* @model: (allow-none): The model to be filtered
* @model: (nullable): The model to be filtered
*
* Sets the model to be filtered.
*

8
gtk/gtkflowbox.c
View File

@ -591,7 +591,7 @@ gtk_flow_box_child_new (void)
/**
* gtk_flow_box_child_set_child: (attributes org.gtk.Method.set_property=child)
* @self: a `GtkFlowBoxChild`
* @child: (allow-none): the child widget
* @child: (nullable): the child widget
*
* Sets the child widget of @self.
*/
@ -4263,7 +4263,7 @@ gtk_flow_box_check_model_compat (GtkFlowBox *box)
/**
* gtk_flow_box_bind_model:
* @box: a `GtkFlowBox`
* @model: (allow-none): the `GListModel` to be bound to @box
* @model: (nullable): the `GListModel` to be bound to @box
* @create_widget_func: a function that creates widgets for items
* @user_data: (closure): user data passed to @create_widget_func
* @user_data_free_func: function for freeing @user_data
@ -4805,7 +4805,7 @@ gtk_flow_box_get_selection_mode (GtkFlowBox *box)
/**
* gtk_flow_box_set_filter_func:
* @box: a `GtkFlowBox`
* @filter_func: (allow-none): callback that
* @filter_func: (nullable): callback that
* lets you filter which children to show
* @user_data: (closure): user data passed to @filter_func
* @destroy: destroy notifier for @user_data
@ -4887,7 +4887,7 @@ gtk_flow_box_invalidate_filter (GtkFlowBox *box)
/**
* gtk_flow_box_set_sort_func:
* @box: a `GtkFlowBox`
* @sort_func: (allow-none): the sort function
* @sort_func: (nullable): the sort function
* @user_data: (closure): user data passed to @sort_func
* @destroy: destroy notifier for @user_data
*

4
gtk/gtkfontchooser.c
View File

@ -405,7 +405,7 @@ gtk_font_chooser_set_show_preview_entry (GtkFontChooser *fontchooser,
/**
* gtk_font_chooser_set_filter_func:
* @fontchooser: a `GtkFontChooser`
* @filter: (allow-none): a `GtkFontFilterFunc`, or %NULL
* @filter: (nullable): a `GtkFontFilterFunc`, or %NULL
* @user_data: (closure): data to pass to @filter
* @destroy: function to call to free @data when it is no longer needed
*
@ -438,7 +438,7 @@ _gtk_font_chooser_font_activated (GtkFontChooser *chooser,
/**
* gtk_font_chooser_set_font_map:
* @fontchooser: a `GtkFontChooser`
* @fontmap: (allow-none): a `PangoFontMap`
* @fontmap: (nullable): a `PangoFontMap`
*
* Sets a custom font map to use for this font chooser widget.
*

4
gtk/gtkfontchooserdialog.c
View File

@ -281,8 +281,8 @@ gtk_font_chooser_dialog_init (GtkFontChooserDialog *dialog)
/**
* gtk_font_chooser_dialog_new:
* @title: (allow-none): Title of the dialog, or %NULL
* @parent: (allow-none): Transient parent of the dialog, or %NULL
* @title: (nullable): Title of the dialog, or %NULL
* @parent: (nullable): Transient parent of the dialog, or %NULL
*
* Creates a new `GtkFontChooserDialog`.
*

6
gtk/gtkframe.c
View File

@ -323,7 +323,7 @@ gtk_frame_get_property (GObject *object,
/**
* gtk_frame_new:
* @label: (allow-none): the text to use as the label of the frame
* @label: (nullable): the text to use as the label of the frame
*
* Creates a new `GtkFrame`, with optional label @label.
*
@ -340,7 +340,7 @@ gtk_frame_new (const char *label)
/**
* gtk_frame_set_label: (attributes org.gtk.Method.set_property=label)
* @frame: a `GtkFrame`
* @label: (allow-none): the text to use as the label of the frame
* @label: (nullable): the text to use as the label of the frame
*
* Creates a new `GtkLabel` with the @label and sets it as the frame's
* label widget.
@ -668,7 +668,7 @@ gtk_frame_get_request_mode (GtkWidget *widget)
/**
* gtk_frame_set_child: (attributes org.gtk.Method.set_property=child)
* @frame: a `GtkFrame`
* @child: (allow-none): the child widget
* @child: (nullable): the child widget
*
* Sets the child widget of @frame.
*/

6
gtk/gtkgesture.c
View File

@ -1226,9 +1226,9 @@ gtk_gesture_get_last_target (GtkGesture *gesture,
/**
* gtk_gesture_get_point:
* @gesture: a `GtkGesture`
* @sequence: (allow-none): a `GdkEventSequence`, or %NULL for pointer events
* @x: (out) (allow-none): return location for X axis of the sequence coordinates
* @y: (out) (allow-none): return location for Y axis of the sequence coordinates
* @sequence: (nullable): a `GdkEventSequence`, or %NULL for pointer events
* @x: (out) (optional): return location for X axis of the sequence coordinates
* @y: (out) (optional): return location for Y axis of the sequence coordinates
*
* If @sequence is currently being interpreted by @gesture,
* returns %TRUE and fills in @x and @y with the last coordinates

4
gtk/gtkglarea.c
View File

@ -938,7 +938,7 @@ gtk_gl_area_class_init (GtkGLAreaClass *klass)
/**
* GtkGLArea::create-context:
* @area: the `GtkGLArea` that emitted the signal
* @error: (allow-none): location to store error information on failure
* @error: (nullable): location to store error information on failure
*
* Emitted when the widget is being realized.
*
@ -992,7 +992,7 @@ gtk_gl_area_new (void)
/**
* gtk_gl_area_set_error:
* @area: a `GtkGLArea`
* @error: (allow-none): a new `GError`, or %NULL to unset the error
* @error: (nullable): a new `GError`, or %NULL to unset the error
*
* Sets an error on the area which will be shown instead of the
* GL rendering.

2
gtk/gtkgrid.c
View File

@ -580,7 +580,7 @@ gtk_grid_attach (GtkGrid *grid,
* gtk_grid_attach_next_to:
* @grid: a `GtkGrid`
* @child: the widget to add
* @sibling: (allow-none): the child of @grid that @child will be placed
* @sibling: (nullable): the child of @grid that @child will be placed
* next to, or %NULL to place @child at the beginning or end
* @side: the side of @sibling that @child is positioned next to
* @width: the number of columns that @child will span

8
gtk/gtkgridview.c
View File

@ -1185,8 +1185,8 @@ gtk_grid_view_init (GtkGridView *self)
/**
* gtk_grid_view_new:
* @model: (allow-none) (transfer full): the model to use, or %NULL
* @factory: (allow-none) (transfer full): The factory to populate items with, or %NULL
* @model: (nullable) (transfer full): the model to use, or %NULL
* @factory: (nullable) (transfer full): The factory to populate items with, or %NULL
*
* Creates a new `GtkGridView` that uses the given @factory for
* mapping items to widgets.
@ -1240,7 +1240,7 @@ gtk_grid_view_get_model (GtkGridView *self)
/**
* gtk_grid_view_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkGridView`
* @model: (allow-none) (transfer none): the model to use or %NULL for none
* @model: (nullable) (transfer none): the model to use or %NULL for none
*
* Sets the imodel to use.
*
@ -1282,7 +1282,7 @@ gtk_grid_view_get_factory (GtkGridView *self)
/**
* gtk_grid_view_set_factory: (attributes org.gtk.Method.set_property=factory)
* @self: a `GtkGridView`
* @factory: (allow-none) (transfer none): the factory to use or %NULL for none
* @factory: (nullable) (transfer none): the factory to use or %NULL for none
*
* Sets the `GtkListItemFactory` to use for populating list items.
*/

4
gtk/gtkheaderbar.c
View File

@ -284,7 +284,7 @@ construct_title_label (GtkHeaderBar *bar)
/**
* gtk_header_bar_set_title_widget:
* @bar: a `GtkHeaderBar`
* @title_widget: (allow-none): a widget to use for a title
* @title_widget: (nullable): a widget to use for a title
*
* Sets the title for the `GtkHeaderBar`.
*
@ -769,7 +769,7 @@ gtk_header_bar_set_show_title_buttons (GtkHeaderBar *bar,
/**
* gtk_header_bar_set_decoration_layout: (attributes org.gtk.Method.set_property=decoration-layout)
* @bar: a `GtkHeaderBar`
* @layout: (allow-none): a decoration layout, or %NULL to
* @layout: (nullable): a decoration layout, or %NULL to
* unset the layout
*
* Sets the decoration layout for this header bar.

10
gtk/gtkicontheme.c
View File

@ -1637,7 +1637,7 @@ gtk_icon_theme_add_resource_path (GtkIconTheme *self,
/**
* gtk_icon_theme_set_theme_name:
* @self: a `GtkIconTheme`
* @theme_name: (allow-none): name of icon theme to use instead of
* @theme_name: (nullable): name of icon theme to use instead of
* configured theme, or %NULL to unset a previously set custom theme
*
* Sets the name of the icon theme that the `GtkIconTheme` object uses
@ -3966,13 +3966,13 @@ icon_paintable_snapshot (GdkPaintable *paintable,
* @snapshot: a `GdkSnapshot` to snapshot to
* @width: width to snapshot in
* @height: height to snapshot in
* @foreground_color: (allow-none): a `GdkRGBA` representing the foreground color
* @foreground_color: (nullable): a `GdkRGBA` representing the foreground color
* of the icon or %NULL to use the default color.
* @success_color: (allow-none): a `GdkRGBA` representing the warning color
* @success_color: (nullable): a `GdkRGBA` representing the warning color
* of the icon or %NULL to use the default color
* @warning_color: (allow-none): a `GdkRGBA` representing the warning color
* @warning_color: (nullable): a `GdkRGBA` representing the warning color
* of the icon or %NULL to use the default color
* @error_color: (allow-none): a `GdkRGBA` representing the error color
* @error_color: (nullable): a `GdkRGBA` representing the error color
* of the icon or %NULL to use the default color
*
* Snapshots the `GtkIconPaintable`.

36
gtk/gtkiconview.c
View File

@ -1955,7 +1955,7 @@ gtk_icon_view_remove_editable (GtkCellArea *area,
* gtk_icon_view_set_cursor:
* @icon_view: A #GtkIconView
* @path: A #GtkTreePath
* @cell: (allow-none): One of the cell renderers of @icon_view, or %NULL
* @cell: (nullable): One of the cell renderers of @icon_view, or %NULL
* @start_editing: %TRUE if the specified cell should start being edited.
*
* Sets the current keyboard focus to be at @path, and selects it. This is
@ -2009,9 +2009,9 @@ gtk_icon_view_set_cursor (GtkIconView *icon_view,
/**
* gtk_icon_view_get_cursor:
* @icon_view: A #GtkIconView
* @path: (out) (allow-none) (transfer full): Return location for the current
* @path: (out) (optional) (transfer full): Return location for the current
* cursor path
* @cell: (out) (allow-none) (transfer none): Return location the current
* @cell: (out) (optional) (transfer none): Return location the current
* focus cell
*
* Fills in @path and @cell with the current cursor path and cell.
@ -4110,8 +4110,8 @@ 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: (out) (allow-none): Return location for the path, or %NULL
* @cell: (out) (allow-none) (transfer none): Return location for the renderer
* @path: (out) (optional): Return location for the path, or %NULL
* @cell: (out) (optional) (transfer none): Return location for the renderer
* responsible for the cell at (@x, @y), or %NULL
*
* Gets the path and cell for the icon at the given position.
@ -4150,7 +4150,7 @@ gtk_icon_view_get_item_at_pos (GtkIconView *icon_view,
* gtk_icon_view_get_cell_rect:
* @icon_view: a #GtkIconView
* @path: a #GtkTreePath
* @cell: (allow-none): a #GtkCellRenderer or %NULL
* @cell: (nullable): a #GtkCellRenderer or %NULL
* @rect: (out): rectangle to fill with cell rect
*
* Fills the bounding rectangle in widget coordinates for the cell specified by
@ -4225,7 +4225,7 @@ gtk_icon_view_set_tooltip_item (GtkIconView *icon_view,
* @icon_view: a #GtkIconView
* @tooltip: a #GtkTooltip
* @path: a #GtkTreePath
* @cell: (allow-none): a #GtkCellRenderer or %NULL
* @cell: (nullable): a #GtkCellRenderer or %NULL
*
* Sets the tip area of @tooltip to the area which @cell occupies in
* the item pointed to by @path. See also gtk_tooltip_set_tip_area().
@ -4257,9 +4257,9 @@ gtk_icon_view_set_tooltip_cell (GtkIconView *icon_view,
* @x: the x coordinate (relative to widget coordinates)
* @y: the y coordinate (relative to widget coordinates)
* @keyboard_tip: whether this is a keyboard tooltip or not
* @model: (out) (allow-none) (transfer none): a pointer to receive a `GtkTreeModel`
* @path: (out) (allow-none): a pointer to receive a `GtkTreePath`
* @iter: (out) (allow-none): a pointer to receive a `GtkTreeIter`
* @model: (out) (optional) (transfer none): a pointer to receive a `GtkTreeModel`
* @path: (out) (optional): a pointer to receive a `GtkTreePath`
* @iter: (out) (optional): a pointer to receive a `GtkTreeIter`
*
* This function is supposed to be used in a #GtkWidget::query-tooltip
* signal handler for #GtkIconView. The @x, @y and @keyboard_tip values
@ -4420,8 +4420,8 @@ gtk_icon_view_get_tooltip_column (GtkIconView *icon_view)
/**
* gtk_icon_view_get_visible_range:
* @icon_view: A #GtkIconView
* @start_path: (out) (allow-none): Return location for start of region
* @end_path: (out) (allow-none): Return location for end of region
* @start_path: (out) (optional): Return location for start of region
* @end_path: (out) (optional): Return location for end of region
*
* Sets @start_path and @end_path to be the first and last visible path.
* Note that there may be invisible paths in between.
@ -4548,7 +4548,7 @@ gtk_icon_view_get_selection_mode (GtkIconView *icon_view)
/**
* gtk_icon_view_set_model:
* @icon_view: A #GtkIconView.
* @model: (allow-none): The model.
* @model: (nullable): The model.
*
* Sets the model for a #GtkIconView.
* If the @icon_view already has a model set, it will remove
@ -6368,7 +6368,7 @@ gtk_icon_view_unset_model_drag_dest (GtkIconView *icon_view)
/**
* gtk_icon_view_set_drag_dest_item:
* @icon_view: a #GtkIconView
* @path: (allow-none): The path of the item to highlight, or %NULL.
* @path: (nullable): The path of the item to highlight, or %NULL.
* @pos: Specifies where to drop, relative to the item
*
* Sets the item that is highlighted for feedback.
@ -6425,9 +6425,9 @@ gtk_icon_view_set_drag_dest_item (GtkIconView *icon_view,
/**
* gtk_icon_view_get_drag_dest_item:
* @icon_view: a #GtkIconView
* @path: (out) (allow-none): Return location for the path of
* @path: (out) (optional): Return location for the path of
* the highlighted item
* @pos: (out) (allow-none): Return location for the drop position
* @pos: (out) (optional): Return location for the drop position
*
* Gets information about the item that is highlighted for feedback.
*/
@ -6455,9 +6455,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: (out) (allow-none): Return location for the path of the item,
* @path: (out) (optional): Return location for the path of the item,
* or %NULL.
* @pos: (out) (allow-none): Return location for the drop position, or %NULL
* @pos: (out) (optional): Return location for the drop position, or %NULL
*
* Determines the destination item for a given position.
*

14
gtk/gtkimage.c
View File

@ -477,7 +477,7 @@ gtk_image_new_from_resource (const char *resource_path)
/**
* gtk_image_new_from_pixbuf:
* @pixbuf: (allow-none): a `GdkPixbuf`, or %NULL
* @pixbuf: (nullable): a `GdkPixbuf`, or %NULL
*
* Creates a new `GtkImage` displaying @pixbuf.
*
@ -508,7 +508,7 @@ gtk_image_new_from_pixbuf (GdkPixbuf *pixbuf)
/**
* gtk_image_new_from_paintable:
* @paintable: (allow-none): a `GdkPaintable`, or %NULL
* @paintable: (nullable): a `GdkPaintable`, or %NULL
*
* Creates a new `GtkImage` displaying @paintable.
*
@ -584,7 +584,7 @@ gtk_image_new_from_gicon (GIcon *icon)
/**
* gtk_image_set_from_file: (attributes org.gtk.Method.set_property=file)
* @image: a `GtkImage`
* @filename: (type filename) (allow-none): a filename or %NULL
* @filename: (type filename) (nullable): a filename or %NULL
*
* Sets a `GtkImage` to show a file.
*
@ -662,7 +662,7 @@ out:
/**
* gtk_image_set_from_resource: (attributes org.gtk.Method.set_property=resource)
* @image: a `GtkImage`
* @resource_path: (allow-none): a resource path or %NULL
* @resource_path: (nullable): a resource path or %NULL
*
* Sets a `GtkImage` to show a resource.
*
@ -720,7 +720,7 @@ gtk_image_set_from_resource (GtkImage *image,
/**
* gtk_image_set_from_pixbuf: (attributes org.gtk.Method.set_property=paintable)
* @image: a `GtkImage`
* @pixbuf: (allow-none): a `GdkPixbuf` or `NULL`
* @pixbuf: (nullable): a `GdkPixbuf` or `NULL`
*
* Sets a `GtkImage` to show a `GdkPixbuf`.
*
@ -925,7 +925,7 @@ gtk_image_get_paintable (GtkImage *image)
* The returned string is owned by the `GtkImage` and should not
* be freed.
*
* Returns: (transfer none) (allow-none): the icon name, or %NULL
* Returns: (transfer none) (nullable): the icon name, or %NULL
*/
const char *
gtk_image_get_icon_name (GtkImage *image)
@ -946,7 +946,7 @@ gtk_image_get_icon_name (GtkImage *image)
* The caller of this function does not own a reference to the
* returned `GIcon`.
*
* Returns: (transfer none) (allow-none): a `GIcon`, or %NULL
* Returns: (transfer none) (nullable): a `GIcon`, or %NULL
**/
GIcon *
gtk_image_get_gicon (GtkImage *image)

2
gtk/gtkimcontext.c
View File

@ -436,7 +436,7 @@ gtk_im_context_real_get_surrounding_with_selection (GtkIMContext *context,
/**
* gtk_im_context_set_client_widget:
* @context: a `GtkIMContext`
* @widget: (allow-none): the client widget. This may be %NULL to indicate
* @widget: (nullable): the client widget. This may be %NULL to indicate
* that the previous client widget no longer exists.
*
* Set the client widget for the input context.

2
gtk/gtkinfobar.c
View File

@ -702,7 +702,7 @@ gtk_info_bar_new (void)
/**
* gtk_info_bar_new_with_buttons:
* @first_button_text: (allow-none): ext to go in first button, or %NULL
* @first_button_text: (nullable): ext to go in first button, or %NULL
* @...: response ID for first button, then additional buttons, ending
* with %NULL
*

2
gtk/gtklabel.c
View File

@ -5729,7 +5729,7 @@ gtk_label_get_yalign (GtkLabel *self)
/**
* gtk_label_set_extra_menu: (attributes org.gtk.Method.set_property=extra-menu)
* @self: a `GtkLabel`
* @model: (allow-none): a `GMenuModel`
* @model: (nullable): a `GMenuModel`
*
* Sets a menu model to add when constructing
* the context menu for @label.

4
gtk/gtklevelbar.c
View File

@ -1329,7 +1329,7 @@ gtk_level_bar_set_inverted (GtkLevelBar *self,
/**
* gtk_level_bar_remove_offset_value:
* @self: a `GtkLevelBar`
* @name: (allow-none): the name of an offset in the bar
* @name: (nullable): the name of an offset in the bar
*
* Removes an offset marker from a `GtkLevelBar`.
*
@ -1391,7 +1391,7 @@ gtk_level_bar_add_offset_value (GtkLevelBar *self,
/**
* gtk_level_bar_get_offset_value:
* @self: a `GtkLevelBar`
* @name: (allow-none): the name of an offset in the bar
* @name: (nullable): the name of an offset in the bar
* @value: (out): location where to store the value
*
* Fetches the value specified for the offset marker @name in @self.

2
gtk/gtklinkbutton.c
View File

@ -558,7 +558,7 @@ gtk_link_button_new (const char *uri)
/**
* gtk_link_button_new_with_label:
* @uri: a valid URI
* @label: (allow-none): the text of the button
* @label: (nullable): the text of the button
*
* Creates a new `GtkLinkButton` containing a label.
*

10
gtk/gtklistbase.c
View File

@ -111,7 +111,7 @@ static GParamSpec *properties[N_PROPS] = { NULL, };
* @across: position in pixels in the direction cross to the list
* @along: position in pixels in the direction of the list
* @pos: (out caller-allocates): set to the looked up position
* @area: (out caller-allocates) (allow-none): set to the area occupied
* @area: (out caller-allocates) (optional): set to the area occupied
* by the returned position
*
* Given a coordinate in list coordinates, determine the position of the
@ -324,9 +324,9 @@ gtk_list_base_move_focus (GtkListBase *self,
* gtk_list_base_get_allocation_along:
* @self: a #GtkListBase
* @pos: item to get the size of
* @offset: (out caller-allocates) (allow-none) set to the offset
* @offset: (out caller-allocates) (optional): set to the offset
* of the top/left of the item
* @size: (out caller-allocates) (allow-none) set to the size of
* @size: (out caller-allocates) (optional): set to the size of
* the item in the direction
*
* Computes the allocation of the item in the direction along the sizing
@ -347,9 +347,9 @@ gtk_list_base_get_allocation_along (GtkListBase *self,
* gtk_list_base_get_allocation_across:
* @self: a #GtkListBase
* @pos: item to get the size of
* @offset: (out caller-allocates) (allow-none) set to the offset
* @offset: (out caller-allocates) (optional): set to the offset
* of the top/left of the item
* @size: (out caller-allocates) (allow-none) set to the size of
* @size: (out caller-allocates) (optional): set to the size of
* the item in the direction
*
* Computes the allocation of the item in the direction across to the sizing

16
gtk/gtklistbox.c
View File

@ -846,7 +846,7 @@ gtk_list_box_get_row_at_y (GtkListBox *box,
/**
* gtk_list_box_select_row:
* @box: a `GtkListBox`
* @row: (allow-none): The row to select or %NULL
* @row: (nullable): The row to select or %NULL
*
* Make @row the currently selected row.
*/
@ -1014,7 +1014,7 @@ gtk_list_box_get_selected_rows (GtkListBox *box)
/**
* gtk_list_box_set_placeholder:
* @box: a `GtkListBox`
* @placeholder: (allow-none): a #GtkWidget or %NULL
* @placeholder: (nullable): a #GtkWidget or %NULL
*
* Sets the placeholder widget that is shown in the list when
* it doesn't display any visible children.
@ -1045,7 +1045,7 @@ gtk_list_box_set_placeholder (GtkListBox *box,
/**
* gtk_list_box_set_adjustment:
* @box: a `GtkListBox`
* @adjustment: (allow-none): the adjustment, or %NULL
* @adjustment: (nullable): the adjustment, or %NULL
*
* Sets the adjustment (if any) that the widget uses to
* for vertical scrolling.
@ -1190,7 +1190,7 @@ gtk_list_box_get_selection_mode (GtkListBox *box)
/**
* gtk_list_box_set_filter_func:
* @box: a `GtkListBox`
* @filter_func: (allow-none): callback that lets you filter which rows to show
* @filter_func: (nullable): callback that lets you filter which rows to show
* @user_data: (closure): user data passed to @filter_func
* @destroy: destroy notifier for @user_data
*
@ -1231,7 +1231,7 @@ gtk_list_box_set_filter_func (GtkListBox *box,
/**
* gtk_list_box_set_header_func:
* @box: a `GtkListBox`
* @update_header: (allow-none): callback that lets you add row headers
* @update_header: (nullable): callback that lets you add row headers
* @user_data: (closure): user data passed to @update_header
* @destroy: destroy notifier for @user_data
*
@ -1386,7 +1386,7 @@ gtk_list_box_invalidate_headers (GtkListBox *box)
/**
* gtk_list_box_set_sort_func:
* @box: a `GtkListBox`
* @sort_func: (allow-none): the sort function
* @sort_func: (nullable): the sort function
* @user_data: (closure): user data passed to @sort_func
* @destroy: destroy notifier for @user_data
*
@ -2953,7 +2953,7 @@ gtk_list_box_row_new (void)
/**
* gtk_list_box_row_set_child: (attributes org.gtk.Method.set_property=child)
* @row: a `GtkListBoxRow`
* @child: (allow-none): the child widget
* @child: (nullable): the child widget
*
* Sets the child widget of @self.
*/
@ -3167,7 +3167,7 @@ gtk_list_box_row_get_header (GtkListBoxRow *row)
/**
* gtk_list_box_row_set_header:
* @row: a `GtkListBoxRow`
* @header: (allow-none): the header, or %NULL
* @header: (nullable): the header, or %NULL
*
* Sets the current header of the @row.
*

2
gtk/gtklistbox.h
View File

@ -100,7 +100,7 @@ typedef int (*GtkListBoxSortFunc) (GtkListBoxRow *row1,
/**
* GtkListBoxUpdateHeaderFunc:
* @row: the row to update
* @before: (allow-none): the row before @row, or %NULL if it is first
* @before: (nullable): the row before @row, or %NULL if it is first
* @user_data: (closure): user data
*
* Whenever @row changes or which row is before @row changes this

2
gtk/gtklistitemmanager.c
View File

@ -1051,7 +1051,7 @@ gtk_list_item_manager_update_list_item (GtkListItemManager *self,
/*
* gtk_list_item_manager_release_list_item:
* @self: a #GtkListItemManager
* @change: (allow-none): The change associated with this release or
* @change: (nullable): The change associated with this release or
* %NULL if this is a final removal
* @item: an item previously acquired with
* gtk_list_item_manager_acquire_list_item()

8
gtk/gtkliststore.c
View File

@ -1284,7 +1284,7 @@ gtk_list_store_insert (GtkListStore *list_store,
* gtk_list_store_insert_before:
* @list_store: A #GtkListStore
* @iter: (out): An unset #GtkTreeIter to set to the new row
* @sibling: (allow-none): A valid #GtkTreeIter, or %NULL
* @sibling: (nullable): A valid #GtkTreeIter, or %NULL
*
* Inserts a new row before @sibling. If @sibling is %NULL, then the row will
* be appended to the end of the list. @iter will be changed to point to this
@ -1320,7 +1320,7 @@ gtk_list_store_insert_before (GtkListStore *list_store,
* gtk_list_store_insert_after:
* @list_store: A #GtkListStore
* @iter: (out): An unset #GtkTreeIter to set to the new row
* @sibling: (allow-none): A valid #GtkTreeIter, or %NULL
* @sibling: (nullable): A valid #GtkTreeIter, or %NULL
*
* Inserts a new row after @sibling. If @sibling is %NULL, then the row will be
* prepended to the beginning of the list. @iter will be changed to point to
@ -1840,7 +1840,7 @@ gtk_list_store_move_to (GtkListStore *store,
* gtk_list_store_move_before:
* @store: A #GtkListStore.
* @iter: A #GtkTreeIter.
* @position: (allow-none): A #GtkTreeIter, or %NULL.
* @position: (nullable): A #GtkTreeIter, or %NULL.
*
* Moves @iter in @store to the position before @position. Note that this
* function only works with unsorted stores. If @position is %NULL, @iter
@ -1871,7 +1871,7 @@ gtk_list_store_move_before (GtkListStore *store,
* gtk_list_store_move_after:
* @store: A #GtkListStore.
* @iter: A #GtkTreeIter.
* @position: (allow-none): A #GtkTreeIter or %NULL.
* @position: (nullable): A #GtkTreeIter or %NULL.
*
* Moves @iter in @store to the position after @position. Note that this
* function only works with unsorted stores. If @position is %NULL, @iter

8
gtk/gtklistview.c
View File

@ -926,8 +926,8 @@ gtk_list_view_init (GtkListView *self)
/**
* gtk_list_view_new:
* @model: (allow-none) (transfer full): the model to use, or %NULL
* @factory: (allow-none) (transfer full): The factory to populate items with, or %NULL
* @model: (nullable) (transfer full): the model to use, or %NULL
* @factory: (nullable) (transfer full): The factory to populate items with, or %NULL
*
* Creates a new `GtkListView` that uses the given @factory for
* mapping items to widgets.
@ -981,7 +981,7 @@ gtk_list_view_get_model (GtkListView *self)
/**
* gtk_list_view_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkListView`
* @model: (allow-none) (transfer none): the model to use or %NULL for none
* @model: (nullable) (transfer none): the model to use or %NULL for none
*
* Sets the model to use.
*
@ -1023,7 +1023,7 @@ gtk_list_view_get_factory (GtkListView *self)
/**
* gtk_list_view_set_factory: (attributes org.gtk.Method.set_property=factory)
* @self: a `GtkListView`
* @factory: (allow-none) (transfer none): the factory to use or %NULL for none
* @factory: (nullable) (transfer none): the factory to use or %NULL for none
*
* Sets the `GtkListItemFactory` to use for populating list items.
*/

4
gtk/gtklockbutton.c
View File

@ -515,7 +515,7 @@ gtk_lock_button_clicked (GtkButton *widget)
/**
* gtk_lock_button_new:
* @permission: (allow-none): a `GPermission`
* @permission: (nullable): a `GPermission`
*
* Creates a new lock button which reflects the @permission.
*
@ -548,7 +548,7 @@ gtk_lock_button_get_permission (GtkLockButton *button)
/**
* gtk_lock_button_set_permission: (attributes org.gtk.Method.set_property=permission)
* @button: a `GtkLockButton`
* @permission: (allow-none): a `GPermission` object, or %NULL
* @permission: (nullable): a `GPermission` object, or %NULL
*
* Sets the `GPermission` object that controls @button.
*/

8
gtk/gtkmaplistmodel.c
View File

@ -410,8 +410,8 @@ gtk_map_list_model_augment (GtkRbTree *map,
/**
* gtk_map_list_model_new:
* @model: (transfer full) (allow-none): The model to map or %NULL for none
* @map_func: (allow-none): map function or %NULL to not map items
* @model: (transfer full) (nullable): The model to map or %NULL for none
* @map_func: (nullable): map function or %NULL to not map items
* @user_data: (closure): user data passed to @map_func
* @user_destroy: destroy notifier for @user_data
*
@ -488,7 +488,7 @@ gtk_map_list_model_init_items (GtkMapListModel *self)
/**
* gtk_map_list_model_set_map_func:
* @self: a `GtkMapListModel`
* @map_func: (allow-none): map function or %NULL to not map items
* @map_func: (nullable): map function or %NULL to not map items
* @user_data: (closure): user data passed to @map_func
* @user_destroy: destroy notifier for @user_data
*
@ -545,7 +545,7 @@ gtk_map_list_model_set_map_func (GtkMapListModel *self,
/**
* gtk_map_list_model_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkMapListModel`
* @model: (allow-none): The model to be mapped
* @model: (nullable): The model to be mapped
*
* Sets the model to be mapped.
*

2
gtk/gtkmediacontrols.c
View File

@ -306,7 +306,7 @@ gtk_media_controls_init (GtkMediaControls *controls)
/**
* gtk_media_controls_new:
* @stream: (allow-none) (transfer none): a `GtkMediaStream` to manage
* @stream: (nullable) (transfer none): a `GtkMediaStream` to manage
*
* Creates a new `GtkMediaControls` managing the @stream passed to it.
*

8
gtk/gtkmediafile.c
View File

@ -420,7 +420,7 @@ gtk_media_file_clear (GtkMediaFile *self)
/**
* gtk_media_file_set_filename:
* @self: a `GtkMediaFile`
* @filename: (allow-none): name of file to play
* @filename: (nullable): name of file to play
*
* Sets the `GtkMediaFile to play the given file.
*
@ -449,7 +449,7 @@ gtk_media_file_set_filename (GtkMediaFile *self,
/**
* gtk_media_file_set_resource:
* @self: a `GtkMediaFile`
* @resource_path: (allow-none): path to resource to play
* @resource_path: (nullable): path to resource to play
*
* Sets the `GtkMediaFile to play the given resource.
*
@ -491,7 +491,7 @@ gtk_media_file_set_resource (GtkMediaFile *self,
/**
* gtk_media_file_set_file: (attributes org.gtk.Method.set_property=file)
* @self: a `GtkMediaFile`
* @file: (allow-none): the file to play
* @file: (nullable): the file to play
*
* Sets the `GtkMediaFile` to play the given file.
*
@ -549,7 +549,7 @@ gtk_media_file_get_file (GtkMediaFile *self)
/**
* gtk_media_file_set_input_stream: (attributes org.gtk.Method.set_property=input-stream)
* @self: a `GtkMediaFile`
* @stream: (allow-none): the stream to play from
* @stream: (nullable): the stream to play from
*
* Sets the `GtkMediaFile` to play the given stream.
*

10
gtk/gtkmessagedialog.c
View File

@ -478,11 +478,11 @@ gtk_message_dialog_init (GtkMessageDialog *dialog)
/**
* gtk_message_dialog_new:
* @parent: (allow-none): transient parent, or %NULL for none
* @parent: (nullable): transient parent, or %NULL for none
* @flags: flags
* @type: type of message
* @buttons: set of buttons to use
* @message_format: (allow-none): printf()-style format string, or %NULL
* @message_format: (nullable): printf()-style format string, or %NULL
* @...: arguments for @message_format
*
* Creates a new message dialog.
@ -542,11 +542,11 @@ gtk_message_dialog_new (GtkWindow *parent,
/**
* gtk_message_dialog_new_with_markup:
* @parent: (allow-none): transient parent, or %NULL for none
* @parent: (nullable): transient parent, or %NULL for none
* @flags: flags
* @type: type of message
* @buttons: set of buttons to use
* @message_format: (allow-none): printf()-style format string, or %NULL
* @message_format: (nullable): printf()-style format string, or %NULL
* @...: arguments for @message_format
*
* Creates a new message dialog.
@ -632,7 +632,7 @@ gtk_message_dialog_set_markup (GtkMessageDialog *message_dialog,
/**
* gtk_message_dialog_format_secondary_text:
* @message_dialog: a `GtkMessageDialog`
* @message_format: (allow-none): printf()-style format string, or %NULL
* @message_format: (nullable): printf()-style format string, or %NULL
* @...: arguments for @message_format
*
* Sets the secondary text of the message dialog.

4
gtk/gtkmountoperation.c
View File

@ -1790,7 +1790,7 @@ gtk_mount_operation_aborted (GMountOperation *op)
/**
* gtk_mount_operation_new:
* @parent: (allow-none): transient parent of the window, or %NULL
* @parent: (nullable): transient parent of the window, or %NULL
*
* Creates a new `GtkMountOperation`.
*
@ -1827,7 +1827,7 @@ gtk_mount_operation_is_showing (GtkMountOperation *op)
/**
* gtk_mount_operation_set_parent: (attributes org.gtk.Method.set_property=parent)
* @op: a `GtkMountOperation`
* @parent: (allow-none): transient parent of the window, or %NULL
* @parent: (nullable): transient parent of the window, or %NULL
*
* Sets the transient parent for windows shown by the
* `GtkMountOperation`.

4
gtk/gtkmultiselection.c
View File

@ -367,7 +367,7 @@ gtk_multi_selection_init (GtkMultiSelection *self)
/**
* gtk_multi_selection_new:
* @model: (allow-none) (transfer full): the `GListModel` to manage, or %NULL
* @model: (nullable) (transfer full): the `GListModel` to manage, or %NULL
*
* Creates a new selection to handle @model.
*
@ -409,7 +409,7 @@ gtk_multi_selection_get_model (GtkMultiSelection *self)
/**
* gtk_multi_selection_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkMultiSelection`
* @model: (allow-none): A `GListModel` to wrap
* @model: (nullable): A `GListModel` to wrap
*
* Sets the model that @self should wrap.
*

2
gtk/gtknativedialog.c
View File

@ -501,7 +501,7 @@ parent_destroyed (GtkWidget *parent,
/**
* gtk_native_dialog_set_transient_for: (attributes org.gtk.Method.set_property=transient-for)
* @self: a `GtkNativeDialog`
* @parent: (allow-none): parent window, or %NULL
* @parent: (nullable): parent window, or %NULL
*
* Dialog windows should be set transient for the main application
* window they were spawned from.

4
gtk/gtknoselection.c
View File

@ -213,7 +213,7 @@ gtk_no_selection_init (GtkNoSelection *self)
/**
* gtk_no_selection_new:
* @model: (allow-none) (transfer full): the `GListModel` to manage, or %NULL
* @model: (nullable) (transfer full): the `GListModel` to manage, or %NULL
*
* Creates a new selection to handle @model.
*
@ -255,7 +255,7 @@ gtk_no_selection_get_model (GtkNoSelection *self)
/**
* gtk_no_selection_set_model: (attributes org.gtk.Method.set_property=model)
* @self: a `GtkNoSelection`
* @model: (allow-none): A `GListModel` to wrap
* @model: (nullable): A `GListModel` to wrap
*
* Sets the model that @self should wrap.
*

24
gtk/gtknotebook.c
View File

@ -5677,7 +5677,7 @@ gtk_notebook_menu_label_unparent (GtkWidget *widget)
* gtk_notebook_append_page:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
* @tab_label: (allow-none): the `GtkWidget` to be used as the label
* @tab_label: (nullable): the `GtkWidget` to be used as the label
* for the page, or %NULL to use the default label, “page N”
*
* Appends a page to @notebook.
@ -5701,9 +5701,9 @@ gtk_notebook_append_page (GtkNotebook *notebook,
* gtk_notebook_append_page_menu:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
* @tab_label: (allow-none): the `GtkWidget` to be used as the label
* @tab_label: (nullable): the `GtkWidget` to be used as the label
* for the page, or %NULL to use the default label, “page N”
* @menu_label: (allow-none): the widget to use as a label for the
* @menu_label: (nullable): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly
* created label with the same text as @tab_label; if @tab_label
@ -5734,7 +5734,7 @@ gtk_notebook_append_page_menu (GtkNotebook *notebook,
* gtk_notebook_prepend_page:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
* @tab_label: (allow-none): the #GtkWidget to be used as the label
* @tab_label: (nullable): the #GtkWidget to be used as the label
* for the page, or %NULL to use the default label, “page N”
*
* Prepends a page to @notebook.
@ -5758,9 +5758,9 @@ gtk_notebook_prepend_page (GtkNotebook *notebook,
* gtk_notebook_prepend_page_menu:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
* @tab_label: (allow-none): the `GtkWidget` to be used as the label
* @tab_label: (nullable): the `GtkWidget` to be used as the label
* for the page, or %NULL to use the default label, “page N”
* @menu_label: (allow-none): the widget to use as a label for the
* @menu_label: (nullable): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly
* created label with the same text as @tab_label; if @tab_label
@ -5791,7 +5791,7 @@ gtk_notebook_prepend_page_menu (GtkNotebook *notebook,
* gtk_notebook_insert_page:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
* @tab_label: (allow-none): the `GtkWidget` to be used as the label
* @tab_label: (nullable): the `GtkWidget` to be used as the label
* for the page, or %NULL to use the default label, “page N”
* @position: the index (starting at 0) at which to insert the page,
* or -1 to append the page after all other pages
@ -5848,9 +5848,9 @@ gtk_notebook_mnemonic_activate_switch_page (GtkWidget *child,
* gtk_notebook_insert_page_menu:
* @notebook: a `GtkNotebook`
* @child: the `GtkWidget` to use as the contents of the page
* @tab_label: (allow-none): the `GtkWidget` to be used as the label
* @tab_label: (nullable): the `GtkWidget` to be used as the label
* for the page, or %NULL to use the default label, “page N”
* @menu_label: (allow-none): the widget to use as a label for the
* @menu_label: (nullable): the widget to use as a label for the
* page-switch menu, if that is enabled. If %NULL, and @tab_label
* is a #GtkLabel or %NULL, then the menu label will be a newly
* created label with the same text as @tab_label; if @tab_label
@ -6528,7 +6528,7 @@ gtk_notebook_get_tab_label (GtkNotebook *notebook,
* gtk_notebook_set_tab_label:
* @notebook: a `GtkNotebook`
* @child: the page
* @tab_label: (allow-none): the tab label widget to use, or %NULL
* @tab_label: (nullable): the tab label widget to use, or %NULL
* for default tab label
*
* Changes the tab label for @child.
@ -6688,7 +6688,7 @@ gtk_notebook_get_menu_label (GtkNotebook *notebook,
* gtk_notebook_set_menu_label:
* @notebook: a `GtkNotebook`
* @child: the child widget
* @menu_label: (allow-none): the menu label, or %NULL for default
* @menu_label: (nullable): the menu label, or %NULL for default
*
* Changes the menu label for the page containing @child.
*/
@ -6883,7 +6883,7 @@ gtk_notebook_reorder_child (GtkNotebook *notebook,
/**
* gtk_notebook_set_group_name: (attributes org.gtk.Method.set_property=group-name)
* @notebook: a `GtkNotebook`
* @group_name: (allow-none): the name of the notebook group,
* @group_name: (nullable): the name of the notebook group,
* or %NULL to unset it
*
* Sets a group name for @notebook.

2
gtk/gtkoverlay.c
View File

@ -564,7 +564,7 @@ gtk_overlay_get_clip_overlay (GtkOverlay *overlay,
/**
* gtk_overlay_set_child:
* @overlay: a `GtkOverlay`
* @child: (allow-none): the child widget
* @child: (nullable): the child widget
*
* Sets the child widget of @overlay.
*/

14
gtk/gtkpagesetup.c
View File

@ -491,7 +491,7 @@ gtk_page_setup_get_page_height (GtkPageSetup *setup,
* gtk_page_setup_load_file:
* @setup: a `GtkPageSetup`
* @file_name: (type filename): the filename to read the page setup from
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Reads the page setup from the file @file_name.
*
@ -524,7 +524,7 @@ gtk_page_setup_load_file (GtkPageSetup *setup,
/**
* gtk_page_setup_new_from_file:
* @file_name: (type filename): the filename to read the page setup from
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Reads the page setup from the file @file_name.
*
@ -574,9 +574,9 @@ string_to_enum (GType type,
* gtk_page_setup_load_key_file:
* @setup: a `GtkPageSetup`
* @key_file: the `GKeyFile` to retrieve the page_setup from
* @group_name: (allow-none): the name of the group in the key_file to read, or %NULL
* @group_name: (nullable): the name of the group in the key_file to read, or %NULL
* to use the default name “Page Setup”
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Reads the page setup from the group @group_name in the key file
* @key_file.
@ -660,9 +660,9 @@ out:
/**
* gtk_page_setup_new_from_key_file:
* @key_file: the `GKeyFile` to retrieve the page_setup from
* @group_name: (allow-none): the name of the group in the key_file to read, or %NULL
* @group_name: (nullable): the name of the group in the key_file to read, or %NULL
* to use the default name “Page Setup”
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Reads the page setup from the group @group_name in the key file
* @key_file.
@ -692,7 +692,7 @@ gtk_page_setup_new_from_key_file (GKeyFile *key_file,
* gtk_page_setup_to_file:
* @setup: a `GtkPageSetup`
* @file_name: (type filename): the file to save to
* @error: (allow-none): return location for errors, or %NULL
* @error: (nullable): return location for errors, or %NULL
*
* This function saves the information from @setup to @file_name.
*

4
gtk/gtkpagesetupunixdialog.c
View File

@ -767,8 +767,8 @@ paper_size_changed (GtkDropDown *combo_box,
/**
* gtk_page_setup_unix_dialog_new:
* @title: (allow-none): the title of the dialog, or %NULL
* @parent: (allow-none): transient parent of the dialog, or %NULL
* @title: (nullable): the title of the dialog, or %NULL
* @parent: (nullable): transient parent of the dialog, or %NULL
*
* Creates a new page setup dialog.
*

4
gtk/gtkpapersize.c
View File

@ -205,7 +205,7 @@ gtk_paper_size_new_from_info (const PaperInfo *info)
/**
* gtk_paper_size_new:
* @name: (allow-none): a paper size name, or %NULL
* @name: (nullable): a paper size name, or %NULL
*
* Creates a new `GtkPaperSize` object by parsing a
* [PWG 5101.1-2002](ftp://ftp.pwg.org/pub/pwg/candidates/cs-pwgmsn10-20020226-5101.1.pdf)
@ -910,7 +910,7 @@ gtk_paper_size_get_default_right_margin (GtkPaperSize *size,
* @key_file: the `GKeyFile` to retrieve the papersize from
* @group_name: (nullable): the name of the group in the key file to read,
* or %NULL to read the first group
* @error: (allow-none): return location for an error, or %NULL
* @error: (nullable): return location for an error, or %NULL
*
* Reads a paper size from the group @group_name in the key file
* @key_file.

2
gtk/gtkpasswordentry.c
View File

@ -649,7 +649,7 @@ gtk_password_entry_get_show_peek_icon (GtkPasswordEntry *entry)
/**
* gtk_password_entry_set_extra_menu: (attributes org.gtk.Method.set_property=extra-menu)
* @entry: a `GtkPasswordEntry`
* @model: (allow-none): a `GMenuModel`
* @model: (nullable): a `GMenuModel`
*
* Sets a menu model to add when constructing
* the context menu for @entry.

4
gtk/gtkpopover.c
View File

@ -1914,7 +1914,7 @@ gtk_popover_new (void)
/**
* gtk_popover_set_child: (attributes org.gtk.Method.set_property=child)
* @popover: a `GtkPopover`
* @child: (allow-none): the child widget
* @child: (nullable): the child widget
*
* Sets the child widget of @popover.
*/
@ -1963,7 +1963,7 @@ gtk_popover_get_child (GtkPopover *popover)
/**
* gtk_popover_set_default_widget: (attributes org.gtk.Method.set_property=default-widget)
* @popover: a `GtkPopover`
* @widget: (allow-none): a child widget of @popover to set as
* @widget: (nullable): a child widget of @popover to set as
* the default, or %NULL to unset the default widget for the popover
*
* Sets the default widget of a `GtkPopover`.

2
gtk/gtkpopovermenu.c
View File

@ -691,7 +691,7 @@ gtk_popover_menu_add_submenu (GtkPopoverMenu *popover,
/**
* gtk_popover_menu_new_from_model:
* @model: (allow-none): a `GMenuModel`, or %NULL
* @model: (nullable): a `GMenuModel`, or %NULL
*
* Creates a `GtkPopoverMenu` and populates it according to @model.
*

4
gtk/gtkpopovermenubar.c
View File

@ -683,7 +683,7 @@ gtk_popover_menu_bar_buildable_iface_init (GtkBuildableIface *iface)
/**
* gtk_popover_menu_bar_new_from_model:
* @model: (allow-none): a `GMenuModel`, or %NULL
* @model: (nullable): a `GMenuModel`, or %NULL
*
* Creates a `GtkPopoverMenuBar` from a `GMenuModel`.
*
@ -700,7 +700,7 @@ gtk_popover_menu_bar_new_from_model (GMenuModel *model)
/**
* gtk_popover_menu_bar_set_menu_model: (attributes org.gtk.Method.set_property=menu-model)
* @bar: a `GtkPopoverMenuBar`
* @model: (allow-none): a `GMenuModel`, or %NULL
* @model: (nullable): a `GMenuModel`, or %NULL
*
* Sets a menu model from which @bar should take
* its contents.

2
gtk/gtkprintjob.c
View File

@ -493,7 +493,7 @@ gtk_print_job_set_source_fd (GtkPrintJob *job,
/**
* gtk_print_job_get_surface:
* @job: a `GtkPrintJob`
* @error: (allow-none): return location for errors, or %NULL
* @error: (nullable): return location for errors, or %NULL
*
* Gets a cairo surface onto which the pages of
* the print job should be rendered.

Some files were not shown because too many files have changed in this diff Show More