pdb: add (element-type foo) annotations to all returned arrays

libgimp/gimp_pdb.c

@@ -213,8 +213,9 @@ gimp_get_parasite (const gchar *name)
  *
  * Returns a list of all currently attached global parasites.
  *
- * Returns: (transfer full) The names of currently attached parasites.
+ * Returns: (element-type gchar*) (transfer full) The names of
- * The returned value must be freed with g_strfreev().
+ * currently attached parasites. The returned value must be freed with
+ * g_strfreev().
  *
  * Since: 2.8
  **/

libgimp/gimpbrush_pdb.c

@@ -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: (transfer full) The brush mask data.
+ * @mask_bytes: (element-type guint8) (transfer full) The brush mask data.
  * @color_bpp: The brush color bpp.
  * @num_color_bytes: Length of brush color data.
- * @color_bytes: (transfer full) The brush color data.
+ * @color_bytes: (element-type guint8) (transfer full) The brush color data.
  *
  * Retrieves information about the specified brush.
  *

libgimp/gimpbrushes_pdb.c

@@ -75,8 +75,8 @@ gimp_brushes_refresh (void)
  * Each name returned can be used as input to the
  * gimp_context_set_brush() procedure.
  *
- * Returns: (transfer full) The list of brush names. The returned value
+ * Returns: (element-type gchar*) (transfer full) The list of brush
- * must be freed with g_strfreev().
+ * names. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_brushes_get_list (const gchar *filter,

libgimp/gimpbuffer_pdb.c

@@ -44,8 +44,8 @@
  * This procedure returns a complete listing of available named
  * buffers.
  *
- * Returns: (transfer full) The list of buffer names. The returned
+ * Returns: (element-type gchar*) (transfer full) The list of buffer
- * value must be freed with g_strfreev().
+ * names. The returned value must be freed with g_strfreev().
  *
  * Since: 2.4
  **/

libgimp/gimpcontext_pdb.c

@@ -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: (transfer full) The names of the available paint methods.
+ * @paint_methods: (element-type gchar*) (transfer full) The names of the available paint methods.
  *
  * Lists the available paint methods.
  *
@@ -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: (transfer full) The line dash pattern setting.
+ * @dashes: (elemen-type gdouble) (transfer full) The line dash pattern setting.
  *
  * Get the line dash pattern setting.
  *

libgimp/gimpdrawable_pdb.c

@@ -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: (transfer full) The pixel value.
+ * Returns: (element-type guint8) (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: (transfer full) The thumbnail data.
+ * @thumbnail_data: (element-type guint8) (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: (transfer full) The thumbnail data.
+ * @thumbnail_data: (element-type guint8) (transfer full) The thumbnail data.
  *
  * Get a thumbnail of a sub-area of a drawable drawable.
  *

libgimp/gimpdynamics_pdb.c

@@ -77,8 +77,8 @@ gimp_dynamics_refresh (void)
  * This procedure returns a list of the paint dynamics that are
  * currently available.
  *
- * Returns: (transfer full) The list of paint dynamics names. The
+ * Returns: (element-type gchar*) (transfer full) The list of paint
- * returned value must be freed with g_strfreev().
+ * dynamics names. The returned value must be freed with g_strfreev().
  *
  * Since: 2.8
  **/

libgimp/gimpfileops_pdb.c

@@ -141,7 +141,8 @@ gimp_file_load_layer (GimpRunMode  run_mode,
  * needs to be added to the existing image with
  * gimp_image_insert_layer().
  *
- * Returns: (transfer full) The list of loaded layers.
+ * Returns: (element-type gint32) (transfer full) The list of loaded
+ * layers.
  *
  * Since: 2.4
  **/

libgimp/gimpfonts_pdb.c

@@ -75,8 +75,8 @@ gimp_fonts_refresh (void)
  * This procedure returns a list of the fonts that are currently
  * available.
  *
- * Returns: (transfer full) The list of font names. The returned value
+ * Returns: (element-type gchar*) (transfer full) The list of font
- * must be freed with g_strfreev().
+ * names. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_fonts_get_list (const gchar *filter,

libgimp/gimpgradient_pdb.c

@@ -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: (transfer full) Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
+ * @color_samples: (elemen-type gdouble) (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: (transfer full) Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
+ * @color_samples: (elemen-type gdouble) (transfer full) Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
  *
  * Sample the specified gradient in custom positions.
  *

libgimp/gimpgradients_pdb.c

@@ -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: (transfer full) The list of gradient names. The returned
+ * Returns: (element-type gchar*) (transfer full) The list of gradient
- * value must be freed with g_strfreev().
+ * names. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_gradients_get_list (const gchar *filter,

libgimp/gimpimage_pdb.c

@@ -79,8 +79,8 @@ gimp_image_is_valid (gint32 image_ID)
  *
  * This procedure returns the list of images currently open in GIMP.
  *
- * Returns: (transfer full) The list of images currently open. The
+ * Returns: (element-type gint32) (transfer full) The list of images
- * returned value must be freed with g_free().
+ * currently open. The returned value must be freed with g_free().
  **/
 gint *
 gimp_image_list (gint *num_images)
@@ -462,8 +462,9 @@ 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: (transfer full) The list of layers contained in the image.
+ * Returns: (element-type gint32) (transfer full) The list of layers
- * The returned value must be freed with g_free().
+ * contained in the image. The returned value must be freed with
+ * g_free().
  **/
 gint *
 gimp_image_get_layers (gint32  image_ID,
@@ -507,8 +508,9 @@ gimp_image_get_layers (gint32  image_ID,
  * \"channels\" are custom channels and do not include the image's
  * color components.
  *
- * Returns: (transfer full) The list of channels contained in the
+ * Returns: (element-type gint32) (transfer full) The list of channels
- * image. The returned value must be freed with g_free().
+ * contained in the image. The returned value must be freed with
+ * g_free().
  **/
 gint *
 gimp_image_get_channels (gint32  image_ID,
@@ -549,8 +551,9 @@ gimp_image_get_channels (gint32  image_ID,
  * This procedure returns the list of vectors contained in the
  * specified image.
  *
- * Returns: (transfer full) The list of vectors contained in the image.
+ * Returns: (element-type gint32) (transfer full) The list of vectors
- * The returned value must be freed with g_free().
+ * contained in the image. The returned value must be freed with
+ * g_free().
  *
  * Since: 2.4
  **/
@@ -1728,8 +1731,8 @@ gimp_image_merge_down (gint32        image_ID,
  * 3. If the image is not in Indexed color mode, no colormap is
  * returned.
  *
- * Returns: (transfer full) The image's colormap. The returned value
+ * Returns: (element-type guint8) (transfer full) The image's colormap.
- * must be freed with g_free().
+ * The returned value must be freed with g_free().
  **/
 guint8 *
 _gimp_image_get_colormap (gint32  image_ID,
@@ -1955,7 +1958,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: (transfer full) The thumbnail data.
+ * @thumbnail_data: (element-type guint8) (transfer full) The thumbnail data.
  *
  * Get a thumbnail of an image.
  *
@@ -3311,8 +3314,9 @@ gimp_image_get_parasite (gint32       image_ID,
  *
  * Returns a list of all currently attached parasites.
  *
- * Returns: (transfer full) The names of currently attached parasites.
+ * Returns: (element-type gchar*) (transfer full) The names of
- * The returned value must be freed with g_strfreev().
+ * currently attached parasites. The returned value must be freed with
+ * g_strfreev().
  *
  * Since: 2.8
  **/

libgimp/gimpimagecolorprofile_pdb.c

@@ -44,8 +44,9 @@
  * This procedure returns the image's color profile, or NULL if the
  * image has no color profile assigned.
  *
- * Returns: (transfer full) The image's serialized color profile. The
+ * Returns: (element-type guint8) (transfer full) The image's
- * returned value must be freed with g_free().
+ * serialized color profile. The returned value must be freed with
+ * g_free().
  *
  * Since: 2.10
  **/
@@ -91,8 +92,9 @@ _gimp_image_get_color_profile (gint32  image_ID,
  * or a generated default RGB or grayscale profile, according to the
  * image's type.
  *
- * Returns: (transfer full) The image's serialized color profile. The
+ * Returns: (element-type guint8) (transfer full) The image's
- * returned value must be freed with g_free().
+ * serialized color profile. The returned value must be freed with
+ * g_free().
  *
  * Since: 2.10
  **/

libgimp/gimpitem_pdb.c

@@ -469,7 +469,8 @@ 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: (transfer full) The item's list of children.
+ * Returns: (element-type gint32) (transfer full) The item's list of
+ * children.
  *
  * Since: 2.8
  **/
@@ -1216,8 +1217,9 @@ gimp_item_get_parasite (gint32       item_ID,
  *
  * Returns a list of all parasites currently attached the an item.
  *
- * Returns: (transfer full) The names of currently attached parasites.
+ * Returns: (element-type gchar*) (transfer full) The names of
- * The returned value must be freed with g_strfreev().
+ * currently attached parasites. The returned value must be freed with
+ * g_strfreev().
  *
  * Since: 2.8
  **/

libgimp/gimppalette_pdb.c

@@ -263,7 +263,8 @@ gimp_palette_get_info (const gchar *name,
  *
  * This procedure retrieves all color entries of the specified palette.
  *
- * Returns: (transfer full) The colors in the palette.
+ * Returns: (element-type GimpRGB) (transfer full) The colors in the
+ * palette.
  *
  * Since: 2.6
  **/

libgimp/gimppalettes_pdb.c

@@ -75,8 +75,8 @@ gimp_palettes_refresh (void)
  * Each name returned can be used as input to the command
  * gimp_context_set_palette().
  *
- * Returns: (transfer full) The list of palette names. The returned
+ * Returns: (element-type gchar*) (transfer full) The list of palette
- * value must be freed with g_strfreev().
+ * names. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_palettes_get_list (const gchar *filter,

libgimp/gimppattern_pdb.c

@@ -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: (transfer full) The pattern data.
+ * @color_bytes: (element-type guint8) (transfer full) The pattern data.
  *
  * Retrieve information about the specified pattern (including pixels).
  *

libgimp/gimppatterns_pdb.c

@@ -75,8 +75,8 @@ gimp_patterns_refresh (void)
  * patterns. Each name returned can be used as input to the
  * gimp_context_set_pattern().
  *
- * Returns: (transfer full) The list of pattern names. The returned
+ * Returns: (element-type gchar*) (transfer full) The list of pattern
- * value must be freed with g_strfreev().
+ * names. The returned value must be freed with g_strfreev().
  **/
 gchar **
 gimp_patterns_get_list (const gchar *filter,

libgimp/gimpproceduraldb_pdb.c

@@ -111,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: (transfer full) The list of procedure names.
+ * @procedure_names: (element-type gchar*) (transfer full) The list of procedure names.
  *
  * Queries the procedural database for its contents using regular
  * expression matching.
@@ -408,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: (transfer full) A byte array containing data.
+ * @data: (element-type guint8) (transfer full) A byte array containing data.
  *
  * Returns data associated with the specified identifier.
  *

libgimp/gimpvectors_pdb.c

@@ -161,7 +161,8 @@ gimp_vectors_copy (gint32 vectors_ID)
  * Returns an Array with the stroke-IDs associated with the passed
  * path.
  *
- * Returns: (transfer full) List of the strokes belonging to the path.
+ * Returns: (element-type gint32) (transfer full) List of the strokes
+ * belonging to the path.
  *
  * Since: 2.4
  **/
@@ -634,7 +635,7 @@ gimp_vectors_stroke_flip_free (gint32  vectors_ID,
  * @vectors_ID: The vectors object.
  * @stroke_id: The stroke ID.
  * @num_points: The number of floats returned.
- * @controlpoints: (transfer full) List of the control points for the stroke (x0, y0, x1, y1, ...).
+ * @controlpoints: (elemen-type gdouble) (transfer full) List of the control points for the stroke (x0, y0, x1, y1, ...).
  * @closed: Whether the stroke is closed or not.
  *
  * returns the control points of a stroke.
@@ -755,8 +756,8 @@ gimp_vectors_stroke_new_from_points (gint32                 vectors_ID,
  *
  * returns polygonal approximation of the stroke.
  *
- * Returns: (transfer full) List of the coords along the path (x0, y0,
+ * Returns: (elemen-type gdouble) (transfer full) List of the coords
- * x1, y1, ...).
+ * along the path (x0, y0, x1, y1, ...).
  *
  * Since: 2.4
  **/
@@ -1066,7 +1067,7 @@ gimp_vectors_bezier_stroke_new_ellipse (gint32  vectors_ID,
  * @merge: Merge paths into a single vectors object.
  * @scale: Scale the SVG to image dimensions.
  * @num_vectors: The number of newly created vectors.
- * @vectors_ids: (transfer full) The list of newly created vectors.
+ * @vectors_ids: (element-type gint32) (transfer full) The list of newly created vectors.
  *
  * Import paths from an SVG file.
  *
@@ -1127,7 +1128,7 @@ gimp_vectors_import_from_file (gint32        image_ID,
  * @merge: Merge paths into a single vectors object.
  * @scale: Scale the SVG to image dimensions.
  * @num_vectors: The number of newly created vectors.
- * @vectors_ids: (transfer full) The list of newly created vectors.
+ * @vectors_ids: (element-type gint32) (transfer full) The list of newly created vectors.
  *
  * Import paths from an SVG string.
  *

pdb/pdb.pl

@@ -74,7 +74,7 @@ package Gimp::CodeGen::pdb;
 		     const_type      => 'const gint32 *',
 		     array           => 1,
 		     init_value      => 'NULL',
-		     return_annotate => '(transfer full)',
+		     return_annotate => '(element-type gint32) (transfer full)',
 		     get_value_func  => '$var = gimp_value_get_int32_array ($value)',
 		     dup_value_func  => '$var = gimp_value_dup_int32_array ($value)',
 		     set_value_func  => 'gimp_value_set_int32_array ($value, $var, $var_len)',
@@ -86,7 +86,7 @@ package Gimp::CodeGen::pdb;
 		     const_type      => 'const gint16 *',
 		     array           => 1,
 		     init_value      => 'NULL',
-		     return_annotate => '(transfer full)',
+		     return_annotate => '(element-type gint16) (transfer full)',
 		     get_value_func  => '$var = gimp_value_get_int16_array ($value)',
 		     dup_value_func  => '$var = gimp_value_dup_int16_array ($value)',
 		     set_value_func  => 'gimp_value_set_int16_array ($value, $var, $var_len)',
@@ -98,7 +98,7 @@ package Gimp::CodeGen::pdb;
 		     const_type      => 'const guint8 *',
 		     array           => 1,
 		     init_value      => 'NULL',
-		     return_annotate => '(transfer full)',
+		     return_annotate => '(element-type guint8) (transfer full)',
 		     get_value_func  => '$var = gimp_value_get_int8_array ($value)',
 		     dup_value_func  => '$var = gimp_value_dup_int8_array ($value)',
 		     set_value_func  => 'gimp_value_set_int8_array ($value, $var, $var_len)',
@@ -110,7 +110,7 @@ package Gimp::CodeGen::pdb;
 		     const_type      => 'const gdouble *',
 		     array           => 1,
 		     init_value      => 'NULL',
-		     return_annotate => '(transfer full)',
+		     return_annotate => '(elemen-type gdouble) (transfer full)',
 		     get_value_func  => '$var = gimp_value_get_float_array ($value)',
 		     dup_value_func  => '$var = gimp_value_dup_float_array ($value)',
 		     set_value_func  => 'gimp_value_set_float_array ($value, $var, $var_len)',
@@ -122,7 +122,7 @@ package Gimp::CodeGen::pdb;
 		     const_type      => 'const gchar **',
 		     array           => 1,
 		     init_value      => 'NULL',
-		     return_annotate => '(transfer full)',
+		     return_annotate => '(element-type gchar*) (transfer full)',
 		     get_value_func  => '$var = gimp_value_get_string_array ($value)',
 		     dup_value_func  => '$var = gimp_value_dup_string_array ($value)',
 		     set_value_func  => 'gimp_value_set_string_array ($value, $var, $var_len)',
@@ -134,7 +134,7 @@ package Gimp::CodeGen::pdb;
 		     const_type      => 'const GimpRGB *',
 		     array           => 1,
 		     init_value      => 'NULL',
-		     return_annotate => '(transfer full)',
+		     return_annotate => '(element-type GimpRGB) (transfer full)',
 		     get_value_func  => '$var = gimp_value_get_rgb_array ($value)',
 		     dup_value_func  => '$var = gimp_value_dup_rgb_array ($value)',
 		     set_value_func  => 'gimp_value_set_rgb_array ($value, $var, $var_len)',