GitLab repository storage has been migrated to hashed layout. Please contact Infrastructure team if you notice any issues with repositories or hooks.

Commit fe852721 authored by Johan Dahlin's avatar Johan Dahlin

[annotations] Add allow-none

This commit was created using a script that searched for all docstrings
containing a parameter and the string 'or %NULL'.
Gdk backends and demos excluded as they are not part of a public API

https://bugzilla.gnome.org/show_bug.cgi?id=610474
parent 347d406f
......@@ -1861,7 +1861,7 @@ gdk_pixbuf_real_save_to_callback (GdkPixbuf *pixbuf,
* @pixbuf: a #GdkPixbuf.
* @filename: name of file to save.
* @type: name of file format.
* @error: return location for error, or %NULL
* @error: (allow-none): return location for error, or %NULL
* @Varargs: list of key-value save options
*
* Saves pixbuf to a file in format @type. By default, "jpeg", "png", "ico"
......@@ -2009,7 +2009,7 @@ gdk_pixbuf_save (GdkPixbuf *pixbuf,
* @type: name of file format.
* @option_keys: name of options to set, %NULL-terminated
* @option_values: values for named options
* @error: return location for error, or %NULL
* @error: (allow-none): return location for error, or %NULL
*
* Saves pixbuf to a file in @type, which is currently "jpeg", "png", "tiff", "ico" or "bmp".
* If @error is set, %FALSE will be returned.
......@@ -2116,7 +2116,7 @@ gdk_pixbuf_savev (GdkPixbuf *pixbuf,
* the save routine generates.
* @user_data: user data to pass to the save function.
* @type: name of file format.
* @error: return location for error, or %NULL
* @error: (allow-none): return location for error, or %NULL
* @Varargs: list of key-value save options
*
* Saves pixbuf in format @type by feeding the produced data to a
......@@ -2172,7 +2172,7 @@ gdk_pixbuf_save_to_callback (GdkPixbuf *pixbuf,
* @type: name of file format.
* @option_keys: name of options to set, %NULL-terminated
* @option_values: values for named options
* @error: return location for error, or %NULL
* @error: (allow-none): return location for error, or %NULL
*
* Saves pixbuf to a callback in format @type, which is currently "jpeg",
* "png", "tiff", "ico" or "bmp". If @error is set, %FALSE will be returned. See
......@@ -2217,7 +2217,7 @@ gdk_pixbuf_save_to_callbackv (GdkPixbuf *pixbuf,
* @buffer: location to receive a pointer to the new buffer.
* @buffer_size: location to receive the size of the new buffer.
* @type: name of file format.
* @error: return location for error, or %NULL
* @error: (allow-none): return location for error, or %NULL
* @Varargs: list of key-value save options
*
* Saves pixbuf to a new buffer in format @type, which is currently "jpeg",
......@@ -2306,7 +2306,7 @@ save_to_buffer_callback (const gchar *data,
* @type: name of file format.
* @option_keys: name of options to set, %NULL-terminated
* @option_values: values for named options
* @error: return location for error, or %NULL
* @error: (allow-none): return location for error, or %NULL
*
* Saves pixbuf to a new buffer in format @type, which is currently "jpeg",
* "tiff", "png", "ico" or "bmp". See gdk_pixbuf_save_to_buffer()
......@@ -2402,7 +2402,7 @@ save_to_stream (const gchar *buffer,
* @stream: a #GOutputStream to save the pixbuf to
* @type: name of file format
* @cancellable: optional #GCancellable object, %NULL to ignore
* @error: return location for error, or %NULL
* @error: (allow-none): return location for error, or %NULL
* @Varargs: list of key-value save options
*
* Saves @pixbuf to an output stream.
......
......@@ -500,7 +500,7 @@ gdk_pixbuf_loader_new (void)
/**
* gdk_pixbuf_loader_new_with_type:
* @image_type: name of the image format to be loaded with the image
* @error: return location for an allocated #GError, or %NULL to ignore errors
* @error: (allow-none): return location for an allocated #GError, or %NULL to ignore errors
*
* Creates a new pixbuf loader object that always attempts to parse
* image data as if it were an image of type @image_type, instead of
......@@ -543,7 +543,7 @@ gdk_pixbuf_loader_new_with_type (const char *image_type,
/**
* gdk_pixbuf_loader_new_with_mime_type:
* @mime_type: the mime type to be loaded
* @error: return location for an allocated #GError, or %NULL to ignore errors
* @error: (allow-none): return location for an allocated #GError, or %NULL to ignore errors
*
* Creates a new pixbuf loader object that always attempts to parse
* image data as if it were an image of mime type @mime_type, instead of
......@@ -669,7 +669,7 @@ gdk_pixbuf_loader_get_animation (GdkPixbufLoader *loader)
/**
* gdk_pixbuf_loader_close:
* @loader: A pixbuf loader.
* @error: return location for a #GError, or %NULL to ignore errors
* @error: (allow-none): return location for a #GError, or %NULL to ignore errors
*
* Informs a pixbuf loader that no further writes with
* gdk_pixbuf_loader_write() will occur, so that it can free its
......
......@@ -534,7 +534,7 @@ gdk_threads_dispatch_free (gpointer data)
* range btweeen #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE
* @function: function to call
* @data: data to pass to @function
* @notify: function to call when the idle is removed, or %NULL
* @notify: (allow-none): function to call when the idle is removed, or %NULL
*
* Adds a function to be called whenever there are no higher priority
* events pending. If the function returns %FALSE it is automatically
......@@ -634,7 +634,7 @@ gdk_threads_add_idle (GSourceFunc function,
* (1/1000ths of a second)
* @function: function to call
* @data: data to pass to @function
* @notify: function to call when the timeout is removed, or %NULL
* @notify: (allow-none): function to call when the timeout is removed, or %NULL
*
* Sets a function to be called at regular intervals holding the GDK lock,
* with the given priority. The function is called repeatedly until it
......@@ -740,7 +740,7 @@ gdk_threads_add_timeout (guint interval,
* @interval: the time between calls to the function, in seconds
* @function: function to call
* @data: data to pass to @function
* @notify: function to call when the timeout is removed, or %NULL
* @notify: (allow-none): function to call when the timeout is removed, or %NULL
*
* A variant of gdk_threads_add_timout_full() with second-granularity.
* See g_timeout_add_seconds_full() for a discussion of why it is
......
......@@ -218,7 +218,7 @@ gdk_app_launch_context_set_timestamp (GdkAppLaunchContext *context,
/**
* gdk_app_launch_context_set_icon:
* @context: a #GdkAppLaunchContext
* @icon: a #GIcon, or %NULL
* @icon: (allow-none): a #GIcon, or %NULL
*
* Sets the icon for applications that are launched with this
* context.
......@@ -250,7 +250,7 @@ gdk_app_launch_context_set_icon (GdkAppLaunchContext *context,
/**
* gdk_app_launch_context_set_icon_name:
* @context: a #GdkAppLaunchContext
* @icon_name: an icon name, or %NULL
* @icon_name: (allow-none): an icon name, or %NULL
*
* Sets the icon for applications that are launched with this context.
* The @icon_name will be interpreted in the same way as the Icon field
......
......@@ -468,9 +468,9 @@ _gdk_display_enable_motion_hints (GdkDisplay *display)
* @display: a #GdkDisplay
* @screen: (allow-none): location to store the screen that the
* cursor is on, or %NULL.
* @x: (out): location to store root window X coordinate of pointer, or %NULL.
* @y: (out): location to store root window Y coordinate of pointer, or %NULL.
* @mask: (out): location to store current modifier mask, or %NULL
* @x: (allow-none): (out): location to store root window X coordinate of pointer, or %NULL.
* @y: (allow-none): (out): location to store root window Y coordinate of pointer, or %NULL.
* @mask: (allow-none): (out): location to store current modifier mask, or %NULL
*
* Gets the current location of the pointer and the current modifier
* mask for a given display.
......
......@@ -99,7 +99,7 @@ gdk_drawable_init (GdkDrawable *drawable)
* @drawable: a #GdkDrawable
* @key: name to store the data under
* @data: arbitrary data
* @destroy_func: function to free @data, or %NULL
* @destroy_func: (allow-none): function to free @data, or %NULL
*
* This function is equivalent to g_object_set_data(),
* the #GObject variant should be used instead.
......@@ -142,8 +142,8 @@ gdk_drawable_get_data (GdkDrawable *drawable,
/**
* gdk_drawable_get_size:
* @drawable: a #GdkDrawable
* @width: (out): location to store drawable's width, or %NULL
* @height: (out): location to store drawable's height, or %NULL
* @width: (allow-none): (out): location to store drawable's width, or %NULL
* @height: (allow-none): (out): location to store drawable's height, or %NULL
*
* Fills *@width and *@height with the size of @drawable.
* @width or @height can be %NULL if you only want the other one.
......@@ -733,7 +733,7 @@ gdk_draw_image (GdkDrawable *drawable,
/**
* gdk_draw_pixbuf:
* @drawable: Destination drawable.
* @gc: a #GdkGC, used for clipping, or %NULL
* @gc: (allow-none): a #GdkGC, used for clipping, or %NULL
* @pixbuf: a #GdkPixbuf
* @src_x: Source X coordinate within pixbuf.
* @src_y: Source Y coordinates within pixbuf.
......@@ -955,7 +955,7 @@ gdk_draw_glyphs (GdkDrawable *drawable,
* gdk_draw_glyphs_transformed:
* @drawable: a #GdkDrawable
* @gc: a #GdkGC
* @matrix: a #PangoMatrix, or %NULL to use an identity transformation
* @matrix: (allow-none): a #PangoMatrix, or %NULL to use an identity transformation
* @font: the font in which to draw the string
* @x: the x position of the start of the string (in Pango
* units in user space coordinates)
......@@ -1038,7 +1038,7 @@ gdk_draw_trapezoids (GdkDrawable *drawable,
/**
* gdk_drawable_copy_to_image:
* @drawable: a #GdkDrawable
* @image: a #GdkDrawable, or %NULL if a new @image should be created.
* @image: (allow-none): a #GdkDrawable, or %NULL if a new @image should be created.
* @src_x: x coordinate on @drawable
* @src_y: y coordinate on @drawable
* @dest_x: x coordinate within @image. Must be 0 if @image is %NULL
......
......@@ -623,7 +623,7 @@ gdk_pango_renderer_get_default (GdkScreen *screen)
/**
* gdk_pango_renderer_set_drawable:
* @gdk_renderer: a #GdkPangoRenderer
* @drawable: the new target drawable, or %NULL
* @drawable: (allow-none): the new target drawable, or %NULL
*
* Sets the drawable the renderer draws to.
*
......@@ -653,7 +653,7 @@ gdk_pango_renderer_set_drawable (GdkPangoRenderer *gdk_renderer,
/**
* gdk_pango_renderer_set_gc:
* @gdk_renderer: a #GdkPangoRenderer
* @gc: the new GC to use for drawing, or %NULL
* @gc: (allow-none): the new GC to use for drawing, or %NULL
*
* Sets the GC the renderer draws with. Note that the GC must not be
* modified until it is unset by calling the function again with
......@@ -730,7 +730,7 @@ gdk_pango_renderer_set_stipple (GdkPangoRenderer *gdk_renderer,
* gdk_pango_renderer_set_override_color:
* @gdk_renderer: a #GdkPangoRenderer
* @part: the part to render to set the color of
* @color: the color to use, or %NULL to unset a previously
* @color: (allow-none): the color to use, or %NULL to unset a previously
* set override color.
*
* Sets the color for a particular render part (foreground,
......@@ -851,8 +851,8 @@ release_renderer (PangoRenderer *renderer)
* @x: the x position of start of string (in pixels)
* @y: the y position of baseline (in pixels)
* @line: a #PangoLayoutLine
* @foreground: foreground override color, or %NULL for none
* @background: background override color, or %NULL for none
* @foreground: (allow-none): foreground override color, or %NULL for none
* @background: (allow-none): background override color, or %NULL for none
*
* Render a #PangoLayoutLine onto a #GdkDrawable, overriding the
* layout's normal colors with @foreground and/or @background.
......@@ -928,8 +928,8 @@ gdk_draw_layout_line_with_colors (GdkDrawable *drawable,
* @x: the X position of the left of the layout (in pixels)
* @y: the Y position of the top of the layout (in pixels)
* @layout: a #PangoLayout
* @foreground: foreground override color, or %NULL for none
* @background: background override color, or %NULL for none
* @foreground: (allow-none): foreground override color, or %NULL for none
* @background: (allow-none): background override color, or %NULL for none
*
* Render a #PangoLayout onto a #GdkDrawable, overriding the
* layout's normal colors with @foreground and/or @background.
......
......@@ -1135,7 +1135,7 @@ rgbconvert (GdkImage *image,
/**
* gdk_pixbuf_get_from_drawable:
* @dest: Destination pixbuf, or %NULL if a new pixbuf should be created.
* @dest: (allow-none): Destination pixbuf, or %NULL if a new pixbuf should be created.
* @src: Source drawable.
* @cmap: A colormap if @src doesn't have one set.
* @src_x: Source X coordinate within drawable.
......@@ -1312,9 +1312,9 @@ gdk_pixbuf_get_from_drawable (GdkPixbuf *dest,
/**
* gdk_pixbuf_get_from_image:
* @dest: Destination pixbuf, or %NULL if a new pixbuf should be created.
* @dest: (allow-none): Destination pixbuf, or %NULL if a new pixbuf should be created.
* @src: Source #GdkImage.
* @cmap: A colormap, or %NULL to use the one for @src
* @cmap: (allow-none): A colormap, or %NULL to use the one for @src
* @src_x: Source X coordinate within drawable.
* @src_y: Source Y coordinate within drawable.
* @dest_x: Destination X coordinate in pixbuf, or 0 if @dest is NULL.
......
......@@ -62,7 +62,7 @@ gdk_rectangle_union (const GdkRectangle *src1,
* gdk_rectangle_intersect:
* @src1: a #GdkRectangle
* @src2: a #GdkRectangle
* @dest: return location for the intersection of @src1 and @src2, or %NULL
* @dest: (allow-none): return location for the intersection of @src1 and @src2, or %NULL
*
* Calculates the intersection of two rectangles. It is allowed for
* @dest to be the same as either @src1 or @src2. If the rectangles
......
......@@ -397,7 +397,7 @@ gdk_screen_height_mm (void)
/**
* gdk_screen_set_font_options:
* @screen: a #GdkScreen
* @options: a #cairo_font_options_t, or %NULL to unset any
* @options: (allow-none): a #cairo_font_options_t, or %NULL to unset any
* previously set default font options.
*
* Sets the default font options for the screen. These
......
......@@ -77,7 +77,7 @@ gdk_text_property_to_text_list (GdkAtom encoding,
* @format: the format of the property
* @text: the text to convert
* @length: the length of @text, in bytes
* @list: location to store the list of strings or %NULL. The
* @list: (allow-none): location to store the list of strings or %NULL. The
* list should be freed with g_strfreev().
*
* Convert a text property in the giving encoding to
......
......@@ -5573,7 +5573,7 @@ gdk_window_invalidate_rect_full (GdkWindow *window,
/**
* gdk_window_invalidate_rect:
* @window: a #GdkWindow
* @rect: rectangle to invalidate or %NULL to invalidate the whole
* @rect: (allow-none): rectangle to invalidate or %NULL to invalidate the whole
* window
* @invalidate_children: whether to also invalidate child windows
*
......@@ -6777,7 +6777,7 @@ gdk_window_lower (GdkWindow *window)
/**
* gdk_window_restack:
* @window: a #GdkWindow
* @sibling: a #GdkWindow that is a sibling of @window, or %NULL
* @sibling: (allow-none): a #GdkWindow that is a sibling of @window, or %NULL
* @above: a boolean
*
* Changes the position of @window in the Z-order (stacking order), so that
......@@ -7761,7 +7761,7 @@ gdk_window_set_background (GdkWindow *window,
/**
* gdk_window_set_back_pixmap:
* @window: a #GdkWindow
* @pixmap: a #GdkPixmap, or %NULL
* @pixmap: (allow-none): a #GdkPixmap, or %NULL
* @parent_relative: whether the tiling origin is at the origin of
* @window's parent
*
......@@ -8331,7 +8331,7 @@ gdk_window_merge_child_shapes (GdkWindow *window)
/**
* gdk_window_input_shape_combine_mask:
* @window: a #GdkWindow
* @mask: shape mask, or %NULL
* @mask: (allow-none): shape mask, or %NULL
* @x: X position of shape mask with respect to @window
* @y: Y position of shape mask with respect to @window
*
......
......@@ -2416,7 +2416,7 @@ close_cb (GtkAboutDialog *about)
/**
* gtk_show_about_dialog:
* @parent: transient parent, or %NULL for none
* @parent: (allow-none): transient parent, or %NULL for none
* @first_property_name: the name of the first property
* @Varargs: value of first property, followed by more properties, %NULL-terminated
*
......
......@@ -691,7 +691,7 @@ gtk_accel_group_connect_by_path (GtkAccelGroup *accel_group,
/**
* gtk_accel_group_disconnect:
* @accel_group: the accelerator group to remove an accelerator from
* @closure: the closure to remove from this accelerator group, or %NULL
* @closure: (allow-none): the closure to remove from this accelerator group, or %NULL
* to remove all closures
* @returns: %TRUE if the closure was found and got disconnected
*
......@@ -804,8 +804,8 @@ _gtk_accel_group_reconnect (GtkAccelGroup *accel_group,
* @accel_group: the accelerator group to query
* @accel_key: key value of the accelerator
* @accel_mods: modifier combination of the accelerator
* @n_entries: location to return the number of entries found, or %NULL
* @returns: an array of @n_entries #GtkAccelGroupEntry elements, or %NULL. The array is owned by GTK+ and must not be freed.
* @n_entries: (allow-none): location to return the number of entries found, or %NULL
* @returns: (allow-none): an array of @n_entries #GtkAccelGroupEntry elements, or %NULL. The array is owned by GTK+ and must not be freed.
*
* Queries an accelerator group for all entries matching @accel_key and
* @accel_mods.
......@@ -832,7 +832,7 @@ gtk_accel_group_query (GtkAccelGroup *accel_group,
/**
* gtk_accel_group_from_accel_closure:
* @closure: a #GClosure
* @returns: the #GtkAccelGroup to which @closure is connected, or %NULL.
* @returns: (allow-none): the #GtkAccelGroup to which @closure is connected, or %NULL.
*
* Finds the #GtkAccelGroup to which @closure is connected;
* see gtk_accel_group_connect().
......
......@@ -463,8 +463,8 @@ gtk_action_buildable_get_name (GtkBuildable *buildable)
/**
* gtk_action_new:
* @name: A unique name for the action
* @label: the label displayed in menu items and on buttons, or %NULL
* @tooltip: a tooltip for the action, or %NULL
* @label: (allow-none): the label displayed in menu items and on buttons, or %NULL
* @tooltip: (allow-none): a tooltip for the action, or %NULL
* @stock_id: the stock icon to display in widgets representing the
* action, or %NULL
*
......@@ -698,7 +698,7 @@ disconnect_proxy (GtkAction *action,
/**
* _gtk_action_sync_menu_visible:
* @action: a #GtkAction, or %NULL to determine the action from @proxy
* @action: (allow-none): a #GtkAction, or %NULL to determine the action from @proxy
* @proxy: a proxy menu item
* @empty: whether the submenu attached to @proxy is empty
*
......
......@@ -356,7 +356,7 @@ gtk_activatable_update (GtkActivatable *activatable,
/**
* gtk_activatable_sync_action_properties:
* @activatable: a #GtkActivatable
* @action: the related #GtkAction or %NULL
* @action: (allow-none): the related #GtkAction or %NULL
*
* This is called to update the activatable completely, this is called
* internally when the #GtkActivatable::related-action property is set
......
......@@ -557,10 +557,10 @@ gtk_alignment_set_padding (GtkAlignment *alignment,
/**
* gtk_alignment_get_padding:
* @alignment: a #GtkAlignment
* @padding_top: location to store the padding for the top of the widget, or %NULL
* @padding_bottom: location to store the padding for the bottom of the widget, or %NULL
* @padding_left: location to store the padding for the left of the widget, or %NULL
* @padding_right: location to store the padding for the right of the widget, or %NULL
* @padding_top: (allow-none): location to store the padding for the top of the widget, or %NULL
* @padding_bottom: (allow-none): location to store the padding for the bottom of the widget, or %NULL
* @padding_left: (allow-none): location to store the padding for the left of the widget, or %NULL
* @padding_right: (allow-none): location to store the padding for the right of the widget, or %NULL
*
* Gets the padding on the different sides of the widget.
* See gtk_alignment_set_padding ().
......
......@@ -1736,7 +1736,7 @@ gtk_assistant_insert_page (GtkAssistant *assistant,
/**
* gtk_assistant_set_forward_page_func:
* @assistant: a #GtkAssistant
* @page_func: the #GtkAssistantPageFunc, or %NULL to use the default one
* @page_func: (allow-none): the #GtkAssistantPageFunc, or %NULL to use the default one
* @data: user data for @page_func
* @destroy: destroy notifier for @data
*
......
......@@ -103,7 +103,7 @@ gtk_buildable_get_name (GtkBuildable *buildable)
* @buildable: a #GtkBuildable
* @builder: a #GtkBuilder
* @child: child to add
* @type: kind of child or %NULL
* @type: (allow-none): kind of child or %NULL
*
* Adds a child to @buildable. @type is an optional string
* describing how the child should be added.
......@@ -221,7 +221,7 @@ gtk_buildable_construct_child (GtkBuildable *buildable,
* gtk_buildable_custom_tag_start:
* @buildable: a #GtkBuildable
* @builder: a #GtkBuilder used to construct this object
* @child: child object or %NULL for non-child tags
* @child: (allow-none): child object or %NULL for non-child tags
* @tagname: name of tag
* @parser: a #GMarkupParser structure to fill in
* @data: return location for user data that will be passed in
......@@ -259,7 +259,7 @@ gtk_buildable_custom_tag_start (GtkBuildable *buildable,
* gtk_buildable_custom_tag_end:
* @buildable: A #GtkBuildable
* @builder: #GtkBuilder used to construct this object
* @child: child object or %NULL for non-child tags
* @child: (allow-none): child object or %NULL for non-child tags
* @tagname: name of tag
* @data: user data that will be passed in to parser functions
*
......@@ -290,7 +290,7 @@ gtk_buildable_custom_tag_end (GtkBuildable *buildable,
* gtk_buildable_custom_finished:
* @buildable: a #GtkBuildable
* @builder: a #GtkBuilder
* @child: child object or %NULL for non-child tags
* @child: (allow-none): child object or %NULL for non-child tags
* @tagname: the name of the tag
* @data: user data created in custom_tag_start
*
......
......@@ -638,7 +638,7 @@ gtk_builder_new (void)
* gtk_builder_add_from_file:
* @builder: a #GtkBuilder
* @filename: the name of the file to parse
* @error: return location for an error, or %NULL
* @error: (allow-none): return location for an error, or %NULL
*
* Parses a file containing a <link linkend="BUILDER-UI">GtkBuilder
* UI definition</link> and merges it with the current contents of @builder.
......@@ -692,7 +692,7 @@ gtk_builder_add_from_file (GtkBuilder *builder,
* @builder: a #GtkBuilder
* @filename: the name of the file to parse
* @object_ids: nul-terminated array of objects to build
* @error: return location for an error, or %NULL
* @error: (allow-none): return location for an error, or %NULL
*
* Parses a file containing a <link linkend="BUILDER-UI">GtkBuilder
* UI definition</link> building only the requested objects and merges
......@@ -755,7 +755,7 @@ gtk_builder_add_objects_from_file (GtkBuilder *builder,
* @builder: a #GtkBuilder
* @buffer: the string to parse
* @length: the length of @buffer (may be -1 if @buffer is nul-terminated)
* @error: return location for an error, or %NULL
* @error: (allow-none): return location for an error, or %NULL
*
* Parses a string containing a <link linkend="BUILDER-UI">GtkBuilder
* UI definition</link> and merges it with the current contents of @builder.
......@@ -800,7 +800,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: nul-terminated array of objects to build
* @error: return location for an error, or %NULL
* @error: (allow-none): return location for an error, or %NULL
*
* Parses a string containing a <link linkend="BUILDER-UI">GtkBuilder
* UI definition</link> building only the requested objects and merges
......@@ -909,7 +909,7 @@ gtk_builder_get_objects (GtkBuilder *builder)
/**
* gtk_builder_set_translation_domain:
* @builder: a #GtkBuilder
* @domain: the translation domain or %NULL
* @domain: (allow-none): the translation domain or %NULL
*
* Sets the translation domain of @builder.
* See #GtkBuilder:translation-domain.
......@@ -1110,7 +1110,7 @@ gtk_builder_connect_signals_full (GtkBuilder *builder,
* @pspec: the #GParamSpec for the property
* @string: the string representation of the value
* @value: the #GValue to store the result in
* @error: return location for an error, or %NULL
* @error: (allow-none): return location for an error, or %NULL
*
* This function demarshals a value from a string. This function
* calls g_value_init() on the @value argument, so it need not be
......@@ -1163,7 +1163,7 @@ gtk_builder_value_from_string (GtkBuilder *builder,
* @type: the #GType of the value
* @string: the string representation of the value
* @value: the #GValue to store the result in
* @error: return location for an error, or %NULL
* @error: (allow-none): return location for an error, or %NULL
*
* Like gtk_builder_value_from_string(), this function demarshals
* a value from a string, but takes a #GType instead of #GParamSpec.
......
......@@ -3823,9 +3823,9 @@ gtk_calendar_unmark_day (GtkCalendar *calendar,
/**
* gtk_calendar_get_date:
* @calendar: a #GtkCalendar
* @year: location to store the year number, or %NULL
* @month: location to store the month number (between 0 and 11), or %NULL
* @day: location to store the day number (between 1 and 31), or %NULL
* @year: (allow-none): location to store the year number, or %NULL
* @month: (allow-none): location to store the month number (between 0 and 11), or %NULL
* @day: (allow-none): location to store the day number (between 1 and 31), or %NULL
*
* Obtains the selected date from a #GtkCalendar.
**/
......
......@@ -130,7 +130,7 @@ gtk_cell_editable_base_init (GtkCellEditableIface *iface)
/**
* gtk_cell_editable_start_editing:
* @cell_editable: A #GtkCellEditable
* @event: A #GdkEvent, or %NULL
* @event: (allow-none): A #GdkEvent, or %NULL
*
* Begins editing on a @cell_editable. @event is the #GdkEvent that began
* the editing process. It may be %NULL, in the instance that editing was
......
......@@ -479,11 +479,11 @@ set_cell_bg_color (GtkCellRenderer *cell,
* gtk_cell_renderer_get_size:
* @cell: a #GtkCellRenderer
* @widget: the widget the renderer is rendering to
* @cell_area: The area a cell will be allocated, or %NULL
* @x_offset: location to return x offset of cell relative to @cell_area, or %NULL
* @y_offset: location to return y offset of cell relative to @cell_area, or %NULL
* @width: location to return width needed to render a cell, or %NULL
* @height: location to return height needed to render a cell, or %NULL
* @cell_area: (allow-none): The area a cell will be allocated, or %NULL
* @x_offset: (allow-none): location to return x offset of cell relative to @cell_area, or %NULL
* @y_offset: (allow-none): location to return y offset of cell relative to @cell_area, or %NULL
* @width: (allow-none): location to return width needed to render a cell, or %NULL
* @height: (allow-none): location to return height needed to render a cell, or %NULL
*
* Obtains the width and height needed to render the cell. Used by view
* widgets to determine the appropriate size for the cell_area passed to
......@@ -718,8 +718,8 @@ gtk_cell_renderer_set_fixed_size (GtkCellRenderer *cell,
/**
* gtk_cell_renderer_get_fixed_size:
* @cell: A #GtkCellRenderer
* @width: location to fill in with the fixed width of the cell, or %NULL
* @height: location to fill in with the fixed height of the cell, or %NULL
* @width: (allow-none): location to fill in with the fixed width of the cell, or %NULL
* @height: (allow-none): location to fill in with the fixed height of the cell, or %NULL
*
* Fills in @width and @height with the appropriate size of @cell.
**/
......@@ -778,8 +778,8 @@ gtk_cell_renderer_set_alignment (GtkCellRenderer *cell,
/**
* gtk_cell_renderer_get_alignment:
* @cell: A #GtkCellRenderer
* @xalign: location to fill in with the x alignment of the cell, or %NULL
* @yalign: location to fill in with the y alignment of the cell, or %NULL
* @xalign: (allow-none): location to fill in with the x alignment of the cell, or %NULL
* @yalign: (allow-none): location to fill in with the y alignment of the cell, or %NULL
*
* Fills in @xalign and @yalign with the appropriate values of @cell.
*
......@@ -839,8 +839,8 @@ gtk_cell_renderer_set_padding (GtkCellRenderer *cell,
/**
* gtk_cell_renderer_get_padding:
* @cell: A #GtkCellRenderer
* @xpad: location to fill in with the x padding of the cell, or %NULL
* @ypad: location to fill in with the y padding of the cell, or %NULL
* @xpad: (allow-none): location to fill in with the x padding of the cell, or %NULL
* @ypad: (allow-none): location to fill in with the y padding of the cell, or %NULL
*
* Fills in @xpad and @ypad with the appropriate values of @cell.
*
......
......@@ -5001,7 +5001,7 @@ gtk_combo_box_get_active_iter (GtkComboBox *combo_box,
/**
* gtk_combo_box_set_active_iter:
* @combo_box: A #GtkComboBox
* @iter: The #GtkTreeIter, or %NULL
* @iter: (allow-none): The #GtkTreeIter, or %NULL
*
* Sets the current active item to be the one referenced by @iter, or
* unsets the active item if @iter is %NULL.
......@@ -5791,8 +5791,8 @@ gtk_combo_box_get_row_separator_func (GtkComboBox *combo_box)
* gtk_combo_box_set_row_separator_func:
* @combo_box: a #GtkComboBox
* @func: a #GtkTreeViewRowSeparatorFunc
* @data: user data to pass to @func, or %NULL
* @destroy: destroy notifier for @data, or %NULL
* @data: (allow-none): user data to pass to @func, or %NULL
* @destroy: (allow-none): destroy notifier for @data, or %NULL
*
* Sets the row separator function, which is used to determine
* whether a row should be drawn as a separator. If the row separator
......
......@@ -980,7 +980,7 @@ gtk_container_class_install_child_property (GtkContainerClass *cclass,
* gtk_container_class_find_child_property:
* @cclass: a #GtkContainerClass
* @property_name: the name of the child property to find
* @returns: the #GParamSpec of the child property or %NULL if @class has no
* @returns: (allow-none): the #GParamSpec of the child property or %NULL if @class has no
* child property with that name.
*
* Finds a child property of a container class by name.
......@@ -2227,7 +2227,7 @@ gtk_container_focus_sort_left_right (GtkContainer *container,
* @children: a list of descendents of @container (they don't
* have to be direct children)
* @direction: focus direction
* @old_focus: widget to use for the starting position, or %NULL
* @old_focus: (allow-none): widget to use for the starting position, or %NULL
* to determine this automatically.
* (Note, this argument isn't used for GTK_DIR_TAB_*,
* which is the only @direction we use currently,
......
......@@ -354,8 +354,8 @@ gtk_custom_paper_unix_dialog_finalize (GObject *object)
/**
* gtk_custom_paper_unix_dialog_new:
* @title: the title of the dialog, or %NULL
* @parent: transient parent of the dialog, or %NULL
* @title: (allow-none): the title of the dialog, or %NULL
* @parent: (allow-none): transient parent of the dialog, or %NULL
*
* Creates a new custom paper dialog.
*
......
......@@ -1384,7 +1384,7 @@ gtk_drag_dest_get_target_list (GtkWidget *widget)
/**
* gtk_drag_dest_set_target_list:
* @widget: a #GtkWidget that's a drag destination
* @target_list: list of droppable targets, or %NULL for none
* @target_list: (allow-none): list of droppable targets, or %NULL for none
*
* Sets the target types that this widget can accept from drag-and-drop.
* The widget must first be made into a drag destination with
......@@ -1666,7 +1666,7 @@ _gtk_drag_dest_handle_event (GtkWidget *toplevel,
* gtk_drag_dest_find_target:
* @widget: drag destination widget
* @context: drag context
* @target_list: list of droppable targets, or %NULL to use
* @target_list: (allow-none): list of droppable targets, or %NULL to use
* gtk_drag_dest_get_target_list (@widget).
*
* Looks for a match between @context->targets and the
......@@ -2693,7 +2693,7 @@ gtk_drag_source_get_target_list (GtkWidget *widget)
/**
* gtk_drag_source_set_target_list:
* @widget: a #GtkWidget that's a drag source
* @target_list: list of draggable targets, or %NULL for none
* @target_list: (allow-none): list of draggable targets, or %NULL for none
*
* Changes the target types that this widget offers for drag-and-drop.
* The widget must first be made into a drag source with
......@@ -3271,7 +3271,7 @@ gtk_drag_set_icon_stock (GdkDragContext *context,
* with a context for the source side of a drag)
* @colormap: the colormap of the icon
* @pixmap: the image data for the icon
* @mask: the transparency mask for the icon or %NULL for none.
* @mask: (allow-none): the transparency mask for the icon or %NULL for none.
* @hot_x: the X offset within @pixmap of the hotspot.
* @hot_y: the Y offset within @pixmap of the hotspot.
*
......
......@@ -7438,8 +7438,8 @@ gtk_entry_text_index_to_layout_index (GtkEntry *entry,
/**
* gtk_entry_get_layout_offsets:
* @entry: a #GtkEntry
* @x: location to store X offset of layout, or %NULL
* @y: location to store Y offset of layout, or %NULL
* @x: (allow-none): location to store X offset of layout, or %NULL
* @y: (allow-none): location to store Y offset of layout, or %NULL
*
*
* Obtains the position of the #PangoLayout used to render text
......@@ -7547,7 +7547,7 @@ gtk_entry_get_alignment (GtkEntry *entry)
* gtk_entry_set_icon_from_pixbuf:
* @entry: a #GtkEntry
* @icon_pos: Icon position
* @pixbuf: A #GdkPixbuf, or %NULL
* @pixbuf: (allow-none): A #GdkPixbuf, or %NULL
*
* Sets the icon shown in the specified position using a pixbuf.