Commit a87104ff authored by Jehan's avatar Jehan

pdb, libgimp: fix missing colons at end of annotations.

parent 05e68da4
Pipeline #100392 passed with stages
in 16 minutes and 57 seconds
......@@ -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)
......
......@@ -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.
*
......
......@@ -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,
......
......@@ -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
**/
......
......@@ -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.
*
......
......@@ -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.
*
......
......@@ -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.
*
......
......@@ -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.
......
......@@ -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
......
......@@ -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
......
......@@ -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
**/
......
......@@ -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 **
......
......@@ -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)
......
......@@ -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
*
......
......@@ -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 **
......
......@@ -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.
*