Commit 5b6cfd98 authored by Michael Natterer's avatar Michael Natterer 😴

pdb, libgimp: generate (transfer full) annotations for libgimp

for all returned allocated memory.
parent 1291769c
Pipeline #100235 passed with stages
in 16 minutes and 7 seconds
......@@ -46,7 +46,7 @@
* This procedure returns the version number of the currently running
* GIMP.
*
* Returns: GIMP version number.
* Returns: (transfer full) GIMP version number.
**/
gchar *
gimp_version (void)
......@@ -178,7 +178,7 @@ gimp_detach_parasite (const gchar *name)
*
* Finds and returns the global parasite that was previously attached.
*
* Returns: The found parasite.
* Returns: (transfer full) The found parasite.
*
* Since: 2.8
**/
......@@ -213,8 +213,8 @@ gimp_get_parasite (const gchar *name)
*
* Returns a list of all currently attached global parasites.
*
* Returns: The names of currently attached parasites. The returned
* value must be freed with g_strfreev().
* Returns: (transfer full) The names of currently attached parasites.
* The returned value must be freed with g_strfreev().
*
* Since: 2.8
**/
......@@ -253,7 +253,7 @@ gimp_get_parasite_list (gint *num_parasites)
* Generates a unique filename using the temp path supplied in the
* user's gimprc.
*
* Returns: The new temp filename.
* Returns: (transfer full) The new temp filename.
**/
gchar *
gimp_temp_name (const gchar *extension)
......
......@@ -42,8 +42,8 @@
*
* This procedure creates a new, uninitialized brush.
*
* Returns: The actual new brush name. The returned value must be freed
* with g_free().
* Returns: (transfer full) The actual new brush name. The returned
* value must be freed with g_free().
*
* Since: 2.2
**/
......@@ -78,8 +78,8 @@ gimp_brush_new (const gchar *name)
*
* This procedure creates an identical brush by a different name.
*
* Returns: The name of the brush's copy. The returned value must be
* freed with g_free().
* Returns: (transfer full) The name of the brush's copy. The returned
* value must be freed with g_free().
*
* Since: 2.2
**/
......@@ -150,8 +150,8 @@ gimp_brush_is_generated (const gchar *name)
*
* This procedure renames a brush.
*
* Returns: The actual new name of the brush. The returned value must
* be freed with g_free().
* Returns: (transfer full) The actual new name of the brush. The
* returned value must be freed with g_free().
*
* Since: 2.2
**/
......@@ -313,10 +313,10 @@ gimp_brush_get_info (const gchar *name,
* @height: The brush height.
* @mask_bpp: The brush mask bpp.
* @num_mask_bytes: Length of brush mask data.
* @mask_bytes: The brush mask data.
* @mask_bytes: (transfer full) The brush mask data.
* @color_bpp: The brush color bpp.
* @num_color_bytes: Length of brush color data.
* @color_bytes: The brush color data.
* @color_bytes: (transfer full) The brush color data.
*
* Retrieves information about the specified brush.
*
......
......@@ -75,8 +75,8 @@ gimp_brushes_refresh (void)
* Each name returned can be used as input to the
* gimp_context_set_brush() procedure.
*
* Returns: The list of brush names. The returned value must be freed
* with g_strfreev().
* Returns: (transfer full) The list of brush names. The returned value
* must be freed with g_strfreev().
**/
gchar **
gimp_brushes_get_list (const gchar *filter,
......
......@@ -44,8 +44,8 @@
* This procedure returns a complete listing of available named
* buffers.
*
* Returns: The list of buffer names. The returned value must be freed
* with g_strfreev().
* Returns: (transfer full) The list of buffer names. The returned
* value must be freed with g_strfreev().
*
* Since: 2.4
**/
......@@ -87,7 +87,7 @@ gimp_buffers_get_list (const gchar *filter,
*
* This procedure renames a named buffer.
*
* Returns: The real name given to the buffer.
* Returns: (transfer full) The real name given to the buffer.
*
* Since: 2.4
**/
......
......@@ -139,7 +139,7 @@ gimp_context_set_defaults (void)
/**
* gimp_context_list_paint_methods:
* @num_paint_methods: The number of the available paint methods.
* @paint_methods: The names of the available paint methods.
* @paint_methods: (transfer full) The names of the available paint methods.
*
* Lists the available paint methods.
*
......@@ -188,7 +188,7 @@ gimp_context_list_paint_methods (gint *num_paint_methods,
* This procedure returns the name of the currently active paint
* method.
*
* Returns: The name of the active paint method.
* Returns: (transfer full) The name of the active paint method.
*
* Since: 2.4
**/
......@@ -1100,7 +1100,7 @@ gimp_context_set_line_dash_offset (gdouble dash_offset)
/**
* gimp_context_get_line_dash_pattern:
* @num_dashes: The number of dashes in the dash_pattern array.
* @dashes: The line dash pattern setting.
* @dashes: (transfer full) The line dash pattern setting.
*
* Get the line dash pattern setting.
*
......@@ -1196,7 +1196,7 @@ gimp_context_set_line_dash_pattern (gint num_dashes,
* paint operations and stroke operations use this brush to control the
* application of paint to the image.
*
* Returns: The name of the active brush.
* Returns: (transfer full) The name of the active brush.
*
* Since: 2.2
**/
......@@ -1762,7 +1762,7 @@ gimp_context_set_brush_force (gdouble force)
* dynamics. All paint operations and stroke operations use this paint
* dynamics to control the application of paint to the image.
*
* Returns: The name of the active paint dynamics.
* Returns: (transfer full) The name of the active paint dynamics.
*
* Since: 2.8
**/
......@@ -1834,7 +1834,7 @@ gimp_context_set_dynamics (const gchar *name)
* This procedure returns the name of the currently active MyPaint
* brush.
*
* Returns: The name of the active MyPaint brush.
* Returns: (transfer full) The name of the active MyPaint brush.
*
* Since: 2.10
**/
......@@ -1907,7 +1907,7 @@ gimp_context_set_mypaint_brush (const gchar *name)
* clone and bucket-fill operations with patterns will use this pattern
* to control the application of paint to the image.
*
* Returns: The name of the active pattern.
* Returns: (transfer full) The name of the active pattern.
*
* Since: 2.2
**/
......@@ -1978,7 +1978,7 @@ gimp_context_set_pattern (const gchar *name)
*
* This procedure returns the name of the currently active gradient.
*
* Returns: The name of the active gradient.
* Returns: (transfer full) The name of the active gradient.
*
* Since: 2.2
**/
......@@ -2383,7 +2383,8 @@ gimp_context_set_gradient_reverse (gboolean reverse)
*
* This procedure returns the name of the the currently active palette.
*
* Returns: (transfer full): The name of the active palette.
* Returns: (transfer full) (transfer full): The name of the active
* palette.
*
* Since: 2.2
**/
......@@ -2454,7 +2455,7 @@ gimp_context_set_palette (const gchar *name)
*
* This procedure returns the name of the currently active font.
*
* Returns: The name of the active font.
* Returns: (transfer full) The name of the active font.
*
* Since: 2.2
**/
......
......@@ -45,7 +45,7 @@
* encoding. In order to get to the real format, the libbgimp C wrapper
* must be used.
*
* Returns: The drawable's Babl format.
* Returns: (transfer full) The drawable's Babl format.
*
* Since: 2.10
**/
......@@ -82,7 +82,7 @@ _gimp_drawable_get_format (gint32 drawable_ID)
* Thumbnails are always 8-bit images, see gimp_drawable_thumbnail()
* and gimp_drawable_sub_thmbnail().
*
* Returns: The drawable's thumbnail Babl format.
* Returns: (transfer full) The drawable's thumbnail Babl format.
*
* Since: 2.10.14
**/
......@@ -714,7 +714,7 @@ gimp_drawable_update (gint32 drawable_ID,
* The 'num_channels' argument must always be equal to the
* bytes-per-pixel value for the specified drawable.
*
* Returns: The pixel value.
* Returns: (transfer full) The pixel value.
**/
guint8 *
gimp_drawable_get_pixel (gint32 drawable_ID,
......@@ -912,7 +912,7 @@ gimp_drawable_offset (gint32 drawable_ID,
* @actual_height: The previews height.
* @bpp: The previews bpp.
* @thumbnail_data_count: The number of bytes in thumbnail data.
* @thumbnail_data: The thumbnail data.
* @thumbnail_data: (transfer full) The thumbnail data.
*
* Get a thumbnail of a drawable.
*
......@@ -984,7 +984,7 @@ _gimp_drawable_thumbnail (gint32 drawable_ID,
* @height: The previews height.
* @bpp: The previews bpp.
* @thumbnail_data_count: The number of bytes in thumbnail data.
* @thumbnail_data: The thumbnail data.
* @thumbnail_data: (transfer full) The thumbnail data.
*
* Get a thumbnail of a sub-area of a drawable drawable.
*
......
......@@ -77,8 +77,8 @@ gimp_dynamics_refresh (void)
* This procedure returns a list of the paint dynamics that are
* currently available.
*
* Returns: The list of paint dynamics names. The returned value must
* be freed with g_strfreev().
* Returns: (transfer full) The list of paint dynamics names. The
* returned value must be freed with g_strfreev().
*
* Since: 2.8
**/
......
......@@ -254,8 +254,8 @@ gimp_edit_paste_as_new_image (void)
* later pasting, regardless of any intermediate copy or cut
* operations.
*
* Returns: The real name given to the buffer, or NULL if the cut
* failed.
* Returns: (transfer full) The real name given to the buffer, or NULL
* if the cut failed.
*
* Since: 2.4
**/
......@@ -297,8 +297,8 @@ gimp_edit_named_cut (gint32 drawable_ID,
* later pasting, regardless of any intermediate copy or cut
* operations.
*
* Returns: The real name given to the buffer, or NULL if the copy
* failed.
* Returns: (transfer full) The real name given to the buffer, or NULL
* if the copy failed.
*
* Since: 2.4
**/
......@@ -340,8 +340,8 @@ gimp_edit_named_copy (gint32 drawable_ID,
* available for later pasting, regardless of any intermediate copy or
* cut operations.
*
* Returns: The real name given to the buffer, or NULL if the copy
* failed.
* Returns: (transfer full) The real name given to the buffer, or NULL
* if the copy failed.
*
* Since: 2.4
**/
......
......@@ -141,7 +141,7 @@ gimp_file_load_layer (GimpRunMode run_mode,
* needs to be added to the existing image with
* gimp_image_insert_layer().
*
* Returns: The list of loaded layers.
* Returns: (transfer full) The list of loaded layers.
*
* Since: 2.4
**/
......
......@@ -75,8 +75,8 @@ gimp_fonts_refresh (void)
* This procedure returns a list of the fonts that are currently
* available.
*
* Returns: The list of font names. The returned value must be freed
* with g_strfreev().
* Returns: (transfer full) The list of font names. The returned value
* must be freed with g_strfreev().
**/
gchar **
gimp_fonts_get_list (const gchar *filter,
......
......@@ -50,7 +50,8 @@
* string. Entries not corresponding to this format will cause warnings
* to be issued on gimprc parsing and will not be queryable.
*
* Returns: The value associated with the queried token.
* Returns: (transfer full) The value associated with the queried
* token.
**/
gchar *
gimp_gimprc_query (const gchar *token)
......@@ -122,7 +123,7 @@ gimp_gimprc_set (const gchar *token,
*
* Returns a copy of the default image comment.
*
* Returns: Default image comment.
* Returns: (transfer full) Default image comment.
**/
gchar *
gimp_get_default_comment (void)
......@@ -229,7 +230,7 @@ gimp_get_monitor_resolution (gdouble *xres,
* Returns a string that can be deserialized into a GimpColorConfig
* object representing the current color management configuration.
*
* Returns: Serialized color management configuration.
* Returns: (transfer full) Serialized color management configuration.
*
* Since: 2.4
**/
......@@ -261,7 +262,7 @@ _gimp_get_color_configuration (void)
*
* Returns a copy of the list of modules which should not be loaded.
*
* Returns: The list of modules.
* Returns: (transfer full) The list of modules.
**/
gchar *
gimp_get_module_load_inhibit (void)
......
......@@ -42,7 +42,7 @@
*
* This procedure creates a new, uninitialized gradient
*
* Returns: The actual new gradient name.
* Returns: (transfer full) The actual new gradient name.
*
* Since: 2.2
**/
......@@ -77,7 +77,7 @@ gimp_gradient_new (const gchar *name)
*
* This procedure creates an identical gradient by a different name
*
* Returns: The name of the gradient's copy.
* Returns: (transfer full) The name of the gradient's copy.
*
* Since: 2.2
**/
......@@ -148,7 +148,7 @@ gimp_gradient_is_editable (const gchar *name)
*
* This procedure renames a gradient
*
* Returns: The actual new name of the gradient.
* Returns: (transfer full) The actual new name of the gradient.
*
* Since: 2.2
**/
......@@ -254,7 +254,7 @@ gimp_gradient_get_number_of_segments (const gchar *name)
* @num_samples: The number of samples to take.
* @reverse: Use the reverse gradient.
* @num_color_samples: Length of the color_samples array (4 * num_samples).
* @color_samples: Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
* @color_samples: (transfer full) Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
*
* Sample the specified in uniform parts.
*
......@@ -316,7 +316,7 @@ gimp_gradient_get_uniform_samples (const gchar *name,
* @positions: The list of positions to sample along the gradient.
* @reverse: Use the reverse gradient.
* @num_color_samples: Length of the color_samples array (4 * num_samples).
* @color_samples: Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
* @color_samples: (transfer full) Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
*
* Sample the specified gradient in custom positions.
*
......
......@@ -75,8 +75,8 @@ gimp_gradients_refresh (void)
* loaded. You can later use the gimp_context_set_gradient() function
* to set the active gradient.
*
* Returns: The list of gradient names. The returned value must be
* freed with g_strfreev().
* Returns: (transfer full) The list of gradient names. The returned
* value must be freed with g_strfreev().
**/
gchar **
gimp_gradients_get_list (const gchar *filter,
......
......@@ -79,8 +79,8 @@ gimp_image_is_valid (gint32 image_ID)
*
* This procedure returns the list of images currently open in GIMP.
*
* Returns: The list of images currently open. The returned value must
* be freed with g_free().
* Returns: (transfer full) The list of images currently open. The
* returned value must be freed with g_free().
**/
gint *
gimp_image_list (gint *num_images)
......@@ -462,8 +462,8 @@ gimp_image_height (gint32 image_ID)
* This procedure returns the list of layers contained in the specified
* image. The order of layers is from topmost to bottommost.
*
* Returns: The list of layers contained in the image. The returned
* value must be freed with g_free().
* Returns: (transfer full) The list of layers contained in the image.
* The returned value must be freed with g_free().
**/
gint *
gimp_image_get_layers (gint32 image_ID,
......@@ -507,8 +507,8 @@ gimp_image_get_layers (gint32 image_ID,
* \"channels\" are custom channels and do not include the image's
* color components.
*
* Returns: The list of channels contained in the image. The returned
* value must be freed with g_free().
* Returns: (transfer full) The list of channels contained in the
* image. The returned value must be freed with g_free().
**/
gint *
gimp_image_get_channels (gint32 image_ID,
......@@ -549,8 +549,8 @@ gimp_image_get_channels (gint32 image_ID,
* This procedure returns the list of vectors contained in the
* specified image.
*
* Returns: The list of vectors contained in the image. The returned
* value must be freed with g_free().
* Returns: (transfer full) The list of vectors contained in the image.
* The returned value must be freed with g_free().
*
* Since: 2.4
**/
......@@ -1728,8 +1728,8 @@ gimp_image_merge_down (gint32 image_ID,
* 3. If the image is not in Indexed color mode, no colormap is
* returned.
*
* Returns: The image's colormap. The returned value must be freed with
* g_free().
* Returns: (transfer full) The image's colormap. The returned value
* must be freed with g_free().
**/
guint8 *
_gimp_image_get_colormap (gint32 image_ID,
......@@ -1812,7 +1812,7 @@ _gimp_image_set_colormap (gint32 image_ID,
*
* Returns exif/iptc/xmp metadata from the image.
*
* Returns: The exif/ptc/xmp metadata as a string.
* Returns: (transfer full) The exif/ptc/xmp metadata as a string.
**/
gchar *
_gimp_image_get_metadata (gint32 image_ID)
......@@ -1955,7 +1955,7 @@ gimp_image_is_dirty (gint32 image_ID)
* @actual_height: The previews height.
* @bpp: The previews bpp.
* @thumbnail_data_count: The number of bytes in thumbnail data.
* @thumbnail_data: The thumbnail data.
* @thumbnail_data: (transfer full) The thumbnail data.
*
* Get a thumbnail of an image.
*
......@@ -2443,8 +2443,8 @@ gimp_image_set_component_visible (gint32 image_ID,
* Otherwise, this function returns %NULL. See also
* gimp_image_get_uri().
*
* Returns: The filename. The returned value must be freed with
* g_free().
* Returns: (transfer full) The filename. The returned value must be
* freed with g_free().
**/
gchar *
gimp_image_get_filename (gint32 image_ID)
......@@ -2520,7 +2520,8 @@ gimp_image_set_filename (gint32 image_ID,
* and not yet saved, or gimp-image-get-exported-uri if the image has
* been exported to a non-GIMP file format.
*
* Returns: The URI. The returned value must be freed with g_free().
* Returns: (transfer full) The URI. The returned value must be freed
* with g_free().
*
* Since: 2.8
**/
......@@ -2556,8 +2557,8 @@ gimp_image_get_uri (gint32 image_ID)
* This procedure returns the XCF URI associated with the image. If
* there is no such URI, this procedure returns %NULL.
*
* Returns: The imported URI. The returned value must be freed with
* g_free().
* Returns: (transfer full) The imported URI. The returned value must
* be freed with g_free().
*
* Since: 2.8
**/
......@@ -2595,8 +2596,8 @@ gimp_image_get_xcf_uri (gint32 image_ID)
* image was not imported, or has since been saved in the native Gimp
* format, this procedure returns %NULL.
*
* Returns: The imported URI. The returned value must be freed with
* g_free().
* Returns: (transfer full) The imported URI. The returned value must
* be freed with g_free().
*
* Since: 2.8
**/
......@@ -2633,8 +2634,8 @@ gimp_image_get_imported_uri (gint32 image_ID)
* if the image was exported a non-native GIMP format. If the image was
* not exported, this procedure returns %NULL.
*
* Returns: The exported URI. The returned value must be freed with
* g_free().
* Returns: (transfer full) The exported URI. The returned value must
* be freed with g_free().
*
* Since: 2.8
**/
......@@ -2675,7 +2676,8 @@ gimp_image_get_exported_uri (gint32 image_ID)
* '(imported)' etc. and should only be used to label user interface
* elements. Never use it to construct filenames.
*
* Returns: The name. The returned value must be freed with g_free().
* Returns: (transfer full) The name. The returned value must be freed
* with g_free().
**/
gchar *
gimp_image_get_name (gint32 image_ID)
......@@ -3270,7 +3272,7 @@ gimp_image_detach_parasite (gint32 image_ID,
* Finds and returns the parasite that was previously attached to an
* image.
*
* Returns: The found parasite.
* Returns: (transfer full) The found parasite.
*
* Since: 2.8
**/
......@@ -3309,8 +3311,8 @@ gimp_image_get_parasite (gint32 image_ID,
*
* Returns a list of all currently attached parasites.
*
* Returns: The names of currently attached parasites. The returned
* value must be freed with g_strfreev().
* Returns: (transfer full) The names of currently attached parasites.
* The returned value must be freed with g_strfreev().
*
* Since: 2.8
**/
......
......@@ -44,8 +44,8 @@
* This procedure returns the image's color profile, or NULL if the
* image has no color profile assigned.
*
* Returns: The image's serialized color profile. The returned value
* must be freed with g_free().
* Returns: (transfer full) The image's serialized color profile. The
* returned value must be freed with g_free().
*
* Since: 2.10
**/
......@@ -91,8 +91,8 @@ _gimp_image_get_color_profile (gint32 image_ID,
* or a generated default RGB or grayscale profile, according to the
* image's type.
*
* Returns: The image's serialized color profile. The returned value
* must be freed with g_free().
* Returns: (transfer full) The image's serialized color profile. The
* returned value must be freed with g_free().
*
* Since: 2.10
**/
......
......@@ -469,7 +469,7 @@ gimp_item_get_parent (gint32 item_ID)
* This procedure returns the list of items which are children of the
* specified item. The order is topmost to bottommost.
*
* Returns: The item's list of children.
* Returns: (transfer full) The item's list of children.
*
* Since: 2.8
**/
......@@ -583,7 +583,7 @@ gimp_item_set_expanded (gint32 item_ID,
*
* This procedure returns the specified item's name.
*
* Returns: The item name.
* Returns: (transfer full) The item name.
*
* Since: 2.8
**/
......@@ -1177,7 +1177,7 @@ gimp_item_detach_parasite (gint32 item_ID,
*
* Finds and returns the parasite that is attached to an item.
*
* Returns: The found parasite.
* Returns: (transfer full) The found parasite.
*
* Since: 2.8
**/
......@@ -1216,8 +1216,8 @@ gimp_item_get_parasite (gint32 item_ID,
*
* Returns a list of all parasites currently attached the an item.
*
* Returns: The names of currently attached parasites. The returned
* value must be freed with g_strfreev().
* Returns: (transfer full) The names of currently attached parasites.
* The returned value must be freed with g_strfreev().
*
* Since: 2.8
**/
......
......@@ -42,7 +42,7 @@
*
* This procedure creates a new, uninitialized palette
*
* Returns: The actual new palette name.
* Returns: (transfer full) The actual new palette name.
*
* Since: 2.2
**/
......@@ -77,7 +77,7 @@ gimp_palette_new (const gchar *name)
*
* This procedure creates an identical palette by a different name
*
* Returns: The name of the palette's copy.
* Returns: (transfer full) The name of the palette's copy.
*
* Since: 2.2
**/
......@@ -113,7 +113,7 @@ gimp_palette_duplicate (const gchar *name)
*
* This procedure renames a palette
*
* Returns: The actual new name of the palette.
* Returns: (transfer full) The actual new name of the palette.
*
* Since: 2.2
**/
......@@ -263,7 +263,7 @@ gimp_palette_get_info (const gchar *name,
*
* This procedure retrieves all color entries of the specified palette.
*
* Returns: The colors in the palette.
* Returns: (transfer full) The colors in the palette.
*
* Since: 2.6
**/
......@@ -554,7 +554,7 @@ gimp_palette_entry_set_color (const gchar *name,
* gimp_palette_entry_get_name:
* @name: The palette name.
* @entry_num: The entry to retrieve.
* @entry_name: The name requested.
* @entry_name: (transfer full) The name requested.
*
* Gets the specified palette entry from the specified palette.
*
......
......@@ -75,8 +75,8 @@ gimp_palettes_refresh (void)
* Each name returned can be used as input to the command
* gimp_context_set_palette().
*
* Returns: The list of palette names. The returned value must be freed
* with g_strfreev().
* Returns: (transfer full) The list of palette names. The returned
* value must be freed with g_strfreev().
**/
gchar **
gimp_palettes_get_list (const gchar *filter,
......
......@@ -93,7 +93,7 @@ gimp_pattern_get_info (const gchar *name,
* @height: The pattern height.
* @bpp: The pattern bpp.
* @num_color_bytes: Number of pattern bytes.
* @color_bytes: The pattern data.
* @color_bytes: (transfer full) The pattern data.
*
* Retrieve information about the specified pattern (including pixels).
*
......
......@@ -75,8 +75,8 @@ gimp_patterns_refresh (void)
* patterns. Each name returned can be used as input to the
* gimp_context_set_pattern().
*
* Returns: The list of pattern names. The returned value must be freed
* with g_strfreev().
* Returns: (transfer full) The list of pattern names. The returned
* value must be freed with g_strfreev().
**/
gchar **
gimp_patterns_get_list (const gchar *filter,
......
......@@ -43,7 +43,8 @@
* This procedure generates a temporary PDB entry name that is
* guaranteed to be unique.
*
* Returns: A unique temporary name for a temporary PDB entry.
* Returns: (transfer full) A unique temporary name for a temporary PDB
* entry.
**/
gchar *
gimp_procedural_db_temp_name (void)
......@@ -110,7 +111,7 @@ gimp_procedural_db_dump (const gchar *filename)
* @date: The regex for procedure date.
* @proc_type: The regex for procedure type: { 'Internal GIMP procedure', 'GIMP Plug-in', 'GIMP Extension', 'Temporary Procedure' }.
* @num_matches: The number of matching procedures.
* @procedure_names: The list of procedure names.
* @procedure_names: (transfer full) The list of procedure names.
*
* Queries the procedural database for its contents using regular
* expression matching.
......@@ -220,11 +221,11 @@ gimp_procedural_db_proc_exists (const gchar *procedure_name)
/**
* _gimp_procedural_db_proc_info:
* @procedure_name: The procedure name.
* @blurb: A short blurb.
* @help: Detailed procedure help.
* @author: Author(s) of the procedure.
* @copyright: The copyright.
* @date: Copyright date.
* @blurb: (transfer full) A short blurb.
* @help: (transfer full) Detailed procedure help.
* @author: (transfer full) Author(s) of the procedure.
* @copyright: (transfer full) The copyright.
* @date: (transfer full) Copyright date.
* @proc_type: The procedure type.
* @num_args: The number of input arguments.
* @num_values: The number of return values.
......@@ -297,8 +298,8 @@ _gimp_procedural_db_proc_info (const gchar *procedure_name,
* @procedure_name: The procedure name.
* @arg_num: The argument number.
* @arg_type: The type of argument.
* @arg_name: The name of the argument.
* @arg_desc: A description of the argument.
* @arg_name: (transfer full) The name of the argument.
* @arg_desc: (transfer full) A description of the argument.
*
* Queries the procedural database for information on the specified
* procedure's argument.
......@@ -352,8 +353,8 @@ gimp_procedural_db_proc_arg (const gchar *procedure_name,
* @procedure_name: The procedure name.
* @val_num: The return value number.
* @val_type: The type of return value.
* @val_name: The name of the return value.
* @val_desc: A description of the return value.
* @val_name: (transfer full) The name of the return value.
* @val_desc: (transfer full) A description of the return value.
*
* Queries the procedural database for information on the specified
* procedure's return value.
......@@ -407,7 +408,7 @@ gimp_procedural_db_proc_val (const gchar *procedure_name,
* _gimp_procedural_db_get_data:
* @identifier: The identifier associated with data.
* @bytes: The number of bytes in the data.
* @data: A byte array containing data.
* @data: (transfer full) A byte array containing data.
*
* Returns data associated with the specified identifier.
*
......
......@@ -98,7 +98,7 @@ gimp_text_layer_new (gint32 image_ID,
*
* This procedure returns the text from a text layer as a string.
*
* Returns: The text from the specified text layer.
* Returns: (transfer full) The text from the specified text layer.
*