Commit fe852721 authored by Johan Dahlin's avatar Johan Dahlin
Browse files

[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, ...@@ -1861,7 +1861,7 @@ gdk_pixbuf_real_save_to_callback (GdkPixbuf *pixbuf,
* @pixbuf: a #GdkPixbuf. * @pixbuf: a #GdkPixbuf.
* @filename: name of file to save. * @filename: name of file to save.
* @type: name of file format. * @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 * @Varargs: list of key-value save options
* *
* Saves pixbuf to a file in format @type. By default, "jpeg", "png", "ico" * Saves pixbuf to a file in format @type. By default, "jpeg", "png", "ico"
...@@ -2009,7 +2009,7 @@ gdk_pixbuf_save (GdkPixbuf *pixbuf, ...@@ -2009,7 +2009,7 @@ gdk_pixbuf_save (GdkPixbuf *pixbuf,
* @type: name of file format. * @type: name of file format.
* @option_keys: name of options to set, %NULL-terminated * @option_keys: name of options to set, %NULL-terminated
* @option_values: values for named options * @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". * Saves pixbuf to a file in @type, which is currently "jpeg", "png", "tiff", "ico" or "bmp".
* If @error is set, %FALSE will be returned. * If @error is set, %FALSE will be returned.
...@@ -2116,7 +2116,7 @@ gdk_pixbuf_savev (GdkPixbuf *pixbuf, ...@@ -2116,7 +2116,7 @@ gdk_pixbuf_savev (GdkPixbuf *pixbuf,
* the save routine generates. * the save routine generates.
* @user_data: user data to pass to the save function. * @user_data: user data to pass to the save function.
* @type: name of file format. * @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 * @Varargs: list of key-value save options
* *
* Saves pixbuf in format @type by feeding the produced data to a * Saves pixbuf in format @type by feeding the produced data to a
...@@ -2172,7 +2172,7 @@ gdk_pixbuf_save_to_callback (GdkPixbuf *pixbuf, ...@@ -2172,7 +2172,7 @@ gdk_pixbuf_save_to_callback (GdkPixbuf *pixbuf,
* @type: name of file format. * @type: name of file format.
* @option_keys: name of options to set, %NULL-terminated * @option_keys: name of options to set, %NULL-terminated
* @option_values: values for named options * @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", * 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 * "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, ...@@ -2217,7 +2217,7 @@ gdk_pixbuf_save_to_callbackv (GdkPixbuf *pixbuf,
* @buffer: location to receive a pointer to the new buffer. * @buffer: location to receive a pointer to the new buffer.
* @buffer_size: location to receive the size of the new buffer. * @buffer_size: location to receive the size of the new buffer.
* @type: name of file format. * @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 * @Varargs: list of key-value save options
* *
* Saves pixbuf to a new buffer in format @type, which is currently "jpeg", * Saves pixbuf to a new buffer in format @type, which is currently "jpeg",
...@@ -2306,7 +2306,7 @@ save_to_buffer_callback (const gchar *data, ...@@ -2306,7 +2306,7 @@ save_to_buffer_callback (const gchar *data,
* @type: name of file format. * @type: name of file format.
* @option_keys: name of options to set, %NULL-terminated * @option_keys: name of options to set, %NULL-terminated
* @option_values: values for named options * @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", * Saves pixbuf to a new buffer in format @type, which is currently "jpeg",
* "tiff", "png", "ico" or "bmp". See gdk_pixbuf_save_to_buffer() * "tiff", "png", "ico" or "bmp". See gdk_pixbuf_save_to_buffer()
...@@ -2402,7 +2402,7 @@ save_to_stream (const gchar *buffer, ...@@ -2402,7 +2402,7 @@ save_to_stream (const gchar *buffer,
* @stream: a #GOutputStream to save the pixbuf to * @stream: a #GOutputStream to save the pixbuf to
* @type: name of file format * @type: name of file format
* @cancellable: optional #GCancellable object, %NULL to ignore * @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 * @Varargs: list of key-value save options
* *
* Saves @pixbuf to an output stream. * Saves @pixbuf to an output stream.
......
...@@ -500,7 +500,7 @@ gdk_pixbuf_loader_new (void) ...@@ -500,7 +500,7 @@ gdk_pixbuf_loader_new (void)
/** /**
* gdk_pixbuf_loader_new_with_type: * gdk_pixbuf_loader_new_with_type:
* @image_type: name of the image format to be loaded with the image * @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 * 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 * 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, ...@@ -543,7 +543,7 @@ gdk_pixbuf_loader_new_with_type (const char *image_type,
/** /**
* gdk_pixbuf_loader_new_with_mime_type: * gdk_pixbuf_loader_new_with_mime_type:
* @mime_type: the mime type to be loaded * @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 * 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 * 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) ...@@ -669,7 +669,7 @@ gdk_pixbuf_loader_get_animation (GdkPixbufLoader *loader)
/** /**
* gdk_pixbuf_loader_close: * gdk_pixbuf_loader_close:
* @loader: A pixbuf loader. * @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 * Informs a pixbuf loader that no further writes with
* gdk_pixbuf_loader_write() will occur, so that it can free its * gdk_pixbuf_loader_write() will occur, so that it can free its
......
...@@ -534,7 +534,7 @@ gdk_threads_dispatch_free (gpointer data) ...@@ -534,7 +534,7 @@ gdk_threads_dispatch_free (gpointer data)
* range btweeen #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE * range btweeen #G_PRIORITY_DEFAULT_IDLE and #G_PRIORITY_HIGH_IDLE
* @function: function to call * @function: function to call
* @data: data to pass to @function * @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 * Adds a function to be called whenever there are no higher priority
* events pending. If the function returns %FALSE it is automatically * events pending. If the function returns %FALSE it is automatically
...@@ -634,7 +634,7 @@ gdk_threads_add_idle (GSourceFunc function, ...@@ -634,7 +634,7 @@ gdk_threads_add_idle (GSourceFunc function,
* (1/1000ths of a second) * (1/1000ths of a second)
* @function: function to call * @function: function to call
* @data: data to pass to @function * @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, * Sets a function to be called at regular intervals holding the GDK lock,
* with the given priority. The function is called repeatedly until it * with the given priority. The function is called repeatedly until it
...@@ -740,7 +740,7 @@ gdk_threads_add_timeout (guint interval, ...@@ -740,7 +740,7 @@ gdk_threads_add_timeout (guint interval,
* @interval: the time between calls to the function, in seconds * @interval: the time between calls to the function, in seconds
* @function: function to call * @function: function to call
* @data: data to pass to @function * @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. * A variant of gdk_threads_add_timout_full() with second-granularity.
* See g_timeout_add_seconds_full() for a discussion of why it is * 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, ...@@ -218,7 +218,7 @@ gdk_app_launch_context_set_timestamp (GdkAppLaunchContext *context,
/** /**
* gdk_app_launch_context_set_icon: * gdk_app_launch_context_set_icon:
* @context: a #GdkAppLaunchContext * @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 * Sets the icon for applications that are launched with this
* context. * context.
...@@ -250,7 +250,7 @@ gdk_app_launch_context_set_icon (GdkAppLaunchContext *context, ...@@ -250,7 +250,7 @@ gdk_app_launch_context_set_icon (GdkAppLaunchContext *context,
/** /**
* gdk_app_launch_context_set_icon_name: * gdk_app_launch_context_set_icon_name:
* @context: a #GdkAppLaunchContext * @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. * 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 * 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) ...@@ -468,9 +468,9 @@ _gdk_display_enable_motion_hints (GdkDisplay *display)
* @display: a #GdkDisplay * @display: a #GdkDisplay
* @screen: (allow-none): location to store the screen that the * @screen: (allow-none): location to store the screen that the
* cursor is on, or %NULL. * cursor is on, or %NULL.
* @x: (out): location to store root window X coordinate of pointer, or %NULL. * @x: (allow-none): (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. * @y: (allow-none): (out): location to store root window Y coordinate of pointer, or %NULL.
* @mask: (out): location to store current modifier mask, 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 * Gets the current location of the pointer and the current modifier
* mask for a given display. * mask for a given display.
......
...@@ -99,7 +99,7 @@ gdk_drawable_init (GdkDrawable *drawable) ...@@ -99,7 +99,7 @@ gdk_drawable_init (GdkDrawable *drawable)
* @drawable: a #GdkDrawable * @drawable: a #GdkDrawable
* @key: name to store the data under * @key: name to store the data under
* @data: arbitrary data * @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(), * This function is equivalent to g_object_set_data(),
* the #GObject variant should be used instead. * the #GObject variant should be used instead.
...@@ -142,8 +142,8 @@ gdk_drawable_get_data (GdkDrawable *drawable, ...@@ -142,8 +142,8 @@ gdk_drawable_get_data (GdkDrawable *drawable,
/** /**
* gdk_drawable_get_size: * gdk_drawable_get_size:
* @drawable: a #GdkDrawable * @drawable: a #GdkDrawable
* @width: (out): location to store drawable's width, or %NULL * @width: (allow-none): (out): location to store drawable's width, or %NULL
* @height: (out): location to store drawable's height, or %NULL * @height: (allow-none): (out): location to store drawable's height, or %NULL
* *
* Fills *@width and *@height with the size of @drawable. * Fills *@width and *@height with the size of @drawable.
* @width or @height can be %NULL if you only want the other one. * @width or @height can be %NULL if you only want the other one.
...@@ -733,7 +733,7 @@ gdk_draw_image (GdkDrawable *drawable, ...@@ -733,7 +733,7 @@ gdk_draw_image (GdkDrawable *drawable,
/** /**
* gdk_draw_pixbuf: * gdk_draw_pixbuf:
* @drawable: Destination drawable. * @drawable: Destination drawable.
* @gc: a #GdkGC, used for clipping, or %NULL * @gc: (allow-none): a #GdkGC, used for clipping, or %NULL
* @pixbuf: a #GdkPixbuf * @pixbuf: a #GdkPixbuf
* @src_x: Source X coordinate within pixbuf. * @src_x: Source X coordinate within pixbuf.
* @src_y: Source Y coordinates within pixbuf. * @src_y: Source Y coordinates within pixbuf.
...@@ -955,7 +955,7 @@ gdk_draw_glyphs (GdkDrawable *drawable, ...@@ -955,7 +955,7 @@ gdk_draw_glyphs (GdkDrawable *drawable,
* gdk_draw_glyphs_transformed: * gdk_draw_glyphs_transformed:
* @drawable: a #GdkDrawable * @drawable: a #GdkDrawable
* @gc: a #GdkGC * @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 * @font: the font in which to draw the string
* @x: the x position of the start of the string (in Pango * @x: the x position of the start of the string (in Pango
* units in user space coordinates) * units in user space coordinates)
...@@ -1038,7 +1038,7 @@ gdk_draw_trapezoids (GdkDrawable *drawable, ...@@ -1038,7 +1038,7 @@ gdk_draw_trapezoids (GdkDrawable *drawable,
/** /**
* gdk_drawable_copy_to_image: * gdk_drawable_copy_to_image:
* @drawable: a #GdkDrawable * @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_x: x coordinate on @drawable
* @src_y: y coordinate on @drawable * @src_y: y coordinate on @drawable
* @dest_x: x coordinate within @image. Must be 0 if @image is %NULL * @dest_x: x coordinate within @image. Must be 0 if @image is %NULL
......
...@@ -623,7 +623,7 @@ gdk_pango_renderer_get_default (GdkScreen *screen) ...@@ -623,7 +623,7 @@ gdk_pango_renderer_get_default (GdkScreen *screen)
/** /**
* gdk_pango_renderer_set_drawable: * gdk_pango_renderer_set_drawable:
* @gdk_renderer: a #GdkPangoRenderer * @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. * Sets the drawable the renderer draws to.
* *
...@@ -653,7 +653,7 @@ gdk_pango_renderer_set_drawable (GdkPangoRenderer *gdk_renderer, ...@@ -653,7 +653,7 @@ gdk_pango_renderer_set_drawable (GdkPangoRenderer *gdk_renderer,
/** /**
* gdk_pango_renderer_set_gc: * gdk_pango_renderer_set_gc:
* @gdk_renderer: a #GdkPangoRenderer * @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 * 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 * modified until it is unset by calling the function again with
...@@ -730,7 +730,7 @@ gdk_pango_renderer_set_stipple (GdkPangoRenderer *gdk_renderer, ...@@ -730,7 +730,7 @@ gdk_pango_renderer_set_stipple (GdkPangoRenderer *gdk_renderer,
* gdk_pango_renderer_set_override_color: * gdk_pango_renderer_set_override_color:
* @gdk_renderer: a #GdkPangoRenderer * @gdk_renderer: a #GdkPangoRenderer
* @part: the part to render to set the color of * @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. * set override color.
* *
* Sets the color for a particular render part (foreground, * Sets the color for a particular render part (foreground,
...@@ -851,8 +851,8 @@ release_renderer (PangoRenderer *renderer) ...@@ -851,8 +851,8 @@ release_renderer (PangoRenderer *renderer)
* @x: the x position of start of string (in pixels) * @x: the x position of start of string (in pixels)
* @y: the y position of baseline (in pixels) * @y: the y position of baseline (in pixels)
* @line: a #PangoLayoutLine * @line: a #PangoLayoutLine
* @foreground: foreground override color, or %NULL for none * @foreground: (allow-none): foreground override color, or %NULL for none
* @background: background override color, or %NULL for none * @background: (allow-none): background override color, or %NULL for none
* *
* Render a #PangoLayoutLine onto a #GdkDrawable, overriding the * Render a #PangoLayoutLine onto a #GdkDrawable, overriding the
* layout's normal colors with @foreground and/or @background. * layout's normal colors with @foreground and/or @background.
...@@ -928,8 +928,8 @@ gdk_draw_layout_line_with_colors (GdkDrawable *drawable, ...@@ -928,8 +928,8 @@ gdk_draw_layout_line_with_colors (GdkDrawable *drawable,
* @x: the X position of the left of the layout (in pixels) * @x: the X position of the left of the layout (in pixels)
* @y: the Y position of the top of the layout (in pixels) * @y: the Y position of the top of the layout (in pixels)
* @layout: a #PangoLayout * @layout: a #PangoLayout
* @foreground: foreground override color, or %NULL for none * @foreground: (allow-none): foreground override color, or %NULL for none
* @background: background override color, or %NULL for none * @background: (allow-none): background override color, or %NULL for none
* *
* Render a #PangoLayout onto a #GdkDrawable, overriding the * Render a #PangoLayout onto a #GdkDrawable, overriding the
* layout's normal colors with @foreground and/or @background. * layout's normal colors with @foreground and/or @background.
......
...@@ -1135,7 +1135,7 @@ rgbconvert (GdkImage *image, ...@@ -1135,7 +1135,7 @@ rgbconvert (GdkImage *image,
/** /**
* gdk_pixbuf_get_from_drawable: * 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. * @src: Source drawable.
* @cmap: A colormap if @src doesn't have one set. * @cmap: A colormap if @src doesn't have one set.
* @src_x: Source X coordinate within drawable. * @src_x: Source X coordinate within drawable.
...@@ -1312,9 +1312,9 @@ gdk_pixbuf_get_from_drawable (GdkPixbuf *dest, ...@@ -1312,9 +1312,9 @@ gdk_pixbuf_get_from_drawable (GdkPixbuf *dest,
/** /**
* gdk_pixbuf_get_from_image: * 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. * @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_x: Source X coordinate within drawable.
* @src_y: Source Y coordinate within drawable. * @src_y: Source Y coordinate within drawable.
* @dest_x: Destination X coordinate in pixbuf, or 0 if @dest is NULL. * @dest_x: Destination X coordinate in pixbuf, or 0 if @dest is NULL.
......
...@@ -62,7 +62,7 @@ gdk_rectangle_union (const GdkRectangle *src1, ...@@ -62,7 +62,7 @@ gdk_rectangle_union (const GdkRectangle *src1,
* gdk_rectangle_intersect: * gdk_rectangle_intersect:
* @src1: a #GdkRectangle * @src1: a #GdkRectangle
* @src2: 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 * Calculates the intersection of two rectangles. It is allowed for
* @dest to be the same as either @src1 or @src2. If the rectangles * @dest to be the same as either @src1 or @src2. If the rectangles
......
...@@ -397,7 +397,7 @@ gdk_screen_height_mm (void) ...@@ -397,7 +397,7 @@ gdk_screen_height_mm (void)
/** /**
* gdk_screen_set_font_options: * gdk_screen_set_font_options:
* @screen: a #GdkScreen * @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. * previously set default font options.
* *
* Sets the default font options for the screen. These * Sets the default font options for the screen. These
......
...@@ -77,7 +77,7 @@ gdk_text_property_to_text_list (GdkAtom encoding, ...@@ -77,7 +77,7 @@ gdk_text_property_to_text_list (GdkAtom encoding,
* @format: the format of the property * @format: the format of the property
* @text: the text to convert * @text: the text to convert
* @length: the length of @text, in bytes * @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(). * list should be freed with g_strfreev().
* *
* Convert a text property in the giving encoding to * Convert a text property in the giving encoding to
......
...@@ -5573,7 +5573,7 @@ gdk_window_invalidate_rect_full (GdkWindow *window, ...@@ -5573,7 +5573,7 @@ gdk_window_invalidate_rect_full (GdkWindow *window,
/** /**
* gdk_window_invalidate_rect: * gdk_window_invalidate_rect:
* @window: a #GdkWindow * @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 * window
* @invalidate_children: whether to also invalidate child windows * @invalidate_children: whether to also invalidate child windows
* *
...@@ -6777,7 +6777,7 @@ gdk_window_lower (GdkWindow *window) ...@@ -6777,7 +6777,7 @@ gdk_window_lower (GdkWindow *window)
/** /**
* gdk_window_restack: * gdk_window_restack:
* @window: a #GdkWindow * @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 * @above: a boolean
* *
* Changes the position of @window in the Z-order (stacking order), so that * Changes the position of @window in the Z-order (stacking order), so that
...@@ -7761,7 +7761,7 @@ gdk_window_set_background (GdkWindow *window, ...@@ -7761,7 +7761,7 @@ gdk_window_set_background (GdkWindow *window,
/** /**
* gdk_window_set_back_pixmap: * gdk_window_set_back_pixmap:
* @window: a #GdkWindow * @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 * @parent_relative: whether the tiling origin is at the origin of
* @window's parent * @window's parent
* *
...@@ -8331,7 +8331,7 @@ gdk_window_merge_child_shapes (GdkWindow *window) ...@@ -8331,7 +8331,7 @@ gdk_window_merge_child_shapes (GdkWindow *window)
/** /**
* gdk_window_input_shape_combine_mask: * gdk_window_input_shape_combine_mask:
* @window: a #GdkWindow * @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 * @x: X position of shape mask with respect to @window
* @y: Y 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) ...@@ -2416,7 +2416,7 @@ close_cb (GtkAboutDialog *about)
/** /**
* gtk_show_about_dialog: * 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 * @first_property_name: the name of the first property
* @Varargs: value of first property, followed by more properties, %NULL-terminated * @Varargs: value of first property, followed by more properties, %NULL-terminated
* *
......
...@@ -691,7 +691,7 @@ gtk_accel_group_connect_by_path (GtkAccelGroup *accel_group, ...@@ -691,7 +691,7 @@ gtk_accel_group_connect_by_path (GtkAccelGroup *accel_group,
/** /**
* gtk_accel_group_disconnect: * gtk_accel_group_disconnect:
* @accel_group: the accelerator group to remove an accelerator from * @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 * to remove all closures
* @returns: %TRUE if the closure was found and got disconnected * @returns: %TRUE if the closure was found and got disconnected
* *
...@@ -804,8 +804,8 @@ _gtk_accel_group_reconnect (GtkAccelGroup *accel_group, ...@@ -804,8 +804,8 @@ _gtk_accel_group_reconnect (GtkAccelGroup *accel_group,
* @accel_group: the accelerator group to query * @accel_group: the accelerator group to query
* @accel_key: key value of the accelerator * @accel_key: key value of the accelerator
* @accel_mods: modifier combination of the accelerator * @accel_mods: modifier combination of the accelerator
* @n_entries: location to return the number of entries found, or %NULL * @n_entries: (allow-none): 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. * @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 * Queries an accelerator group for all entries matching @accel_key and
* @accel_mods. * @accel_mods.
...@@ -832,7 +832,7 @@ gtk_accel_group_query (GtkAccelGroup *accel_group, ...@@ -832,7 +832,7 @@ gtk_accel_group_query (GtkAccelGroup *accel_group,
/** /**
* gtk_accel_group_from_accel_closure: * gtk_accel_group_from_accel_closure:
* @closure: a #GClosure * @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; * Finds the #GtkAccelGroup to which @closure is connected;
* see gtk_accel_group_connect(). * see gtk_accel_group_connect().
......
...@@ -463,8 +463,8 @@ gtk_action_buildable_get_name (GtkBuildable *buildable) ...@@ -463,8 +463,8 @@ gtk_action_buildable_get_name (GtkBuildable *buildable)
/** /**
* gtk_action_new: * gtk_action_new:
* @name: A unique name for the action * @name: A unique name for the action
* @label: the label displayed in menu items and on buttons, or %NULL * @label: (allow-none): the label displayed in menu items and on buttons, or %NULL
* @tooltip: a tooltip for the action, or %NULL * @tooltip: (allow-none): a tooltip for the action, or %NULL
* @stock_id: the stock icon to display in widgets representing the * @stock_id: the stock icon to display in widgets representing the
* action, or %NULL * action, or %NULL
* *
...@@ -698,7 +698,7 @@ disconnect_proxy (GtkAction *action, ...@@ -698,7 +698,7 @@ disconnect_proxy (GtkAction *action,
/** /**
* _gtk_action_sync_menu_visible: * _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 * @proxy: a proxy menu item
* @empty: whether the submenu attached to @proxy is empty * @empty: whether the submenu attached to @proxy is empty
* *
......
...@@ -356,7 +356,7 @@ gtk_activatable_update (GtkActivatable *activatable, ...@@ -356,7 +356,7 @@ gtk_activatable_update (GtkActivatable *activatable,
/** /**
* gtk_activatable_sync_action_properties: * gtk_activatable_sync_action_properties:
* @activatable: a #GtkActivatable * @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 * This is called to update the activatable completely, this is called
* internally when the #GtkActivatable::related-action property is set * internally when the #GtkActivatable::related-action property is set
......
...@@ -557,10 +557,10 @@ gtk_alignment_set_padding (GtkAlignment *alignment, ...@@ -557,10 +557,10 @@ gtk_alignment_set_padding (GtkAlignment *alignment,
/** /**
* gtk_alignment_get_padding: * gtk_alignment_get_padding:
* @alignment: a #GtkAlignment * @alignment: a #GtkAlignment
* @padding_top: location to store the padding for the top of the widget, or %NULL * @padding_top: (allow-none): 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_bottom: (allow-none): 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_left: (allow-none): 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_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. * Gets the padding on the different sides of the widget.
* See gtk_alignment_set_padding (). * See gtk_alignment_set_padding ().
......
...@@ -1736,7 +1736,7 @@ gtk_assistant_insert_page (GtkAssistant *assistant, ...@@ -1736,7 +1736,7 @@ gtk_assistant_insert_page (GtkAssistant *assistant,
/** /**
* gtk_assistant_set_forward_page_func: * gtk_assistant_set_forward_page_func:
* @assistant: a #GtkAssistant