[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

2 files changed, 10 insertions, 10 deletions

diff --git a/gdk-pixbuf/gdk-pixbuf-io.c b/gdk-pixbuf/gdk-pixbuf-io.c
index 82297252f2..7140766ef2 100644
--- a/gdk-pixbuf/gdk-pixbuf-io.c
+++ b/gdk-pixbuf/gdk-pixbuf-io.c
@@ -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.
diff --git a/gdk-pixbuf/gdk-pixbuf-loader.c b/gdk-pixbuf/gdk-pixbuf-loader.c
index f51d4478d4..9ef23c1ad0 100644
--- a/gdk-pixbuf/gdk-pixbuf-loader.c
+++ b/gdk-pixbuf/gdk-pixbuf-loader.c
@@ -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