[gimp] pdb, libgimp: fix missing colons at end of annotations.
- From: Jehan <jehanp src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gimp] pdb, libgimp: fix missing colons at end of annotations.
- Date: Wed, 31 Jul 2019 20:52:36 +0000 (UTC)
commit a87104fffbaefd17a6c5dd82f281ba48adc5f66a
Author: Jehan <jehan girinstud io>
Date: Wed Jul 31 22:51:35 2019 +0200
pdb, libgimp: fix missing colons at end of annotations.
libgimp/gimp_pdb.c | 10 +++----
libgimp/gimpbrush_pdb.c | 32 ++++++++++----------
libgimp/gimpbrushes_pdb.c | 6 ++--
libgimp/gimpbuffer_pdb.c | 6 ++--
libgimp/gimpchannel_pdb.c | 2 +-
libgimp/gimpcontext_pdb.c | 34 ++++++++++-----------
libgimp/gimpdrawable_pdb.c | 50 +++++++++++++++----------------
libgimp/gimpdrawablecolor_pdb.c | 16 +++++-----
libgimp/gimpdynamics_pdb.c | 4 +--
libgimp/gimpedit_pdb.c | 6 ++--
libgimp/gimpfileops_pdb.c | 4 +--
libgimp/gimpfonts_pdb.c | 4 +--
libgimp/gimpgimprc_pdb.c | 12 ++++----
libgimp/gimpgradient_pdb.c | 40 ++++++++++++-------------
libgimp/gimpgradients_pdb.c | 4 +--
libgimp/gimpimage_pdb.c | 60 ++++++++++++++++++-------------------
libgimp/gimpimagecolorprofile_pdb.c | 12 ++++----
libgimp/gimpimageconvert_pdb.c | 2 +-
libgimp/gimpimagegrid_pdb.c | 12 ++++----
libgimp/gimpimagesamplepoints_pdb.c | 2 +-
libgimp/gimpimageselect_pdb.c | 2 +-
libgimp/gimpitem_pdb.c | 12 ++++----
libgimp/gimppainttools_pdb.c | 34 ++++++++++-----------
libgimp/gimppalette_pdb.c | 18 +++++------
libgimp/gimppalettes_pdb.c | 4 +--
libgimp/gimppattern_pdb.c | 16 +++++-----
libgimp/gimppatterns_pdb.c | 4 +--
libgimp/gimpplugin_pdb.c | 2 +-
libgimp/gimpproceduraldb_pdb.c | 42 +++++++++++++-------------
libgimp/gimpselection_pdb.c | 10 +++----
libgimp/gimptextlayer_pdb.c | 12 ++++----
libgimp/gimptexttool_pdb.c | 8 ++---
libgimp/gimpunit_pdb.c | 10 +++----
libgimp/gimpvectors_pdb.c | 36 +++++++++++-----------
pdb/lib.pl | 33 ++++++++++++--------
35 files changed, 284 insertions(+), 277 deletions(-)
---
diff --git a/libgimp/gimp_pdb.c b/libgimp/gimp_pdb.c
index 745a1f9346..e94ecf898e 100644
--- a/libgimp/gimp_pdb.c
+++ b/libgimp/gimp_pdb.c
@@ -46,7 +46,7 @@
* This procedure returns the version number of the currently running
* GIMP.
*
- * Returns: (transfer full) 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: (transfer full) The found parasite.
+ * Returns: (transfer full): The found parasite.
*
* Since: 2.8
**/
@@ -207,14 +207,14 @@ gimp_get_parasite (const gchar *name)
/**
* gimp_get_parasite_list:
- * @num_parasites: (out) The number of attached parasites.
+ * @num_parasites: (out): The number of attached parasites.
*
* List all parasites.
*
* Returns a list of all currently attached global parasites.
*
* Returns: (array length=num_parasites) (element-type gchar*)
- * (transfer full) The names of currently attached parasites. The
+ * (transfer full): The names of currently attached parasites. The
* returned value must be freed with g_strfreev().
*
* Since: 2.8
@@ -254,7 +254,7 @@ gimp_get_parasite_list (gint *num_parasites)
* Generates a unique filename using the temp path supplied in the
* user's gimprc.
*
- * Returns: (transfer full) The new temp filename.
+ * Returns: (transfer full): The new temp filename.
**/
gchar *
gimp_temp_name (const gchar *extension)
diff --git a/libgimp/gimpbrush_pdb.c b/libgimp/gimpbrush_pdb.c
index 6b886175ea..4a8d06a67d 100644
--- a/libgimp/gimpbrush_pdb.c
+++ b/libgimp/gimpbrush_pdb.c
@@ -42,7 +42,7 @@
*
* This procedure creates a new, uninitialized brush.
*
- * Returns: (transfer full) The actual new brush name. The returned
+ * Returns: (transfer full): The actual new brush name. The returned
* value must be freed with g_free().
*
* Since: 2.2
@@ -78,7 +78,7 @@ gimp_brush_new (const gchar *name)
*
* This procedure creates an identical brush by a different name.
*
- * Returns: (transfer full) The name of the brush's copy. The returned
+ * Returns: (transfer full): The name of the brush's copy. The returned
* value must be freed with g_free().
*
* Since: 2.2
@@ -150,7 +150,7 @@ gimp_brush_is_generated (const gchar *name)
*
* This procedure renames a brush.
*
- * Returns: (transfer full) The actual new name of the brush. The
+ * Returns: (transfer full): The actual new name of the brush. The
* returned value must be freed with g_free().
*
* Since: 2.2
@@ -253,10 +253,10 @@ gimp_brush_is_editable (const gchar *name)
/**
* gimp_brush_get_info:
* @name: The brush name.
- * @width: (out) The brush width.
- * @height: (out) The brush height.
- * @mask_bpp: (out) The brush mask bpp.
- * @color_bpp: (out) The brush color bpp.
+ * @width: (out): The brush width.
+ * @height: (out): The brush height.
+ * @mask_bpp: (out): The brush mask bpp.
+ * @color_bpp: (out): The brush color bpp.
*
* Retrieves information about the specified brush.
*
@@ -309,14 +309,14 @@ gimp_brush_get_info (const gchar *name,
/**
* gimp_brush_get_pixels:
* @name: The brush name.
- * @width: (out) The brush width.
- * @height: (out) The brush height.
- * @mask_bpp: (out) The brush mask bpp.
- * @num_mask_bytes: (out) Length of brush mask data.
- * @mask_bytes: (out) (array length=num_mask_bytes) (element-type guint8) (transfer full) The brush mask
data.
- * @color_bpp: (out) The brush color bpp.
- * @num_color_bytes: (out) Length of brush color data.
- * @color_bytes: (out) (array length=num_color_bytes) (element-type guint8) (transfer full) The brush color
data.
+ * @width: (out): The brush width.
+ * @height: (out): The brush height.
+ * @mask_bpp: (out): The brush mask bpp.
+ * @num_mask_bytes: (out): Length of brush mask data.
+ * @mask_bytes: (out) (array length=num_mask_bytes) (element-type guint8) (transfer full): The brush mask
data.
+ * @color_bpp: (out): The brush color bpp.
+ * @num_color_bytes: (out): Length of brush color data.
+ * @color_bytes: (out) (array length=num_color_bytes) (element-type guint8) (transfer full): The brush color
data.
*
* Retrieves information about the specified brush.
*
@@ -381,7 +381,7 @@ gimp_brush_get_pixels (const gchar *name,
/**
* gimp_brush_get_spacing:
* @name: The brush name.
- * @spacing: (out) The brush spacing.
+ * @spacing: (out): The brush spacing.
*
* Gets the brush spacing.
*
diff --git a/libgimp/gimpbrushes_pdb.c b/libgimp/gimpbrushes_pdb.c
index ff926e3527..dd057faee2 100644
--- a/libgimp/gimpbrushes_pdb.c
+++ b/libgimp/gimpbrushes_pdb.c
@@ -67,7 +67,7 @@ gimp_brushes_refresh (void)
/**
* gimp_brushes_get_list:
* @filter: An optional regular expression used to filter the list.
- * @num_brushes: (out) The number of brushes in the brush list.
+ * @num_brushes: (out): The number of brushes in the brush list.
*
* Retrieve a complete listing of the available brushes.
*
@@ -76,8 +76,8 @@ gimp_brushes_refresh (void)
* gimp_context_set_brush() procedure.
*
* Returns: (array length=num_brushes) (element-type gchar*) (transfer
- * full) The list of brush names. The returned value must be freed with
- * g_strfreev().
+ * full): The list of brush names. The returned value must be freed
+ * with g_strfreev().
**/
gchar **
gimp_brushes_get_list (const gchar *filter,
diff --git a/libgimp/gimpbuffer_pdb.c b/libgimp/gimpbuffer_pdb.c
index 634b2a4f5d..f08e801fab 100644
--- a/libgimp/gimpbuffer_pdb.c
+++ b/libgimp/gimpbuffer_pdb.c
@@ -37,7 +37,7 @@
/**
* gimp_buffers_get_list:
* @filter: An optional regular expression used to filter the list.
- * @num_buffers: (out) The number of buffers.
+ * @num_buffers: (out): The number of buffers.
*
* Retrieve a complete listing of the available buffers.
*
@@ -45,7 +45,7 @@
* buffers.
*
* Returns: (array length=num_buffers) (element-type gchar*) (transfer
- * full) The list of buffer names. The returned value must be freed
+ * full): The list of buffer names. The returned value must be freed
* with g_strfreev().
*
* Since: 2.4
@@ -88,7 +88,7 @@ gimp_buffers_get_list (const gchar *filter,
*
* This procedure renames a named buffer.
*
- * Returns: (transfer full) The real name given to the buffer.
+ * Returns: (transfer full): The real name given to the buffer.
*
* Since: 2.4
**/
diff --git a/libgimp/gimpchannel_pdb.c b/libgimp/gimpchannel_pdb.c
index 27a635f849..bd79075ade 100644
--- a/libgimp/gimpchannel_pdb.c
+++ b/libgimp/gimpchannel_pdb.c
@@ -369,7 +369,7 @@ gimp_channel_set_opacity (gint32 channel_ID,
/**
* gimp_channel_get_color:
* @channel_ID: The channel.
- * @color: (out) The channel compositing color.
+ * @color: (out): The channel compositing color.
*
* Get the compositing color of the specified channel.
*
diff --git a/libgimp/gimpcontext_pdb.c b/libgimp/gimpcontext_pdb.c
index 5f008e2bcd..efce813c67 100644
--- a/libgimp/gimpcontext_pdb.c
+++ b/libgimp/gimpcontext_pdb.c
@@ -138,8 +138,8 @@ gimp_context_set_defaults (void)
/**
* gimp_context_list_paint_methods:
- * @num_paint_methods: (out) The number of the available paint methods.
- * @paint_methods: (out) (array length=num_paint_methods) (element-type gchar*) (transfer full) The names of
the available paint methods.
+ * @num_paint_methods: (out): The number of the available paint methods.
+ * @paint_methods: (out) (array length=num_paint_methods) (element-type gchar*) (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: (transfer full) The name of the active paint method.
+ * Returns: (transfer full): The name of the active paint method.
*
* Since: 2.4
**/
@@ -322,7 +322,7 @@ gimp_context_set_stroke_method (GimpStrokeMethod stroke_method)
/**
* gimp_context_get_foreground:
- * @foreground: (out) The foreground color.
+ * @foreground: (out): The foreground color.
*
* Get the current GIMP foreground color.
*
@@ -395,7 +395,7 @@ gimp_context_set_foreground (const GimpRGB *foreground)
/**
* gimp_context_get_background:
- * @background: (out) The background color.
+ * @background: (out): The background color.
*
* Get the current GIMP background color.
*
@@ -1099,8 +1099,8 @@ gimp_context_set_line_dash_offset (gdouble dash_offset)
/**
* gimp_context_get_line_dash_pattern:
- * @num_dashes: (out) The number of dashes in the dash_pattern array.
- * @dashes: (out) (array length=num_dashes) (element-type gdouble) (transfer full) The line dash pattern
setting.
+ * @num_dashes: (out): The number of dashes in the dash_pattern array.
+ * @dashes: (out) (array length=num_dashes) (element-type gdouble) (transfer full): The line dash pattern
setting.
*
* Get the line dash pattern setting.
*
@@ -1143,7 +1143,7 @@ gimp_context_get_line_dash_pattern (gint *num_dashes,
/**
* gimp_context_set_line_dash_pattern:
* @num_dashes: The number of dashes in the dash_pattern array.
- * @dashes: (array length=num_dashes) (element-type gdouble) The line dash pattern setting.
+ * @dashes: (array length=num_dashes) (element-type gdouble): The line dash pattern setting.
*
* Set 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: (transfer full) 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: (transfer full) 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: (transfer full) 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: (transfer full) 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: (transfer full) The name of the active gradient.
+ * Returns: (transfer full): The name of the active gradient.
*
* Since: 2.2
**/
@@ -2383,7 +2383,7 @@ gimp_context_set_gradient_reverse (gboolean reverse)
*
* This procedure returns the name of the the currently active palette.
*
- * Returns: (transfer full) (transfer full): The name of the active
+ * Returns: (transfer full): (transfer full): The name of the active
* palette.
*
* Since: 2.2
@@ -2455,7 +2455,7 @@ gimp_context_set_palette (const gchar *name)
*
* This procedure returns the name of the currently active font.
*
- * Returns: (transfer full) The name of the active font.
+ * Returns: (transfer full): The name of the active font.
*
* Since: 2.2
**/
@@ -2672,8 +2672,8 @@ gimp_context_set_feather (gboolean feather)
/**
* gimp_context_get_feather_radius:
- * @feather_radius_x: (out) The horizontal feather radius.
- * @feather_radius_y: (out) The vertical feather radius.
+ * @feather_radius_x: (out): The horizontal feather radius.
+ * @feather_radius_y: (out): The vertical feather radius.
*
* Get the feather radius setting.
*
diff --git a/libgimp/gimpdrawable_pdb.c b/libgimp/gimpdrawable_pdb.c
index 2ccfb1b686..3665c36e7f 100644
--- a/libgimp/gimpdrawable_pdb.c
+++ b/libgimp/gimpdrawable_pdb.c
@@ -45,7 +45,7 @@
* encoding. In order to get to the real format, the libbgimp C wrapper
* must be used.
*
- * Returns: (transfer full) 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: (transfer full) The drawable's thumbnail Babl format.
+ * Returns: (transfer full): The drawable's thumbnail Babl format.
*
* Since: 2.10.14
**/
@@ -417,8 +417,8 @@ gimp_drawable_height (gint32 drawable_ID)
/**
* gimp_drawable_offsets:
* @drawable_ID: The drawable.
- * @offset_x: (out) x offset of drawable.
- * @offset_y: (out) y offset of drawable.
+ * @offset_x: (out): x offset of drawable.
+ * @offset_y: (out): y offset of drawable.
*
* Returns the offsets for the drawable.
*
@@ -464,10 +464,10 @@ gimp_drawable_offsets (gint32 drawable_ID,
/**
* gimp_drawable_mask_bounds:
* @drawable_ID: The drawable.
- * @x1: (out) x coordinate of the upper left corner of selection bounds.
- * @y1: (out) y coordinate of the upper left corner of selection bounds.
- * @x2: (out) x coordinate of the lower right corner of selection bounds.
- * @y2: (out) y coordinate of the lower right corner of selection bounds.
+ * @x1: (out): x coordinate of the upper left corner of selection bounds.
+ * @y1: (out): y coordinate of the upper left corner of selection bounds.
+ * @x2: (out): x coordinate of the lower right corner of selection bounds.
+ * @y2: (out): y coordinate of the lower right corner of selection bounds.
*
* Find the bounding box of the current selection in relation to the
* specified drawable.
@@ -523,10 +523,10 @@ gimp_drawable_mask_bounds (gint32 drawable_ID,
/**
* gimp_drawable_mask_intersect:
* @drawable_ID: The drawable.
- * @x: (out) x coordinate of the upper left corner of the intersection.
- * @y: (out) y coordinate of the upper left corner of the intersection.
- * @width: (out) width of the intersection.
- * @height: (out) height of the intersection.
+ * @x: (out): x coordinate of the upper left corner of the intersection.
+ * @y: (out): y coordinate of the upper left corner of the intersection.
+ * @width: (out): width of the intersection.
+ * @height: (out): height of the intersection.
*
* Find the bounding box of the current selection in relation to the
* specified drawable.
@@ -706,7 +706,7 @@ gimp_drawable_update (gint32 drawable_ID,
* @drawable_ID: The drawable.
* @x_coord: The x coordinate.
* @y_coord: The y coordinate.
- * @num_channels: (out) The number of channels for the pixel.
+ * @num_channels: (out): The number of channels for the pixel.
*
* Gets the value of the pixel at the specified coordinates.
*
@@ -715,7 +715,7 @@ gimp_drawable_update (gint32 drawable_ID,
* bytes-per-pixel value for the specified drawable.
*
* Returns: (array length=num_channels) (element-type guint8) (transfer
- * full) The pixel value.
+ * full): The pixel value.
**/
guint8 *
gimp_drawable_get_pixel (gint32 drawable_ID,
@@ -758,7 +758,7 @@ gimp_drawable_get_pixel (gint32 drawable_ID,
* @x_coord: The x coordinate.
* @y_coord: The y coordinate.
* @num_channels: The number of channels for the pixel.
- * @pixel: (array length=num_channels) (element-type guint8) The pixel value.
+ * @pixel: (array length=num_channels) (element-type guint8): The pixel value.
*
* Sets the value of the pixel at the specified coordinates.
*
@@ -909,11 +909,11 @@ gimp_drawable_offset (gint32 drawable_ID,
* @drawable_ID: The drawable.
* @width: The requested thumbnail width.
* @height: The requested thumbnail height.
- * @actual_width: (out) The previews width.
- * @actual_height: (out) The previews height.
- * @bpp: (out) The previews bpp.
- * @thumbnail_data_count: (out) The number of bytes in thumbnail data.
- * @thumbnail_data: (out) (array length=thumbnail_data_count) (element-type guint8) (transfer full) The
thumbnail data.
+ * @actual_width: (out): The previews width.
+ * @actual_height: (out): The previews height.
+ * @bpp: (out): The previews bpp.
+ * @thumbnail_data_count: (out): The number of bytes in thumbnail data.
+ * @thumbnail_data: (out) (array length=thumbnail_data_count) (element-type guint8) (transfer full): The
thumbnail data.
*
* Get a thumbnail of a drawable.
*
@@ -981,11 +981,11 @@ _gimp_drawable_thumbnail (gint32 drawable_ID,
* @src_height: The height of the area.
* @dest_width: The thumbnail width.
* @dest_height: The thumbnail height.
- * @width: (out) The previews width.
- * @height: (out) The previews height.
- * @bpp: (out) The previews bpp.
- * @thumbnail_data_count: (out) The number of bytes in thumbnail data.
- * @thumbnail_data: (out) (array length=thumbnail_data_count) (element-type guint8) (transfer full) The
thumbnail data.
+ * @width: (out): The previews width.
+ * @height: (out): The previews height.
+ * @bpp: (out): The previews bpp.
+ * @thumbnail_data_count: (out): The number of bytes in thumbnail data.
+ * @thumbnail_data: (out) (array length=thumbnail_data_count) (element-type guint8) (transfer full): The
thumbnail data.
*
* Get a thumbnail of a sub-area of a drawable drawable.
*
diff --git a/libgimp/gimpdrawablecolor_pdb.c b/libgimp/gimpdrawablecolor_pdb.c
index 257a90b014..f9604682e6 100644
--- a/libgimp/gimpdrawablecolor_pdb.c
+++ b/libgimp/gimpdrawablecolor_pdb.c
@@ -194,7 +194,7 @@ gimp_drawable_colorize_hsl (gint32 drawable_ID,
* @drawable_ID: The drawable.
* @channel: The channel to modify.
* @num_values: The number of values in the new curve.
- * @values: (array length=num_values) (element-type gdouble) The explicit curve.
+ * @values: (array length=num_values) (element-type gdouble): The explicit curve.
*
* Modifies the intensity curve(s) for specified drawable.
*
@@ -245,7 +245,7 @@ gimp_drawable_curves_explicit (gint32 drawable_ID,
* @drawable_ID: The drawable.
* @channel: The channel to modify.
* @num_points: The number of values in the control point array.
- * @points: (array length=num_points) (element-type gdouble) The spline control points: { cp1.x, cp1.y,
cp2.x, cp2.y, ... }.
+ * @points: (array length=num_points) (element-type gdouble): The spline control points: { cp1.x, cp1.y,
cp2.x, cp2.y, ... }.
*
* Modifies the intensity curve(s) for specified drawable.
*
@@ -382,12 +382,12 @@ gimp_drawable_equalize (gint32 drawable_ID,
* @channel: The channel to query.
* @start_range: Start of the intensity measurement range.
* @end_range: End of the intensity measurement range.
- * @mean: (out) Mean intensity value.
- * @std_dev: (out) Standard deviation of intensity values.
- * @median: (out) Median intensity value.
- * @pixels: (out) Alpha-weighted pixel count for entire image.
- * @count: (out) Alpha-weighted pixel count for range.
- * @percentile: (out) Percentile that range falls under.
+ * @mean: (out): Mean intensity value.
+ * @std_dev: (out): Standard deviation of intensity values.
+ * @median: (out): Median intensity value.
+ * @pixels: (out): Alpha-weighted pixel count for entire image.
+ * @count: (out): Alpha-weighted pixel count for range.
+ * @percentile: (out): Percentile that range falls under.
*
* Returns information on the intensity histogram for the specified
* drawable.
diff --git a/libgimp/gimpdynamics_pdb.c b/libgimp/gimpdynamics_pdb.c
index 4e8b74f592..085c94078c 100644
--- a/libgimp/gimpdynamics_pdb.c
+++ b/libgimp/gimpdynamics_pdb.c
@@ -70,7 +70,7 @@ gimp_dynamics_refresh (void)
/**
* gimp_dynamics_get_list:
* @filter: An optional regular expression used to filter the list.
- * @num_dynamics: (out) The number of available paint dynamics.
+ * @num_dynamics: (out): The number of available paint dynamics.
*
* Retrieve the list of loaded paint dynamics.
*
@@ -78,7 +78,7 @@ gimp_dynamics_refresh (void)
* currently available.
*
* Returns: (array length=num_dynamics) (element-type gchar*) (transfer
- * full) The list of paint dynamics names. The returned value must be
+ * full): The list of paint dynamics names. The returned value must be
* freed with g_strfreev().
*
* Since: 2.8
diff --git a/libgimp/gimpedit_pdb.c b/libgimp/gimpedit_pdb.c
index 511a37fe26..c609d7b6f6 100644
--- a/libgimp/gimpedit_pdb.c
+++ b/libgimp/gimpedit_pdb.c
@@ -254,7 +254,7 @@ gimp_edit_paste_as_new_image (void)
* later pasting, regardless of any intermediate copy or cut
* operations.
*
- * Returns: (transfer full) The real name given to the buffer, or NULL
+ * Returns: (transfer full): The real name given to the buffer, or NULL
* if the cut failed.
*
* Since: 2.4
@@ -297,7 +297,7 @@ gimp_edit_named_cut (gint32 drawable_ID,
* later pasting, regardless of any intermediate copy or cut
* operations.
*
- * Returns: (transfer full) The real name given to the buffer, or NULL
+ * Returns: (transfer full): The real name given to the buffer, or NULL
* if the copy failed.
*
* Since: 2.4
@@ -340,7 +340,7 @@ gimp_edit_named_copy (gint32 drawable_ID,
* available for later pasting, regardless of any intermediate copy or
* cut operations.
*
- * Returns: (transfer full) The real name given to the buffer, or NULL
+ * Returns: (transfer full): The real name given to the buffer, or NULL
* if the copy failed.
*
* Since: 2.4
diff --git a/libgimp/gimpfileops_pdb.c b/libgimp/gimpfileops_pdb.c
index 7babac6494..6eabf7e394 100644
--- a/libgimp/gimpfileops_pdb.c
+++ b/libgimp/gimpfileops_pdb.c
@@ -132,7 +132,7 @@ gimp_file_load_layer (GimpRunMode run_mode,
* @run_mode: The run mode.
* @image_ID: Destination image.
* @filename: The name of the file to load.
- * @num_layers: (out) The number of loaded layers.
+ * @num_layers: (out): The number of loaded layers.
*
* Loads an image file as layers for an existing image.
*
@@ -142,7 +142,7 @@ gimp_file_load_layer (GimpRunMode run_mode,
* gimp_image_insert_layer().
*
* Returns: (array length=num_layers) (element-type gint32) (transfer
- * full) The list of loaded layers.
+ * full): The list of loaded layers.
*
* Since: 2.4
**/
diff --git a/libgimp/gimpfonts_pdb.c b/libgimp/gimpfonts_pdb.c
index 5301d15536..bdab1bad35 100644
--- a/libgimp/gimpfonts_pdb.c
+++ b/libgimp/gimpfonts_pdb.c
@@ -68,7 +68,7 @@ gimp_fonts_refresh (void)
/**
* gimp_fonts_get_list:
* @filter: An optional regular expression used to filter the list.
- * @num_fonts: (out) The number of available fonts.
+ * @num_fonts: (out): The number of available fonts.
*
* Retrieve the list of loaded fonts.
*
@@ -76,7 +76,7 @@ gimp_fonts_refresh (void)
* available.
*
* Returns: (array length=num_fonts) (element-type gchar*) (transfer
- * full) The list of font names. The returned value must be freed with
+ * full): The list of font names. The returned value must be freed with
* g_strfreev().
**/
gchar **
diff --git a/libgimp/gimpgimprc_pdb.c b/libgimp/gimpgimprc_pdb.c
index 2b7e5366cd..439e54c8e0 100644
--- a/libgimp/gimpgimprc_pdb.c
+++ b/libgimp/gimpgimprc_pdb.c
@@ -50,7 +50,7 @@
* string. Entries not corresponding to this format will cause warnings
* to be issued on gimprc parsing and will not be queryable.
*
- * Returns: (transfer full) The value associated with the queried
+ * Returns: (transfer full): The value associated with the queried
* token.
**/
gchar *
@@ -123,7 +123,7 @@ gimp_gimprc_set (const gchar *token,
*
* Returns a copy of the default image comment.
*
- * Returns: (transfer full) Default image comment.
+ * Returns: (transfer full): Default image comment.
**/
gchar *
gimp_get_default_comment (void)
@@ -180,8 +180,8 @@ gimp_get_default_unit (void)
/**
* gimp_get_monitor_resolution:
- * @xres: (out) X resolution.
- * @yres: (out) Y resolution.
+ * @xres: (out): X resolution.
+ * @yres: (out): Y resolution.
*
* Get the monitor resolution as specified in the Preferences.
*
@@ -230,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: (transfer full) Serialized color management configuration.
+ * Returns: (transfer full): Serialized color management configuration.
*
* Since: 2.4
**/
@@ -262,7 +262,7 @@ _gimp_get_color_configuration (void)
*
* Returns a copy of the list of modules which should not be loaded.
*
- * Returns: (transfer full) The list of modules.
+ * Returns: (transfer full): The list of modules.
**/
gchar *
gimp_get_module_load_inhibit (void)
diff --git a/libgimp/gimpgradient_pdb.c b/libgimp/gimpgradient_pdb.c
index dbd10a5e1c..d98bf58186 100644
--- a/libgimp/gimpgradient_pdb.c
+++ b/libgimp/gimpgradient_pdb.c
@@ -42,7 +42,7 @@
*
* This procedure creates a new, uninitialized gradient
*
- * Returns: (transfer full) 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: (transfer full) 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: (transfer full) The actual new name of the gradient.
+ * Returns: (transfer full): The actual new name of the gradient.
*
* Since: 2.2
**/
@@ -253,8 +253,8 @@ gimp_gradient_get_number_of_segments (const gchar *name)
* @name: The gradient name.
* @num_samples: The number of samples to take.
* @reverse: Use the reverse gradient.
- * @num_color_samples: (out) Length of the color_samples array (4 * num_samples).
- * @color_samples: (out) (array length=num_color_samples) (element-type gdouble) (transfer full) Color
samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
+ * @num_color_samples: (out): Length of the color_samples array (4 * num_samples).
+ * @color_samples: (out) (array length=num_color_samples) (element-type gdouble) (transfer full): Color
samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
*
* Sample the specified in uniform parts.
*
@@ -313,10 +313,10 @@ gimp_gradient_get_uniform_samples (const gchar *name,
* gimp_gradient_get_custom_samples:
* @name: The gradient name.
* @num_samples: The number of samples to take.
- * @positions: (array length=num_samples) (element-type gdouble) The list of positions to sample along the
gradient.
+ * @positions: (array length=num_samples) (element-type gdouble): The list of positions to sample along the
gradient.
* @reverse: Use the reverse gradient.
- * @num_color_samples: (out) Length of the color_samples array (4 * num_samples).
- * @color_samples: (out) (array length=num_color_samples) (element-type gdouble) (transfer full) Color
samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
+ * @num_color_samples: (out): Length of the color_samples array (4 * num_samples).
+ * @color_samples: (out) (array length=num_color_samples) (element-type gdouble) (transfer full): Color
samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
*
* Sample the specified gradient in custom positions.
*
@@ -377,8 +377,8 @@ gimp_gradient_get_custom_samples (const gchar *name,
* gimp_gradient_segment_get_left_color:
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
- * @color: (out) The return color.
- * @opacity: (out) The opacity of the endpoint.
+ * @color: (out): The return color.
+ * @opacity: (out): The opacity of the endpoint.
*
* Retrieves the left endpoint color of the specified segment
*
@@ -475,8 +475,8 @@ gimp_gradient_segment_set_left_color (const gchar *name,
* gimp_gradient_segment_get_right_color:
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
- * @color: (out) The return color.
- * @opacity: (out) The opacity of the endpoint.
+ * @color: (out): The return color.
+ * @opacity: (out): The opacity of the endpoint.
*
* Retrieves the right endpoint color of the specified segment
*
@@ -573,7 +573,7 @@ gimp_gradient_segment_set_right_color (const gchar *name,
* gimp_gradient_segment_get_left_pos:
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
- * @pos: (out) The return position.
+ * @pos: (out): The return position.
*
* Retrieves the left endpoint position of the specified segment
*
@@ -620,7 +620,7 @@ gimp_gradient_segment_get_left_pos (const gchar *name,
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
* @pos: The position to set the guidepoint to.
- * @final_pos: (out) The return position.
+ * @final_pos: (out): The return position.
*
* Sets the left endpoint position of the specified segment
*
@@ -672,7 +672,7 @@ gimp_gradient_segment_set_left_pos (const gchar *name,
* gimp_gradient_segment_get_middle_pos:
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
- * @pos: (out) The return position.
+ * @pos: (out): The return position.
*
* Retrieves the middle point position of the specified segment
*
@@ -719,7 +719,7 @@ gimp_gradient_segment_get_middle_pos (const gchar *name,
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
* @pos: The position to set the guidepoint to.
- * @final_pos: (out) The return position.
+ * @final_pos: (out): The return position.
*
* Sets the middle point position of the specified segment
*
@@ -770,7 +770,7 @@ gimp_gradient_segment_set_middle_pos (const gchar *name,
* gimp_gradient_segment_get_right_pos:
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
- * @pos: (out) The return position.
+ * @pos: (out): The return position.
*
* Retrieves the right endpoint position of the specified segment
*
@@ -817,7 +817,7 @@ gimp_gradient_segment_get_right_pos (const gchar *name,
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
* @pos: The position to set the guidepoint to.
- * @final_pos: (out) The return position.
+ * @final_pos: (out): The return position.
*
* Sets the right endpoint position of the specified segment
*
@@ -869,7 +869,7 @@ gimp_gradient_segment_set_right_pos (const gchar *name,
* gimp_gradient_segment_get_blending_function:
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
- * @blend_func: (out) The blending function of the segment.
+ * @blend_func: (out): The blending function of the segment.
*
* Retrieves the gradient segment's blending function
*
@@ -915,7 +915,7 @@ gimp_gradient_segment_get_blending_function (const gchar *name,
* gimp_gradient_segment_get_coloring_type:
* @name: The gradient name.
* @segment: The index of the segment within the gradient.
- * @coloring_type: (out) The coloring type of the segment.
+ * @coloring_type: (out): The coloring type of the segment.
*
* Retrieves the gradient segment's coloring type
*
diff --git a/libgimp/gimpgradients_pdb.c b/libgimp/gimpgradients_pdb.c
index ce0007ac81..8de5b756e6 100644
--- a/libgimp/gimpgradients_pdb.c
+++ b/libgimp/gimpgradients_pdb.c
@@ -67,7 +67,7 @@ gimp_gradients_refresh (void)
/**
* gimp_gradients_get_list:
* @filter: An optional regular expression used to filter the list.
- * @num_gradients: (out) The number of loaded gradients.
+ * @num_gradients: (out): The number of loaded gradients.
*
* Retrieve the list of loaded gradients.
*
@@ -76,7 +76,7 @@ gimp_gradients_refresh (void)
* to set the active gradient.
*
* Returns: (array length=num_gradients) (element-type gchar*)
- * (transfer full) The list of gradient names. The returned value must
+ * (transfer full): The list of gradient names. The returned value must
* be freed with g_strfreev().
**/
gchar **
diff --git a/libgimp/gimpimage_pdb.c b/libgimp/gimpimage_pdb.c
index f3ffd31a8c..88b1da18b4 100644
--- a/libgimp/gimpimage_pdb.c
+++ b/libgimp/gimpimage_pdb.c
@@ -73,14 +73,14 @@ gimp_image_is_valid (gint32 image_ID)
/**
* gimp_image_list:
- * @num_images: (out) The number of images currently open.
+ * @num_images: (out): The number of images currently open.
*
* Returns the list of images currently open.
*
* This procedure returns the list of images currently open in GIMP.
*
* Returns: (array length=num_images) (element-type gint32) (transfer
- * full) The list of images currently open. The returned value must be
+ * full): The list of images currently open. The returned value must be
* freed with g_free().
**/
gint *
@@ -456,7 +456,7 @@ gimp_image_height (gint32 image_ID)
/**
* gimp_image_get_layers:
* @image_ID: The image.
- * @num_layers: (out) The number of layers contained in the image.
+ * @num_layers: (out): The number of layers contained in the image.
*
* Returns the list of layers contained in the specified image.
*
@@ -464,7 +464,7 @@ gimp_image_height (gint32 image_ID)
* image. The order of layers is from topmost to bottommost.
*
* Returns: (array length=num_layers) (element-type gint32) (transfer
- * full) The list of layers contained in the image. The returned value
+ * full): The list of layers contained in the image. The returned value
* must be freed with g_free().
**/
gint *
@@ -499,7 +499,7 @@ gimp_image_get_layers (gint32 image_ID,
/**
* gimp_image_get_channels:
* @image_ID: The image.
- * @num_channels: (out) The number of channels contained in the image.
+ * @num_channels: (out): The number of channels contained in the image.
*
* Returns the list of channels contained in the specified image.
*
@@ -510,7 +510,7 @@ gimp_image_get_layers (gint32 image_ID,
* color components.
*
* Returns: (array length=num_channels) (element-type gint32) (transfer
- * full) The list of channels contained in the image. The returned
+ * full): The list of channels contained in the image. The returned
* value must be freed with g_free().
**/
gint *
@@ -545,7 +545,7 @@ gimp_image_get_channels (gint32 image_ID,
/**
* gimp_image_get_vectors:
* @image_ID: The image.
- * @num_vectors: (out) The number of vectors contained in the image.
+ * @num_vectors: (out): The number of vectors contained in the image.
*
* Returns the list of vectors contained in the specified image.
*
@@ -553,8 +553,8 @@ gimp_image_get_channels (gint32 image_ID,
* specified image.
*
* Returns: (array length=num_vectors) (element-type gint32) (transfer
- * full) The list of vectors contained in the image. The returned value
- * must be freed with g_free().
+ * full): The list of vectors contained in the image. The returned
+ * value must be freed with g_free().
*
* Since: 2.4
**/
@@ -738,7 +738,7 @@ gimp_image_floating_sel_attached_to (gint32 image_ID)
* @sample_merged: Use the composite image, not the drawable.
* @sample_average: Average the color of all the pixels in a specified radius.
* @average_radius: The radius of pixels to average.
- * @color: (out) The return color.
+ * @color: (out): The return color.
*
* Determine the color at the given drawable coordinates
*
@@ -1722,7 +1722,7 @@ gimp_image_merge_down (gint32 image_ID,
/**
* _gimp_image_get_colormap:
* @image_ID: The image.
- * @num_bytes: (out) Number of bytes in the colormap array.
+ * @num_bytes: (out): Number of bytes in the colormap array.
*
* Returns the image's colormap
*
@@ -1733,7 +1733,7 @@ gimp_image_merge_down (gint32 image_ID,
* returned.
*
* Returns: (array length=num_bytes) (element-type guint8) (transfer
- * full) The image's colormap. The returned value must be freed with
+ * full): The image's colormap. The returned value must be freed with
* g_free().
**/
guint8 *
@@ -1769,7 +1769,7 @@ _gimp_image_get_colormap (gint32 image_ID,
* _gimp_image_set_colormap:
* @image_ID: The image.
* @num_bytes: Number of bytes in the colormap array.
- * @colormap: (array length=num_bytes) (element-type guint8) The new colormap values.
+ * @colormap: (array length=num_bytes) (element-type guint8): The new colormap values.
*
* Sets the entries in the image's colormap.
*
@@ -1817,7 +1817,7 @@ _gimp_image_set_colormap (gint32 image_ID,
*
* Returns exif/iptc/xmp metadata from the image.
*
- * Returns: (transfer full) 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)
@@ -1956,11 +1956,11 @@ gimp_image_is_dirty (gint32 image_ID)
* @image_ID: The image.
* @width: The requested thumbnail width.
* @height: The requested thumbnail height.
- * @actual_width: (out) The previews width.
- * @actual_height: (out) The previews height.
- * @bpp: (out) The previews bpp.
- * @thumbnail_data_count: (out) The number of bytes in thumbnail data.
- * @thumbnail_data: (out) (array length=thumbnail_data_count) (element-type guint8) (transfer full) The
thumbnail data.
+ * @actual_width: (out): The previews width.
+ * @actual_height: (out): The previews height.
+ * @bpp: (out): The previews bpp.
+ * @thumbnail_data_count: (out): The number of bytes in thumbnail data.
+ * @thumbnail_data: (out) (array length=thumbnail_data_count) (element-type guint8) (transfer full): The
thumbnail data.
*
* Get a thumbnail of an image.
*
@@ -2448,7 +2448,7 @@ gimp_image_set_component_visible (gint32 image_ID,
* Otherwise, this function returns %NULL. See also
* gimp_image_get_uri().
*
- * Returns: (transfer full) The filename. The returned value must be
+ * Returns: (transfer full): The filename. The returned value must be
* freed with g_free().
**/
gchar *
@@ -2525,7 +2525,7 @@ 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: (transfer full) The URI. The returned value must be freed
+ * Returns: (transfer full): The URI. The returned value must be freed
* with g_free().
*
* Since: 2.8
@@ -2562,7 +2562,7 @@ 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: (transfer full) The imported URI. The returned value must
+ * Returns: (transfer full): The imported URI. The returned value must
* be freed with g_free().
*
* Since: 2.8
@@ -2601,7 +2601,7 @@ 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: (transfer full) The imported URI. The returned value must
+ * Returns: (transfer full): The imported URI. The returned value must
* be freed with g_free().
*
* Since: 2.8
@@ -2639,7 +2639,7 @@ 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: (transfer full) The exported URI. The returned value must
+ * Returns: (transfer full): The exported URI. The returned value must
* be freed with g_free().
*
* Since: 2.8
@@ -2681,7 +2681,7 @@ 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: (transfer full) The name. The returned value must be freed
+ * Returns: (transfer full): The name. The returned value must be freed
* with g_free().
**/
gchar *
@@ -2710,8 +2710,8 @@ gimp_image_get_name (gint32 image_ID)
/**
* gimp_image_get_resolution:
* @image_ID: The image.
- * @xresolution: (out) The resolution in the x-axis, in dots per inch.
- * @yresolution: (out) The resolution in the y-axis, in dots per inch.
+ * @xresolution: (out): The resolution in the x-axis, in dots per inch.
+ * @yresolution: (out): The resolution in the y-axis, in dots per inch.
*
* Returns the specified image's resolution.
*
@@ -3277,7 +3277,7 @@ gimp_image_detach_parasite (gint32 image_ID,
* Finds and returns the parasite that was previously attached to an
* image.
*
- * Returns: (transfer full) The found parasite.
+ * Returns: (transfer full): The found parasite.
*
* Since: 2.8
**/
@@ -3310,14 +3310,14 @@ gimp_image_get_parasite (gint32 image_ID,
/**
* gimp_image_get_parasite_list:
* @image_ID: The image.
- * @num_parasites: (out) The number of attached parasites.
+ * @num_parasites: (out): The number of attached parasites.
*
* List all parasites.
*
* Returns a list of all currently attached parasites.
*
* Returns: (array length=num_parasites) (element-type gchar*)
- * (transfer full) The names of currently attached parasites. The
+ * (transfer full): The names of currently attached parasites. The
* returned value must be freed with g_strfreev().
*
* Since: 2.8
diff --git a/libgimp/gimpimagecolorprofile_pdb.c b/libgimp/gimpimagecolorprofile_pdb.c
index 109f12ed8b..1024de0a48 100644
--- a/libgimp/gimpimagecolorprofile_pdb.c
+++ b/libgimp/gimpimagecolorprofile_pdb.c
@@ -37,7 +37,7 @@
/**
* _gimp_image_get_color_profile:
* @image_ID: The image.
- * @num_bytes: (out) Number of bytes in the color_profile array.
+ * @num_bytes: (out): Number of bytes in the color_profile array.
*
* Returns the image's color profile
*
@@ -45,7 +45,7 @@
* image has no color profile assigned.
*
* Returns: (array length=num_bytes) (element-type guint8) (transfer
- * full) The image's serialized color profile. The returned value must
+ * full): The image's serialized color profile. The returned value must
* be freed with g_free().
*
* Since: 2.10
@@ -82,7 +82,7 @@ _gimp_image_get_color_profile (gint32 image_ID,
/**
* _gimp_image_get_effective_color_profile:
* @image_ID: The image.
- * @num_bytes: (out) Number of bytes in the color_profile array.
+ * @num_bytes: (out): Number of bytes in the color_profile array.
*
* Returns the color profile that is used for the image
*
@@ -93,7 +93,7 @@ _gimp_image_get_color_profile (gint32 image_ID,
* image's type.
*
* Returns: (array length=num_bytes) (element-type guint8) (transfer
- * full) The image's serialized color profile. The returned value must
+ * full): The image's serialized color profile. The returned value must
* be freed with g_free().
*
* Since: 2.10
@@ -131,7 +131,7 @@ _gimp_image_get_effective_color_profile (gint32 image_ID,
* _gimp_image_set_color_profile:
* @image_ID: The image.
* @num_bytes: Number of bytes in the color_profile array.
- * @color_profile: (array length=num_bytes) (element-type guint8) The new serialized color profile.
+ * @color_profile: (array length=num_bytes) (element-type guint8): The new serialized color profile.
*
* Sets the image's color profile
*
@@ -220,7 +220,7 @@ gimp_image_set_color_profile_from_file (gint32 image_ID,
* _gimp_image_convert_color_profile:
* @image_ID: The image.
* @num_bytes: Number of bytes in the color_profile array.
- * @color_profile: (array length=num_bytes) (element-type guint8) The serialized color profile.
+ * @color_profile: (array length=num_bytes) (element-type guint8): The serialized color profile.
* @intent: Rendering intent.
* @bpc: Black point compensation.
*
diff --git a/libgimp/gimpimageconvert_pdb.c b/libgimp/gimpimageconvert_pdb.c
index ba209c7821..7e27889c03 100644
--- a/libgimp/gimpimageconvert_pdb.c
+++ b/libgimp/gimpimageconvert_pdb.c
@@ -175,7 +175,7 @@ gimp_image_convert_indexed (gint32 image_ID,
* @width: Width of the matrix (0 to reset to default matrix).
* @height: Height of the matrix (0 to reset to default matrix).
* @matrix_length: The length of 'matrix'.
- * @matrix: (array length=matrix_length) (element-type guint8) The matrix -- all values must be >= 1.
+ * @matrix: (array length=matrix_length) (element-type guint8): The matrix -- all values must be >= 1.
*
* Set dither matrix for conversion to indexed
*
diff --git a/libgimp/gimpimagegrid_pdb.c b/libgimp/gimpimagegrid_pdb.c
index 6990beb5c1..d64c7384e4 100644
--- a/libgimp/gimpimagegrid_pdb.c
+++ b/libgimp/gimpimagegrid_pdb.c
@@ -37,8 +37,8 @@
/**
* gimp_image_grid_get_spacing:
* @image_ID: The image.
- * @xspacing: (out) The image's grid horizontal spacing.
- * @yspacing: (out) The image's grid vertical spacing.
+ * @xspacing: (out): The image's grid horizontal spacing.
+ * @yspacing: (out): The image's grid vertical spacing.
*
* Gets the spacing of an image's grid.
*
@@ -128,8 +128,8 @@ gimp_image_grid_set_spacing (gint32 image_ID,
/**
* gimp_image_grid_get_offset:
* @image_ID: The image.
- * @xoffset: (out) The image's grid horizontal offset.
- * @yoffset: (out) The image's grid vertical offset.
+ * @xoffset: (out): The image's grid horizontal offset.
+ * @yoffset: (out): The image's grid vertical offset.
*
* Gets the offset of an image's grid.
*
@@ -219,7 +219,7 @@ gimp_image_grid_set_offset (gint32 image_ID,
/**
* gimp_image_grid_get_foreground_color:
* @image_ID: The image.
- * @fgcolor: (out) The image's grid foreground color.
+ * @fgcolor: (out): The image's grid foreground color.
*
* Sets the foreground color of an image's grid.
*
@@ -296,7 +296,7 @@ gimp_image_grid_set_foreground_color (gint32 image_ID,
/**
* gimp_image_grid_get_background_color:
* @image_ID: The image.
- * @bgcolor: (out) The image's grid background color.
+ * @bgcolor: (out): The image's grid background color.
*
* Sets the background color of an image's grid.
*
diff --git a/libgimp/gimpimagesamplepoints_pdb.c b/libgimp/gimpimagesamplepoints_pdb.c
index ec54dc9880..132dc93a5b 100644
--- a/libgimp/gimpimagesamplepoints_pdb.c
+++ b/libgimp/gimpimagesamplepoints_pdb.c
@@ -166,7 +166,7 @@ gimp_image_find_next_sample_point (gint32 image_ID,
* gimp_image_get_sample_point_position:
* @image_ID: The image.
* @sample_point_ID: The guide.
- * @position_y: (out) The sample points's position relative to top of image.
+ * @position_y: (out): The sample points's position relative to top of image.
*
* Get position of a sample point on an image.
*
diff --git a/libgimp/gimpimageselect_pdb.c b/libgimp/gimpimageselect_pdb.c
index 2383a300cd..0ae9966ee4 100644
--- a/libgimp/gimpimageselect_pdb.c
+++ b/libgimp/gimpimageselect_pdb.c
@@ -365,7 +365,7 @@ gimp_image_select_ellipse (gint32 image_ID,
* @image_ID: The image.
* @operation: The selection operation.
* @num_segs: Number of points (count 1 coordinate as two points).
- * @segs: (array length=num_segs) (element-type gdouble) Array of points: { p1.x, p1.y, p2.x, p2.y, ...,
pn.x, pn.y}.
+ * @segs: (array length=num_segs) (element-type gdouble): Array of points: { p1.x, p1.y, p2.x, p2.y, ...,
pn.x, pn.y}.
*
* Create a polygonal selection over the specified image.
*
diff --git a/libgimp/gimpitem_pdb.c b/libgimp/gimpitem_pdb.c
index 2ef869c639..82ba0f571a 100644
--- a/libgimp/gimpitem_pdb.c
+++ b/libgimp/gimpitem_pdb.c
@@ -462,7 +462,7 @@ gimp_item_get_parent (gint32 item_ID)
/**
* gimp_item_get_children:
* @item_ID: The item.
- * @num_children: (out) The item's number of children.
+ * @num_children: (out): The item's number of children.
*
* Returns the item's list of children.
*
@@ -470,7 +470,7 @@ gimp_item_get_parent (gint32 item_ID)
* specified item. The order is topmost to bottommost.
*
* Returns: (array length=num_children) (element-type gint32) (transfer
- * full) The item's list of children.
+ * full): The item's list of children.
*
* Since: 2.8
**/
@@ -584,7 +584,7 @@ gimp_item_set_expanded (gint32 item_ID,
*
* This procedure returns the specified item's name.
*
- * Returns: (transfer full) The item name.
+ * Returns: (transfer full): The item name.
*
* Since: 2.8
**/
@@ -1178,7 +1178,7 @@ gimp_item_detach_parasite (gint32 item_ID,
*
* Finds and returns the parasite that is attached to an item.
*
- * Returns: (transfer full) The found parasite.
+ * Returns: (transfer full): The found parasite.
*
* Since: 2.8
**/
@@ -1211,14 +1211,14 @@ gimp_item_get_parasite (gint32 item_ID,
/**
* gimp_item_get_parasite_list:
* @item_ID: The item.
- * @num_parasites: (out) The number of attached parasites.
+ * @num_parasites: (out): The number of attached parasites.
*
* List all parasites.
*
* Returns a list of all parasites currently attached the an item.
*
* Returns: (array length=num_parasites) (element-type gchar*)
- * (transfer full) The names of currently attached parasites. The
+ * (transfer full): The names of currently attached parasites. The
* returned value must be freed with g_strfreev().
*
* Since: 2.8
diff --git a/libgimp/gimppainttools_pdb.c b/libgimp/gimppainttools_pdb.c
index 36320645d6..82cc77f667 100644
--- a/libgimp/gimppainttools_pdb.c
+++ b/libgimp/gimppainttools_pdb.c
@@ -39,7 +39,7 @@
* @drawable_ID: The affected drawable.
* @pressure: The pressure of the airbrush strokes.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Paint in the current brush with varying pressure. Paint application
* is time-dependent.
@@ -86,7 +86,7 @@ gimp_airbrush (gint32 drawable_ID,
* gimp_airbrush_default:
* @drawable_ID: The affected drawable.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Paint in the current brush with varying pressure. Paint application
* is time-dependent.
@@ -134,7 +134,7 @@ gimp_airbrush_default (gint32 drawable_ID,
* @src_x: The x coordinate in the source image.
* @src_y: The y coordinate in the source image.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Clone from the source to the dest drawable using the current brush
*
@@ -197,7 +197,7 @@ gimp_clone (gint32 drawable_ID,
* gimp_clone_default:
* @drawable_ID: The affected drawable.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Clone from the source to the dest drawable using the current brush
*
@@ -244,7 +244,7 @@ gimp_clone_default (gint32 drawable_ID,
* @pressure: The pressure.
* @convolve_type: Convolve type.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Convolve (Blur, Sharpen) using the current brush.
*
@@ -293,7 +293,7 @@ gimp_convolve (gint32 drawable_ID,
* gimp_convolve_default:
* @drawable_ID: The affected drawable.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Convolve (Blur, Sharpen) using the current brush.
*
@@ -340,7 +340,7 @@ gimp_convolve_default (gint32 drawable_ID,
* @dodgeburn_type: The type either dodge or burn.
* @dodgeburn_mode: The mode.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Dodgeburn image with varying exposure.
*
@@ -389,7 +389,7 @@ gimp_dodgeburn (gint32 drawable_ID,
* gimp_dodgeburn_default:
* @drawable_ID: The affected drawable.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Dodgeburn image with varying exposure. This is the same as the
* gimp_dodgeburn() function except that the exposure, type and mode
@@ -432,7 +432,7 @@ gimp_dodgeburn_default (gint32 drawable_ID,
* gimp_eraser:
* @drawable_ID: The affected drawable.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
* @hardness: How to apply the brush.
* @method: The paint method to use.
*
@@ -484,7 +484,7 @@ gimp_eraser (gint32 drawable_ID,
* gimp_eraser_default:
* @drawable_ID: The affected drawable.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Erase using the current brush.
*
@@ -531,7 +531,7 @@ gimp_eraser_default (gint32 drawable_ID,
* @src_x: The x coordinate in the source image.
* @src_y: The y coordinate in the source image.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Heal from the source to the dest drawable using the current brush
*
@@ -587,7 +587,7 @@ gimp_heal (gint32 drawable_ID,
* gimp_heal_default:
* @drawable_ID: The affected drawable.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Heal from the source to the dest drawable using the current brush
*
@@ -635,7 +635,7 @@ gimp_heal_default (gint32 drawable_ID,
* @drawable_ID: The affected drawable.
* @fade_out: Fade out parameter.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
* @method: The paint method to use.
* @gradient_length: Length of gradient to draw.
*
@@ -695,7 +695,7 @@ gimp_paintbrush (gint32 drawable_ID,
* gimp_paintbrush_default:
* @drawable_ID: The affected drawable.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Paint in the current brush. The fade out parameter and pull colors
* from a gradient parameter are set from the paintbrush options
@@ -748,7 +748,7 @@ gimp_paintbrush_default (gint32 drawable_ID,
* gimp_pencil:
* @drawable_ID: The affected drawable.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Paint in the current brush without sub-pixel sampling.
*
@@ -794,7 +794,7 @@ gimp_pencil (gint32 drawable_ID,
* @drawable_ID: The affected drawable.
* @pressure: The pressure of the smudge strokes.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Smudge image with varying pressure.
*
@@ -839,7 +839,7 @@ gimp_smudge (gint32 drawable_ID,
* gimp_smudge_default:
* @drawable_ID: The affected drawable.
* @num_strokes: Number of stroke control points (count each coordinate as 2 points).
- * @strokes: (array length=num_strokes) (element-type gdouble) Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
+ * @strokes: (array length=num_strokes) (element-type gdouble): Array of stroke coordinates: { s1.x, s1.y,
s2.x, s2.y, ..., sn.x, sn.y }.
*
* Smudge image with varying pressure.
*
diff --git a/libgimp/gimppalette_pdb.c b/libgimp/gimppalette_pdb.c
index 242e38d47a..02b29d2956 100644
--- a/libgimp/gimppalette_pdb.c
+++ b/libgimp/gimppalette_pdb.c
@@ -42,7 +42,7 @@
*
* This procedure creates a new, uninitialized palette
*
- * Returns: (transfer full) 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: (transfer full) 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: (transfer full) The actual new name of the palette.
+ * Returns: (transfer full): The actual new name of the palette.
*
* Since: 2.2
**/
@@ -215,7 +215,7 @@ gimp_palette_is_editable (const gchar *name)
/**
* gimp_palette_get_info:
* @name: The palette name.
- * @num_colors: (out) (out): The number of colors in the palette.
+ * @num_colors: (out): (out): The number of colors in the palette.
*
* Retrieve information about the specified palette.
*
@@ -257,14 +257,14 @@ gimp_palette_get_info (const gchar *name,
/**
* gimp_palette_get_colors:
* @name: The palette name.
- * @num_colors: (out) Length of the colors array.
+ * @num_colors: (out): Length of the colors array.
*
* Gets all colors from the specified palette.
*
* This procedure retrieves all color entries of the specified palette.
*
* Returns: (array length=num_colors) (element-type GimpRGB) (transfer
- * full) The colors in the palette.
+ * full): The colors in the palette.
*
* Since: 2.6
**/
@@ -378,7 +378,7 @@ gimp_palette_set_columns (const gchar *name,
* @name: The palette name.
* @entry_name: The name of the entry.
* @color: The new entry's color color.
- * @entry_num: (out) The index of the added entry.
+ * @entry_num: (out): The index of the added entry.
*
* Adds a palette entry to the specified palette.
*
@@ -466,7 +466,7 @@ gimp_palette_delete_entry (const gchar *name,
* gimp_palette_entry_get_color:
* @name: The palette name.
* @entry_num: The entry to retrieve.
- * @color: (out) (out): The color requested.
+ * @color: (out): (out): The color requested.
*
* Gets the specified palette entry from the specified palette.
*
@@ -555,7 +555,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: (out) (transfer full) The name requested.
+ * @entry_name: (out) (transfer full): The name requested.
*
* Gets the specified palette entry from the specified palette.
*
diff --git a/libgimp/gimppalettes_pdb.c b/libgimp/gimppalettes_pdb.c
index 5a43053704..6f743801df 100644
--- a/libgimp/gimppalettes_pdb.c
+++ b/libgimp/gimppalettes_pdb.c
@@ -67,7 +67,7 @@ gimp_palettes_refresh (void)
/**
* gimp_palettes_get_list:
* @filter: An optional regular expression used to filter the list.
- * @num_palettes: (out) The number of palettes in the list.
+ * @num_palettes: (out): The number of palettes in the list.
*
* Retrieves a list of all of the available palettes
*
@@ -76,7 +76,7 @@ gimp_palettes_refresh (void)
* gimp_context_set_palette().
*
* Returns: (array length=num_palettes) (element-type gchar*) (transfer
- * full) The list of palette names. The returned value must be freed
+ * full): The list of palette names. The returned value must be freed
* with g_strfreev().
**/
gchar **
diff --git a/libgimp/gimppattern_pdb.c b/libgimp/gimppattern_pdb.c
index c97d699d42..a59f7e4156 100644
--- a/libgimp/gimppattern_pdb.c
+++ b/libgimp/gimppattern_pdb.c
@@ -37,9 +37,9 @@
/**
* gimp_pattern_get_info:
* @name: The pattern name.
- * @width: (out) The pattern width.
- * @height: (out) The pattern height.
- * @bpp: (out) The pattern bpp.
+ * @width: (out): The pattern width.
+ * @height: (out): The pattern height.
+ * @bpp: (out): The pattern bpp.
*
* Retrieve information about the specified pattern.
*
@@ -89,11 +89,11 @@ gimp_pattern_get_info (const gchar *name,
/**
* gimp_pattern_get_pixels:
* @name: The pattern name.
- * @width: (out) The pattern width.
- * @height: (out) The pattern height.
- * @bpp: (out) The pattern bpp.
- * @num_color_bytes: (out) Number of pattern bytes.
- * @color_bytes: (out) (array length=num_color_bytes) (element-type guint8) (transfer full) The pattern data.
+ * @width: (out): The pattern width.
+ * @height: (out): The pattern height.
+ * @bpp: (out): The pattern bpp.
+ * @num_color_bytes: (out): Number of pattern bytes.
+ * @color_bytes: (out) (array length=num_color_bytes) (element-type guint8) (transfer full): The pattern
data.
*
* Retrieve information about the specified pattern (including pixels).
*
diff --git a/libgimp/gimppatterns_pdb.c b/libgimp/gimppatterns_pdb.c
index 835ab1311c..a5c85e8261 100644
--- a/libgimp/gimppatterns_pdb.c
+++ b/libgimp/gimppatterns_pdb.c
@@ -67,7 +67,7 @@ gimp_patterns_refresh (void)
/**
* gimp_patterns_get_list:
* @filter: An optional regular expression used to filter the list.
- * @num_patterns: (out) The number of patterns in the pattern list.
+ * @num_patterns: (out): The number of patterns in the pattern list.
*
* Retrieve a complete listing of the available patterns.
*
@@ -76,7 +76,7 @@ gimp_patterns_refresh (void)
* gimp_context_set_pattern().
*
* Returns: (array length=num_patterns) (element-type gchar*) (transfer
- * full) The list of pattern names. The returned value must be freed
+ * full): The list of pattern names. The returned value must be freed
* with g_strfreev().
**/
gchar **
diff --git a/libgimp/gimpplugin_pdb.c b/libgimp/gimpplugin_pdb.c
index c69c76c34d..f5faf94509 100644
--- a/libgimp/gimpplugin_pdb.c
+++ b/libgimp/gimpplugin_pdb.c
@@ -203,7 +203,7 @@ gimp_plugin_menu_branch_register (const gchar *menu_path,
* @procedure_name: The procedure for which to install the icon.
* @icon_type: The type of the icon.
* @icon_data_length: The length of 'icon-data'.
- * @icon_data: (array length=icon_data_length) (element-type guint8) The procedure's icon. The format
depends on the 'icon_type' parameter.
+ * @icon_data: (array length=icon_data_length) (element-type guint8): The procedure's icon. The format
depends on the 'icon_type' parameter.
*
* Register an icon for a plug-in procedure.
*
diff --git a/libgimp/gimpproceduraldb_pdb.c b/libgimp/gimpproceduraldb_pdb.c
index 3dab16c03c..fa46aa1de9 100644
--- a/libgimp/gimpproceduraldb_pdb.c
+++ b/libgimp/gimpproceduraldb_pdb.c
@@ -43,8 +43,8 @@
* This procedure generates a temporary PDB entry name that is
* guaranteed to be unique.
*
- * Returns: (transfer full) 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,8 +110,8 @@ gimp_procedural_db_dump (const gchar *filename)
* @copyright: The regex for procedure copyright.
* @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: (out) The number of matching procedures.
- * @procedure_names: (out) (array length=num_matches) (element-type gchar*) (transfer full) The list of
procedure names.
+ * @num_matches: (out): The number of matching procedures.
+ * @procedure_names: (out) (array length=num_matches) (element-type gchar*) (transfer full): The list of
procedure names.
*
* Queries the procedural database for its contents using regular
* expression matching.
@@ -221,14 +221,14 @@ gimp_procedural_db_proc_exists (const gchar *procedure_name)
/**
* _gimp_procedural_db_proc_info:
* @procedure_name: The procedure name.
- * @blurb: (out) (transfer full) A short blurb.
- * @help: (out) (transfer full) Detailed procedure help.
- * @author: (out) (transfer full) Author(s) of the procedure.
- * @copyright: (out) (transfer full) The copyright.
- * @date: (out) (transfer full) Copyright date.
- * @proc_type: (out) The procedure type.
- * @num_args: (out) The number of input arguments.
- * @num_values: (out) The number of return values.
+ * @blurb: (out) (transfer full): A short blurb.
+ * @help: (out) (transfer full): Detailed procedure help.
+ * @author: (out) (transfer full): Author(s) of the procedure.
+ * @copyright: (out) (transfer full): The copyright.
+ * @date: (out) (transfer full): Copyright date.
+ * @proc_type: (out): The procedure type.
+ * @num_args: (out): The number of input arguments.
+ * @num_values: (out): The number of return values.
*
* Queries the procedural database for information on the specified
* procedure.
@@ -297,9 +297,9 @@ _gimp_procedural_db_proc_info (const gchar *procedure_name,
* gimp_procedural_db_proc_arg:
* @procedure_name: The procedure name.
* @arg_num: The argument number.
- * @arg_type: (out) The type of argument.
- * @arg_name: (out) (transfer full) The name of the argument.
- * @arg_desc: (out) (transfer full) A description of the argument.
+ * @arg_type: (out): The type of argument.
+ * @arg_name: (out) (transfer full): The name of the argument.
+ * @arg_desc: (out) (transfer full): A description of the argument.
*
* Queries the procedural database for information on the specified
* procedure's argument.
@@ -352,9 +352,9 @@ gimp_procedural_db_proc_arg (const gchar *procedure_name,
* gimp_procedural_db_proc_val:
* @procedure_name: The procedure name.
* @val_num: The return value number.
- * @val_type: (out) The type of return value.
- * @val_name: (out) (transfer full) The name of the return value.
- * @val_desc: (out) (transfer full) A description of the return value.
+ * @val_type: (out): The type of return value.
+ * @val_name: (out) (transfer full): The name of the return value.
+ * @val_desc: (out) (transfer full): A description of the return value.
*
* Queries the procedural database for information on the specified
* procedure's return value.
@@ -407,8 +407,8 @@ gimp_procedural_db_proc_val (const gchar *procedure_name,
/**
* _gimp_procedural_db_get_data:
* @identifier: The identifier associated with data.
- * @bytes: (out) The number of bytes in the data.
- * @data: (out) (array length=bytes) (element-type guint8) (transfer full) A byte array containing data.
+ * @bytes: (out): The number of bytes in the data.
+ * @data: (out) (array length=bytes) (element-type guint8) (transfer full): A byte array containing data.
*
* Returns data associated with the specified identifier.
*
@@ -491,7 +491,7 @@ gimp_procedural_db_get_data_size (const gchar *identifier)
* _gimp_procedural_db_set_data:
* @identifier: The identifier associated with data.
* @bytes: The number of bytes in the data.
- * @data: (array length=bytes) (element-type guint8) A byte array containing data.
+ * @data: (array length=bytes) (element-type guint8): A byte array containing data.
*
* Associates the specified identifier with the supplied data.
*
diff --git a/libgimp/gimpselection_pdb.c b/libgimp/gimpselection_pdb.c
index 5bfedfb789..f3e48775dc 100644
--- a/libgimp/gimpselection_pdb.c
+++ b/libgimp/gimpselection_pdb.c
@@ -37,11 +37,11 @@
/**
* gimp_selection_bounds:
* @image_ID: The image.
- * @non_empty: (out) TRUE if there is a selection.
- * @x1: (out) x coordinate of upper left corner of selection bounds.
- * @y1: (out) y coordinate of upper left corner of selection bounds.
- * @x2: (out) x coordinate of lower right corner of selection bounds.
- * @y2: (out) y coordinate of lower right corner of selection bounds.
+ * @non_empty: (out): TRUE if there is a selection.
+ * @x1: (out): x coordinate of upper left corner of selection bounds.
+ * @y1: (out): y coordinate of upper left corner of selection bounds.
+ * @x2: (out): x coordinate of lower right corner of selection bounds.
+ * @y2: (out): y coordinate of lower right corner of selection bounds.
*
* Find the bounding box of the current selection.
*
diff --git a/libgimp/gimptextlayer_pdb.c b/libgimp/gimptextlayer_pdb.c
index 3f790ed5fd..e05f1318b5 100644
--- a/libgimp/gimptextlayer_pdb.c
+++ b/libgimp/gimptextlayer_pdb.c
@@ -98,7 +98,7 @@ gimp_text_layer_new (gint32 image_ID,
*
* This procedure returns the text from a text layer as a string.
*
- * Returns: (transfer full) The text from the specified text layer.
+ * Returns: (transfer full): The text from the specified text layer.
*
* Since: 2.6
**/
@@ -175,7 +175,7 @@ gimp_text_layer_set_text (gint32 layer_ID,
* markup. Note: Setting the markup of a text layer using Pango's
* markup is not supported for now.
*
- * Returns: (transfer full) The markup which represents the style of
+ * Returns: (transfer full): The markup which represents the style of
* the specified text layer.
*
* Since: 2.8
@@ -211,7 +211,7 @@ gimp_text_layer_get_markup (gint32 layer_ID)
*
* This procedure returns the name of the font from a text layer.
*
- * Returns: (transfer full) The font which is used in the specified
+ * Returns: (transfer full): The font which is used in the specified
* text layer.
*
* Since: 2.6
@@ -280,7 +280,7 @@ gimp_text_layer_set_font (gint32 layer_ID,
/**
* gimp_text_layer_get_font_size:
* @layer_ID: The text layer.
- * @unit: (out) The unit used for the font size.
+ * @unit: (out): The unit used for the font size.
*
* Get the font size from a text layer.
*
@@ -598,7 +598,7 @@ gimp_text_layer_set_kerning (gint32 layer_ID,
* This procedure returns the language string which is set for the text
* in the text layer.
*
- * Returns: (transfer full) The language used in the text layer.
+ * Returns: (transfer full): The language used in the text layer.
*
* Since: 2.6
**/
@@ -817,7 +817,7 @@ gimp_text_layer_set_justification (gint32 layer_ID,
/**
* gimp_text_layer_get_color:
* @layer_ID: The text layer.
- * @color: (out) The color of the text.
+ * @color: (out): The color of the text.
*
* Get the color of the text in a text layer.
*
diff --git a/libgimp/gimptexttool_pdb.c b/libgimp/gimptexttool_pdb.c
index 4d98675e85..812b000fa3 100644
--- a/libgimp/gimptexttool_pdb.c
+++ b/libgimp/gimptexttool_pdb.c
@@ -122,10 +122,10 @@ gimp_text_fontname (gint32 image_ID,
* @size: The size of text in either pixels or points.
* @size_type: The units of specified size.
* @fontname: The name of the font.
- * @width: (out) The width of the specified font.
- * @height: (out) The height of the specified font.
- * @ascent: (out) The ascent of the specified font.
- * @descent: (out) The descent of the specified font.
+ * @width: (out): The width of the specified font.
+ * @height: (out): The height of the specified font.
+ * @ascent: (out): The ascent of the specified font.
+ * @descent: (out): The descent of the specified font.
*
* Get extents of the bounding box for the specified text.
*
diff --git a/libgimp/gimpunit_pdb.c b/libgimp/gimpunit_pdb.c
index 111fd71074..2232e9fcfc 100644
--- a/libgimp/gimpunit_pdb.c
+++ b/libgimp/gimpunit_pdb.c
@@ -238,7 +238,7 @@ _gimp_unit_set_deletion_flag (GimpUnit unit_id,
* built-in units it will be the english singular form of the unit's
* name. For user-defined units this should equal to the singular form.
*
- * Returns: (transfer full) The unit's textual identifier.
+ * Returns: (transfer full): The unit's textual identifier.
**/
gchar *
_gimp_unit_get_identifier (GimpUnit unit_id)
@@ -342,7 +342,7 @@ _gimp_unit_get_digits (GimpUnit unit_id)
*
* This procedure returns the symbol of the unit (\"''\" for inches).
*
- * Returns: (transfer full) The unit's symbol.
+ * Returns: (transfer full): The unit's symbol.
**/
gchar *
_gimp_unit_get_symbol (GimpUnit unit_id)
@@ -376,7 +376,7 @@ _gimp_unit_get_symbol (GimpUnit unit_id)
* This procedure returns the abbreviation of the unit (\"in\" for
* inches).
*
- * Returns: (transfer full) The unit's abbreviation.
+ * Returns: (transfer full): The unit's abbreviation.
**/
gchar *
_gimp_unit_get_abbreviation (GimpUnit unit_id)
@@ -409,7 +409,7 @@ _gimp_unit_get_abbreviation (GimpUnit unit_id)
*
* This procedure returns the singular form of the unit.
*
- * Returns: (transfer full) The unit's singular form.
+ * Returns: (transfer full): The unit's singular form.
**/
gchar *
_gimp_unit_get_singular (GimpUnit unit_id)
@@ -442,7 +442,7 @@ _gimp_unit_get_singular (GimpUnit unit_id)
*
* This procedure returns the plural form of the unit.
*
- * Returns: (transfer full) The unit's plural form.
+ * Returns: (transfer full): The unit's plural form.
**/
gchar *
_gimp_unit_get_plural (GimpUnit unit_id)
diff --git a/libgimp/gimpvectors_pdb.c b/libgimp/gimpvectors_pdb.c
index 056752546e..8c5139c01b 100644
--- a/libgimp/gimpvectors_pdb.c
+++ b/libgimp/gimpvectors_pdb.c
@@ -154,7 +154,7 @@ gimp_vectors_copy (gint32 vectors_ID)
/**
* gimp_vectors_get_strokes:
* @vectors_ID: The vectors object.
- * @num_strokes: (out) The number of strokes returned.
+ * @num_strokes: (out): The number of strokes returned.
*
* List the strokes associated with the passed path.
*
@@ -162,7 +162,7 @@ gimp_vectors_copy (gint32 vectors_ID)
* path.
*
* Returns: (array length=num_strokes) (element-type gint32) (transfer
- * full) List of the strokes belonging to the path.
+ * full): List of the strokes belonging to the path.
*
* Since: 2.4
**/
@@ -244,10 +244,10 @@ gimp_vectors_stroke_get_length (gint32 vectors_ID,
* @stroke_id: The stroke ID.
* @dist: The given distance.
* @precision: The precision used for the approximation.
- * @x_point: (out) The x position of the point.
- * @y_point: (out) The y position of the point.
- * @slope: (out) The slope (dy / dx) at the specified point.
- * @valid: (out) Indicator for the validity of the returned data.
+ * @x_point: (out): The x position of the point.
+ * @y_point: (out): The y position of the point.
+ * @slope: (out): The slope (dy / dx) at the specified point.
+ * @valid: (out): Indicator for the validity of the returned data.
*
* Get point at a specified distance along the stroke.
*
@@ -634,9 +634,9 @@ gimp_vectors_stroke_flip_free (gint32 vectors_ID,
* gimp_vectors_stroke_get_points:
* @vectors_ID: The vectors object.
* @stroke_id: The stroke ID.
- * @num_points: (out) The number of floats returned.
- * @controlpoints: (out) (array length=num_points) (element-type gdouble) (transfer full) List of the
control points for the stroke (x0, y0, x1, y1, ...).
- * @closed: (out) Whether the stroke is closed or not.
+ * @num_points: (out): The number of floats returned.
+ * @controlpoints: (out) (array length=num_points) (element-type gdouble) (transfer full): List of the
control points for the stroke (x0, y0, x1, y1, ...).
+ * @closed: (out): Whether the stroke is closed or not.
*
* returns the control points of a stroke.
*
@@ -691,7 +691,7 @@ gimp_vectors_stroke_get_points (gint32 vectors_ID,
* @vectors_ID: The vectors object.
* @type: type of the stroke (always GIMP_VECTORS_STROKE_TYPE_BEZIER for now).
* @num_points: The number of elements in the array, i.e. the number of controlpoints in the stroke * 2 (x-
and y-coordinate).
- * @controlpoints: (array length=num_points) (element-type gdouble) List of the x- and y-coordinates of the
control points.
+ * @controlpoints: (array length=num_points) (element-type gdouble): List of the x- and y-coordinates of the
control points.
* @closed: Whether the stroke is to be closed or not.
*
* Adds a stroke of a given type to the vectors object.
@@ -749,15 +749,15 @@ gimp_vectors_stroke_new_from_points (gint32 vectors_ID,
* @vectors_ID: The vectors object.
* @stroke_id: The stroke ID.
* @precision: The precision used for the approximation.
- * @num_coords: (out) The number of floats returned.
- * @closed: (out) Whether the stroke is closed or not.
+ * @num_coords: (out): The number of floats returned.
+ * @closed: (out): Whether the stroke is closed or not.
*
* returns polygonal approximation of the stroke.
*
* returns polygonal approximation of the stroke.
*
* Returns: (array length=coords) (element-type gdouble) (transfer
- * full) List of the coords along the path (x0, y0, x1, y1, ...).
+ * full): List of the coords along the path (x0, y0, x1, y1, ...).
*
* Since: 2.4
**/
@@ -1066,8 +1066,8 @@ gimp_vectors_bezier_stroke_new_ellipse (gint32 vectors_ID,
* @filename: The name of the SVG file to import.
* @merge: Merge paths into a single vectors object.
* @scale: Scale the SVG to image dimensions.
- * @num_vectors: (out) The number of newly created vectors.
- * @vectors_ids: (out) (array length=num_vectors) (element-type gint32) (transfer full) The list of newly
created vectors.
+ * @num_vectors: (out): The number of newly created vectors.
+ * @vectors_ids: (out) (array length=num_vectors) (element-type gint32) (transfer full): The list of newly
created vectors.
*
* Import paths from an SVG file.
*
@@ -1127,8 +1127,8 @@ gimp_vectors_import_from_file (gint32 image_ID,
* @length: Number of bytes in string or -1 if the string is NULL terminated.
* @merge: Merge paths into a single vectors object.
* @scale: Scale the SVG to image dimensions.
- * @num_vectors: (out) The number of newly created vectors.
- * @vectors_ids: (out) (array length=num_vectors) (element-type gint32) (transfer full) The list of newly
created vectors.
+ * @num_vectors: (out): The number of newly created vectors.
+ * @vectors_ids: (out) (array length=num_vectors) (element-type gint32) (transfer full): The list of newly
created vectors.
*
* Import paths from an SVG string.
*
@@ -1242,7 +1242,7 @@ gimp_vectors_export_to_file (gint32 image_ID,
* string that holds a complete XML document. If you pass 0 as the
* 'vectors' argument, then all paths in the image will be exported.
*
- * Returns: (transfer full) A string whose contents are a complete SVG
+ * Returns: (transfer full): A string whose contents are a complete SVG
* document.
*
* Since: 2.6
diff --git a/pdb/lib.pl b/pdb/lib.pl
index eaaeedbaeb..ed2113a759 100644
--- a/pdb/lib.pl
+++ b/pdb/lib.pl
@@ -88,7 +88,7 @@ sub generate {
my $funcname = "gimp_$name"; my $wrapped = "";
my %usednames;
- my $retdesc = "Returns: ";
+ my $retdesc = "Returns:";
if ($proc->{deprecated}) {
if ($proc->{deprecated} eq 'NONE') {
@@ -134,14 +134,17 @@ sub generate {
$retarg->{retval} = 1;
if (exists $argtype->{array}) {
- $retdesc .= "(array length=@outargs[$retindex - 2]->{name}) ";
+ $retdesc .= " (array length=@outargs[$retindex - 2]->{name})";
}
if (exists $argtype->{out_annotate}) {
- $retdesc .= "$argtype->{out_annotate} ";
+ $retdesc .= " $argtype->{out_annotate}";
}
+ if (exists $argtype->{array} || exists $argtype->{out_annotate}) {
+ $retdesc .= ":";
+ }
- $retdesc .= exists $retarg->{desc} ? $retarg->{desc} : "";
+ $retdesc .= exists $retarg->{desc} ? " $retarg->{desc}" : "";
if ($retarg->{type} eq 'stringarray') {
$retdesc .= ". The returned value must be freed with g_strfreev().";
@@ -211,17 +214,21 @@ sub generate {
$argdesc .= " * \@$_->{name}";
$argdesc .= '_ID' if $arg->{id};
- $argdesc .= ": ";
+ $argdesc .= ":";
if (exists $arg->{array}) {
- $argdesc .= "(array length=@inargs[$argc - 1]->{name}) ";
+ $argdesc .= " (array length=@inargs[$argc - 1]->{name})";
}
if (exists $arg->{in_annotate}) {
- $argdesc .= "$arg->{in_annotate} ";
+ $argdesc .= " $arg->{in_annotate}";
}
- $argdesc .= "$desc";
+ if (exists $arg->{array} || exists $arg->{in_annotate}) {
+ $argdesc .= ":";
+ }
+
+ $argdesc .= " $desc";
unless ($argdesc =~ /[\.\!\?]$/) { $argdesc .= '.' }
$argdesc .= "\n";
@@ -236,7 +243,7 @@ sub generate {
# return success/failure boolean if we don't have anything else
if ($rettype eq 'void') {
$return_args .= "\n" . ' ' x 2 . "gboolean success = TRUE;";
- $retdesc .= "TRUE on success.";
+ $retdesc .= " TRUE on success.";
}
# We only need to bother with this if we have to return a value
@@ -346,17 +353,17 @@ CODE
$argdesc .= " * \@$_->{libname}";
$argdesc .= '_ID' if $arg->{id};
- $argdesc .= ": (out) ";
+ $argdesc .= ": (out)";
if (exists $arg->{array}) {
- $argdesc .= "(array length=@outargs[$argc - 2]->{name}) ";
+ $argdesc .= " (array length=@outargs[$argc - 2]->{name})";
}
if (exists $arg->{out_annotate}) {
- $argdesc .= "$arg->{out_annotate} ";
+ $argdesc .= " $arg->{out_annotate}";
}
- $argdesc .= "$desc";
+ $argdesc .= ": $desc";
}
$var = exists $_->{retval} ? "" : '*';
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
