[gimp] pdb: generate nicer gtk-doc comments (no doc contents changed)



commit c6e93e4f5ac16195fc0a0906b367b48fd29d048e
Author: Michael Natterer <mitch gimp org>
Date:   Wed Sep 15 22:07:36 2010 +0200

    pdb: generate nicer gtk-doc comments (no doc contents changed)

 libgimp/gimpbrush_pdb.c             |   44 +++++-----
 libgimp/gimpbrushes_pdb.c           |   12 ++--
 libgimp/gimpbrushselect_pdb.c       |    6 +-
 libgimp/gimpbuffer_pdb.c            |   14 ++--
 libgimp/gimpchannel_pdb.c           |   20 ++--
 libgimp/gimpcolor_pdb.c             |   32 ++++----
 libgimp/gimpcontext_pdb.c           |   78 ++++++++--------
 libgimp/gimpconvert_pdb.c           |    8 +-
 libgimp/gimpdisplay_pdb.c           |   12 ++--
 libgimp/gimpdrawable_pdb.c          |   46 +++++-----
 libgimp/gimpdrawabletransform_pdb.c |   32 ++++----
 libgimp/gimpedit_pdb.c              |   34 ++++----
 libgimp/gimpfileops_pdb.c           |   22 +++---
 libgimp/gimpfloatingsel_pdb.c       |   12 ++--
 libgimp/gimpfonts_pdb.c             |    4 +-
 libgimp/gimpfontselect_pdb.c        |    6 +-
 libgimp/gimpgimprc_pdb.c            |   16 ++--
 libgimp/gimpgradient_pdb.c          |   62 +++++++-------
 libgimp/gimpgradients_pdb.c         |   10 +-
 libgimp/gimpgradientselect_pdb.c    |    6 +-
 libgimp/gimpgrid_pdb.c              |   20 ++--
 libgimp/gimpguides_pdb.c            |   12 ++--
 libgimp/gimphelp_pdb.c              |    2 +-
 libgimp/gimpimage_pdb.c             |  170 +++++++++++++++++-----------------
 libgimp/gimpitem_pdb.c              |   48 +++++-----
 libgimp/gimpitemtransform_pdb.c     |   18 ++--
 libgimp/gimplayer_pdb.c             |   62 +++++++-------
 libgimp/gimpmessage_pdb.c           |    6 +-
 libgimp/gimpmisc_pdb.c              |    4 +-
 libgimp/gimppainttools_pdb.c        |   34 ++++----
 libgimp/gimppalette_pdb.c           |   30 +++---
 libgimp/gimppalettes_pdb.c          |    8 +-
 libgimp/gimppaletteselect_pdb.c     |    6 +-
 libgimp/gimpparasite_pdb.c          |   40 ++++----
 libgimp/gimppaths_pdb.c             |   30 +++---
 libgimp/gimppattern_pdb.c           |    4 +-
 libgimp/gimppatterns_pdb.c          |    8 +-
 libgimp/gimppatternselect_pdb.c     |    6 +-
 libgimp/gimpplugin_pdb.c            |   14 ++--
 libgimp/gimpproceduraldb_pdb.c      |   20 ++--
 libgimp/gimpprogress_pdb.c          |   18 ++--
 libgimp/gimpselection_pdb.c         |   34 ++++----
 libgimp/gimpselectiontools_pdb.c    |   16 ++--
 libgimp/gimptextlayer_pdb.c         |   62 +++++++-------
 libgimp/gimptexttool_pdb.c          |    8 +-
 libgimp/gimptransformtools_pdb.c    |   12 ++--
 libgimp/gimpundo_pdb.c              |   14 ++--
 libgimp/gimpunit_pdb.c              |   24 +++---
 libgimp/gimpvectors_pdb.c           |   52 ++++++------
 tools/pdbgen/lib.pl                 |    2 +-
 50 files changed, 630 insertions(+), 630 deletions(-)
---
diff --git a/libgimp/gimpbrush_pdb.c b/libgimp/gimpbrush_pdb.c
index 6c0d123..2d22858 100644
--- a/libgimp/gimpbrush_pdb.c
+++ b/libgimp/gimpbrush_pdb.c
@@ -47,7 +47,7 @@
  * Returns: The actual new brush name.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_brush_new (const gchar *name)
 {
@@ -79,7 +79,7 @@ gimp_brush_new (const gchar *name)
  * Returns: The name of the brush's copy.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_brush_duplicate (const gchar *name)
 {
@@ -111,7 +111,7 @@ gimp_brush_duplicate (const gchar *name)
  * Returns: TRUE if the brush is generated.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_brush_is_generated (const gchar *name)
 {
@@ -144,7 +144,7 @@ gimp_brush_is_generated (const gchar *name)
  * Returns: The actual new name of the brush.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_brush_rename (const gchar *name,
                    const gchar *new_name)
@@ -178,7 +178,7 @@ gimp_brush_rename (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_brush_delete (const gchar *name)
 {
@@ -209,7 +209,7 @@ gimp_brush_delete (const gchar *name)
  * Returns: TRUE if the brush can be edited.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_brush_is_editable (const gchar *name)
 {
@@ -246,7 +246,7 @@ gimp_brush_is_editable (const gchar *name)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_brush_get_info (const gchar *name,
                      gint        *width,
@@ -303,7 +303,7 @@ gimp_brush_get_info (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_brush_get_pixels (const gchar  *name,
                        gint         *width,
@@ -372,7 +372,7 @@ gimp_brush_get_pixels (const gchar  *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_brush_get_spacing (const gchar *name,
                         gint        *spacing)
@@ -411,7 +411,7 @@ gimp_brush_get_spacing (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_brush_set_spacing (const gchar *name,
                         gint         spacing)
@@ -449,7 +449,7 @@ gimp_brush_set_spacing (const gchar *name,
  * Returns: The brush shape.
  *
  * Since: GIMP 2.4
- */
+ **/
 GimpBrushGeneratedShape
 gimp_brush_get_shape (const gchar *name)
 {
@@ -487,7 +487,7 @@ gimp_brush_get_shape (const gchar *name)
  * Returns: The brush shape actually assigned.
  *
  * Since: GIMP 2.4
- */
+ **/
 GimpBrushGeneratedShape
 gimp_brush_set_shape (const gchar             *name,
                       GimpBrushGeneratedShape  shape_in)
@@ -522,7 +522,7 @@ gimp_brush_set_shape (const gchar             *name,
  * Returns: The radius of the brush in pixels.
  *
  * Since: GIMP 2.4
- */
+ **/
 gdouble
 gimp_brush_get_radius (const gchar *name)
 {
@@ -556,7 +556,7 @@ gimp_brush_get_radius (const gchar *name)
  * Returns: The brush radius actually assigned.
  *
  * Since: GIMP 2.4
- */
+ **/
 gdouble
 gimp_brush_set_radius (const gchar *name,
                        gdouble      radius_in)
@@ -591,7 +591,7 @@ gimp_brush_set_radius (const gchar *name,
  * Returns: The number of spikes on the brush.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_brush_get_spikes (const gchar *name)
 {
@@ -625,7 +625,7 @@ gimp_brush_get_spikes (const gchar *name)
  * Returns: The number of spikes actually assigned.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_brush_set_spikes (const gchar *name,
                        gint         spikes_in)
@@ -661,7 +661,7 @@ gimp_brush_set_spikes (const gchar *name,
  * Returns: The hardness of the brush.
  *
  * Since: GIMP 2.4
- */
+ **/
 gdouble
 gimp_brush_get_hardness (const gchar *name)
 {
@@ -695,7 +695,7 @@ gimp_brush_get_hardness (const gchar *name)
  * Returns: The brush hardness actually assigned.
  *
  * Since: GIMP 2.4
- */
+ **/
 gdouble
 gimp_brush_set_hardness (const gchar *name,
                          gdouble      hardness_in)
@@ -730,7 +730,7 @@ gimp_brush_set_hardness (const gchar *name,
  * Returns: The aspect ratio of the brush.
  *
  * Since: GIMP 2.4
- */
+ **/
 gdouble
 gimp_brush_get_aspect_ratio (const gchar *name)
 {
@@ -764,7 +764,7 @@ gimp_brush_get_aspect_ratio (const gchar *name)
  * Returns: The brush aspect ratio actually assigned.
  *
  * Since: GIMP 2.4
- */
+ **/
 gdouble
 gimp_brush_set_aspect_ratio (const gchar *name,
                              gdouble      aspect_ratio_in)
@@ -799,7 +799,7 @@ gimp_brush_set_aspect_ratio (const gchar *name,
  * Returns: The rotation angle of the brush.
  *
  * Since: GIMP 2.4
- */
+ **/
 gdouble
 gimp_brush_get_angle (const gchar *name)
 {
@@ -833,7 +833,7 @@ gimp_brush_get_angle (const gchar *name)
  * Returns: The brush rotation angle actually assigned.
  *
  * Since: GIMP 2.4
- */
+ **/
 gdouble
 gimp_brush_set_angle (const gchar *name,
                       gdouble      angle_in)
diff --git a/libgimp/gimpbrushes_pdb.c b/libgimp/gimpbrushes_pdb.c
index a5ea8e4..3d1ba48 100644
--- a/libgimp/gimpbrushes_pdb.c
+++ b/libgimp/gimpbrushes_pdb.c
@@ -48,7 +48,7 @@
  * path and updates the brush dialogs accordingly.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_brushes_refresh (void)
 {
@@ -79,7 +79,7 @@ gimp_brushes_refresh (void)
  * gimp_context_set_brush() procedure.
  *
  * Returns: The list of brush names.
- */
+ **/
 gchar **
 gimp_brushes_get_list (const gchar *filter,
                        gint        *num_brushes)
@@ -118,7 +118,7 @@ gimp_brushes_get_list (const gchar *filter,
  * Deprecated: Use gimp_context_get_brush() instead.
  *
  * Returns: The brush name.
- */
+ **/
 gchar *
 gimp_brushes_get_brush (gint *width,
                         gint *height,
@@ -151,7 +151,7 @@ gimp_brushes_get_brush (gint *width,
  * Deprecated: Use gimp_brush_get_spacing() instead.
  *
  * Returns: The brush spacing.
- */
+ **/
 gint
 gimp_brushes_get_spacing (void)
 {
@@ -178,7 +178,7 @@ gimp_brushes_get_spacing (void)
  * Deprecated: Use gimp_brush_set_spacing() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_brushes_set_spacing (gint spacing)
 {
@@ -212,7 +212,7 @@ gimp_brushes_set_spacing (gint spacing)
  * Deprecated: Use gimp_brush_get_pixels() instead.
  *
  * Returns: The brush name.
- */
+ **/
 gchar *
 gimp_brushes_get_brush_data (const gchar           *name,
                              gdouble               *opacity,
diff --git a/libgimp/gimpbrushselect_pdb.c b/libgimp/gimpbrushselect_pdb.c
index 4226df1..fbe5d37 100644
--- a/libgimp/gimpbrushselect_pdb.c
+++ b/libgimp/gimpbrushselect_pdb.c
@@ -48,7 +48,7 @@
  * This procedure opens the brush selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_brushes_popup (const gchar          *brush_callback,
                     const gchar          *popup_title,
@@ -87,7 +87,7 @@ gimp_brushes_popup (const gchar          *brush_callback,
  * This procedure closes an opened brush selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_brushes_close_popup (const gchar *brush_callback)
 {
@@ -120,7 +120,7 @@ gimp_brushes_close_popup (const gchar *brush_callback)
  * Sets the current brush in a brush selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_brushes_set_popup (const gchar          *brush_callback,
                         const gchar          *brush_name,
diff --git a/libgimp/gimpbuffer_pdb.c b/libgimp/gimpbuffer_pdb.c
index 1edf756..f7ad5cb 100644
--- a/libgimp/gimpbuffer_pdb.c
+++ b/libgimp/gimpbuffer_pdb.c
@@ -47,7 +47,7 @@
  * Returns: The list of buffer names.
  *
  * Since: GIMP 2.4
- */
+ **/
 gchar **
 gimp_buffers_get_list (const gchar *filter,
                        gint        *num_buffers)
@@ -89,7 +89,7 @@ gimp_buffers_get_list (const gchar *filter,
  * Returns: The real name given to the buffer.
  *
  * Since: GIMP 2.4
- */
+ **/
 gchar *
 gimp_buffer_rename (const gchar *buffer_name,
                     const gchar *new_name)
@@ -123,7 +123,7 @@ gimp_buffer_rename (const gchar *buffer_name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_buffer_delete (const gchar *buffer_name)
 {
@@ -154,7 +154,7 @@ gimp_buffer_delete (const gchar *buffer_name)
  * Returns: The buffer width.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_buffer_get_width (const gchar *buffer_name)
 {
@@ -186,7 +186,7 @@ gimp_buffer_get_width (const gchar *buffer_name)
  * Returns: The buffer height.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_buffer_get_height (const gchar *buffer_name)
 {
@@ -218,7 +218,7 @@ gimp_buffer_get_height (const gchar *buffer_name)
  * Returns: The buffer bpp.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_buffer_get_bytes (const gchar *buffer_name)
 {
@@ -250,7 +250,7 @@ gimp_buffer_get_bytes (const gchar *buffer_name)
  * Returns: The buffer image type.
  *
  * Since: GIMP 2.4
- */
+ **/
 GimpImageBaseType
 gimp_buffer_get_image_type (const gchar *buffer_name)
 {
diff --git a/libgimp/gimpchannel_pdb.c b/libgimp/gimpchannel_pdb.c
index e7621a9..026f841 100644
--- a/libgimp/gimpchannel_pdb.c
+++ b/libgimp/gimpchannel_pdb.c
@@ -54,7 +54,7 @@
  * initially.
  *
  * Returns: The newly created channel.
- */
+ **/
 gint32
 _gimp_channel_new (gint32         image_ID,
                    gint           width,
@@ -98,7 +98,7 @@ _gimp_channel_new (gint32         image_ID,
  * Returns: The newly created channel.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint32
 gimp_channel_new_from_component (gint32           image_ID,
                                  GimpChannelType  component,
@@ -132,7 +132,7 @@ gimp_channel_new_from_component (gint32           image_ID,
  * This procedure copies the specified channel and returns the copy.
  *
  * Returns: The newly copied channel.
- */
+ **/
 gint32
 gimp_channel_copy (gint32 channel_ID)
 {
@@ -167,7 +167,7 @@ gimp_channel_copy (gint32 channel_ID)
  * the first channel.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_channel_combine_masks (gint32         channel1_ID,
                             gint32         channel2_ID,
@@ -206,7 +206,7 @@ gimp_channel_combine_masks (gint32         channel1_ID,
  * masked regions are shown. Otherwise, selected regions are shown.
  *
  * Returns: The channel composite method.
- */
+ **/
 gboolean
 gimp_channel_get_show_masked (gint32 channel_ID)
 {
@@ -239,7 +239,7 @@ gimp_channel_get_show_masked (gint32 channel_ID)
  * masked regions are shown. Otherwise, selected regions are shown.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_channel_set_show_masked (gint32   channel_ID,
                               gboolean show_masked)
@@ -270,7 +270,7 @@ gimp_channel_set_show_masked (gint32   channel_ID,
  * This procedure returns the specified channel's opacity.
  *
  * Returns: The channel opacity.
- */
+ **/
 gdouble
 gimp_channel_get_opacity (gint32 channel_ID)
 {
@@ -301,7 +301,7 @@ gimp_channel_get_opacity (gint32 channel_ID)
  * This procedure sets the specified channel's opacity.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_channel_set_opacity (gint32  channel_ID,
                           gdouble opacity)
@@ -333,7 +333,7 @@ gimp_channel_set_opacity (gint32  channel_ID,
  * This procedure returns the specified channel's compositing color.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_channel_get_color (gint32   channel_ID,
                         GimpRGB *color)
@@ -367,7 +367,7 @@ gimp_channel_get_color (gint32   channel_ID,
  * This procedure sets the specified channel's compositing color.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_channel_set_color (gint32         channel_ID,
                         const GimpRGB *color)
diff --git a/libgimp/gimpcolor_pdb.c b/libgimp/gimpcolor_pdb.c
index 8a1d926..5ba8bcf 100644
--- a/libgimp/gimpcolor_pdb.c
+++ b/libgimp/gimpcolor_pdb.c
@@ -50,7 +50,7 @@
  * are defined between -127 and 127.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_brightness_contrast (gint32 drawable_ID,
                           gint   brightness,
@@ -100,7 +100,7 @@ gimp_brightness_contrast (gint32 drawable_ID,
  * grayscale images. It will not operate on indexed drawables.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_levels (gint32               drawable_ID,
              GimpHistogramChannel channel,
@@ -139,7 +139,7 @@ gimp_levels (gint32               drawable_ID,
  * Deprecated: Use gimp_levels_stretch() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_levels_auto (gint32 drawable_ID)
 {
@@ -172,7 +172,7 @@ gimp_levels_auto (gint32 drawable_ID)
  * not operate on indexed drawables.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_levels_stretch (gint32 drawable_ID)
 {
@@ -203,7 +203,7 @@ gimp_levels_stretch (gint32 drawable_ID)
  * intensity channel to the specified 'levels' parameter.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_posterize (gint32 drawable_ID,
                 gint   levels)
@@ -235,7 +235,7 @@ gimp_posterize (gint32 drawable_ID,
  * This procedure only works on drawables of type RGB color.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_desaturate (gint32 drawable_ID)
 {
@@ -270,7 +270,7 @@ gimp_desaturate (gint32 drawable_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_desaturate_full (gint32             drawable_ID,
                       GimpDesaturateMode desaturate_mode)
@@ -309,7 +309,7 @@ gimp_desaturate_full (gint32             drawable_ID,
  * adjusted based on the histogram for the entire image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_equalize (gint32   drawable_ID,
                gboolean mask_only)
@@ -343,7 +343,7 @@ gimp_equalize (gint32   drawable_ID,
  * valid for this operation.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_invert (gint32 drawable_ID)
 {
@@ -381,7 +381,7 @@ gimp_invert (gint32 drawable_ID)
  * to explicitly modify intensity levels.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_curves_spline (gint32                drawable_ID,
                     GimpHistogramChannel  channel,
@@ -425,7 +425,7 @@ gimp_curves_spline (gint32                drawable_ID,
  * Catmull Rom splines.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_curves_explicit (gint32                drawable_ID,
                       GimpHistogramChannel  channel,
@@ -472,7 +472,7 @@ gimp_curves_explicit (gint32                drawable_ID,
  * luminosity of each pixel remains fixed.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_color_balance (gint32           drawable_ID,
                     GimpTransferMode transfer_mode,
@@ -519,7 +519,7 @@ gimp_color_balance (gint32           drawable_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_colorize (gint32  drawable_ID,
                gdouble hue,
@@ -576,7 +576,7 @@ gimp_colorize (gint32  drawable_ID,
  * pixels with transparent alpha values will not be counted.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_histogram (gint32                drawable_ID,
                 GimpHistogramChannel  channel,
@@ -640,7 +640,7 @@ gimp_histogram (gint32                drawable_ID,
  * provides the capability to limit range of affected hues.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_hue_saturation (gint32       drawable_ID,
                      GimpHueRange hue_range,
@@ -682,7 +682,7 @@ gimp_hue_saturation (gint32       drawable_ID,
  * black.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_threshold (gint32 drawable_ID,
                 gint   low_threshold,
diff --git a/libgimp/gimpcontext_pdb.c b/libgimp/gimpcontext_pdb.c
index 791253f..a057614 100644
--- a/libgimp/gimpcontext_pdb.c
+++ b/libgimp/gimpcontext_pdb.c
@@ -46,7 +46,7 @@
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_push (void)
 {
@@ -78,7 +78,7 @@ gimp_context_push (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_pop (void)
 {
@@ -110,7 +110,7 @@ gimp_context_pop (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_context_list_paint_methods (gint    *num_paint_methods,
                                  gchar ***paint_methods)
@@ -153,7 +153,7 @@ gimp_context_list_paint_methods (gint    *num_paint_methods,
  * Returns: The name of the active paint method.
  *
  * Since: GIMP 2.4
- */
+ **/
 gchar *
 gimp_context_get_paint_method (void)
 {
@@ -189,7 +189,7 @@ gimp_context_get_paint_method (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_context_set_paint_method (const gchar *name)
 {
@@ -222,7 +222,7 @@ gimp_context_set_paint_method (const gchar *name)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_get_foreground (GimpRGB *foreground)
 {
@@ -257,7 +257,7 @@ gimp_context_get_foreground (GimpRGB *foreground)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_set_foreground (const GimpRGB *foreground)
 {
@@ -290,7 +290,7 @@ gimp_context_set_foreground (const GimpRGB *foreground)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_get_background (GimpRGB *background)
 {
@@ -326,7 +326,7 @@ gimp_context_get_background (GimpRGB *background)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_set_background (const GimpRGB *background)
 {
@@ -358,7 +358,7 @@ gimp_context_set_background (const GimpRGB *background)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_set_default_colors (void)
 {
@@ -389,7 +389,7 @@ gimp_context_set_default_colors (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_swap_colors (void)
 {
@@ -419,7 +419,7 @@ gimp_context_swap_colors (void)
  * Returns: The opacity.
  *
  * Since: GIMP 2.2
- */
+ **/
 gdouble
 gimp_context_get_opacity (void)
 {
@@ -451,7 +451,7 @@ gimp_context_get_opacity (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_set_opacity (gdouble opacity)
 {
@@ -483,7 +483,7 @@ gimp_context_set_opacity (gdouble opacity)
  * Returns: The paint mode.
  *
  * Since: GIMP 2.2
- */
+ **/
 GimpLayerModeEffects
 gimp_context_get_paint_mode (void)
 {
@@ -514,7 +514,7 @@ gimp_context_get_paint_mode (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_set_paint_mode (GimpLayerModeEffects paint_mode)
 {
@@ -546,7 +546,7 @@ gimp_context_set_paint_mode (GimpLayerModeEffects paint_mode)
  * Returns: The name of the active brush.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_context_get_brush (void)
 {
@@ -581,7 +581,7 @@ gimp_context_get_brush (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_set_brush (const gchar *name)
 {
@@ -613,7 +613,7 @@ gimp_context_set_brush (const gchar *name)
  * Returns: The name of the active pattern.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_context_get_pattern (void)
 {
@@ -649,7 +649,7 @@ gimp_context_get_pattern (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_set_pattern (const gchar *name)
 {
@@ -679,7 +679,7 @@ gimp_context_set_pattern (const gchar *name)
  * Returns: The name of the active gradient.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_context_get_gradient (void)
 {
@@ -715,7 +715,7 @@ gimp_context_get_gradient (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_set_gradient (const gchar *name)
 {
@@ -745,7 +745,7 @@ gimp_context_set_gradient (const gchar *name)
  * Returns: The name of the active palette.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_context_get_palette (void)
 {
@@ -781,7 +781,7 @@ gimp_context_get_palette (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_set_palette (const gchar *name)
 {
@@ -811,7 +811,7 @@ gimp_context_set_palette (const gchar *name)
  * Returns: The name of the active font.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_context_get_font (void)
 {
@@ -846,7 +846,7 @@ gimp_context_get_font (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_context_set_font (const gchar *name)
 {
@@ -876,7 +876,7 @@ gimp_context_set_font (const gchar *name)
  * Returns: The antialias setting.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_context_get_antialias (void)
 {
@@ -908,7 +908,7 @@ gimp_context_get_antialias (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_context_set_antialias (gboolean antialias)
 {
@@ -938,7 +938,7 @@ gimp_context_set_antialias (gboolean antialias)
  * Returns: The feather setting.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_context_get_feather (void)
 {
@@ -970,7 +970,7 @@ gimp_context_get_feather (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_context_set_feather (gboolean feather)
 {
@@ -1002,7 +1002,7 @@ gimp_context_set_feather (gboolean feather)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_context_get_feather_radius (gdouble *feather_radius_x,
                                  gdouble *feather_radius_y)
@@ -1044,7 +1044,7 @@ gimp_context_get_feather_radius (gdouble *feather_radius_x,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_context_set_feather_radius (gdouble feather_radius_x,
                                  gdouble feather_radius_y)
@@ -1078,7 +1078,7 @@ gimp_context_set_feather_radius (gdouble feather_radius_x,
  * Returns: The interpolation type.
  *
  * Since: GIMP 2.8
- */
+ **/
 GimpInterpolationType
 gimp_context_get_interpolation (void)
 {
@@ -1110,7 +1110,7 @@ gimp_context_get_interpolation (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_context_set_interpolation (GimpInterpolationType interpolation)
 {
@@ -1142,7 +1142,7 @@ gimp_context_set_interpolation (GimpInterpolationType interpolation)
  * Returns: The transform direction.
  *
  * Since: GIMP 2.8
- */
+ **/
 GimpTransformDirection
 gimp_context_get_transform_direction (void)
 {
@@ -1173,7 +1173,7 @@ gimp_context_get_transform_direction (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_context_set_transform_direction (GimpTransformDirection transform_direction)
 {
@@ -1205,7 +1205,7 @@ gimp_context_set_transform_direction (GimpTransformDirection transform_direction
  * Returns: The transform resize type.
  *
  * Since: GIMP 2.8
- */
+ **/
 GimpTransformResize
 gimp_context_get_transform_resize (void)
 {
@@ -1239,7 +1239,7 @@ gimp_context_get_transform_resize (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_context_set_transform_resize (GimpTransformResize transform_resize)
 {
@@ -1269,7 +1269,7 @@ gimp_context_set_transform_resize (GimpTransformResize transform_resize)
  * Returns: The transform recursion level.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint
 gimp_context_get_transform_recursion (void)
 {
@@ -1303,7 +1303,7 @@ gimp_context_get_transform_recursion (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_context_set_transform_recursion (gint transform_recursion)
 {
diff --git a/libgimp/gimpconvert_pdb.c b/libgimp/gimpconvert_pdb.c
index 0eada4c..2f2ddf7 100644
--- a/libgimp/gimpconvert_pdb.c
+++ b/libgimp/gimpconvert_pdb.c
@@ -46,7 +46,7 @@
  * indexed image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_convert_rgb (gint32 image_ID)
 {
@@ -77,7 +77,7 @@ gimp_image_convert_rgb (gint32 image_ID)
  * RGB or Indexed color mode.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_convert_grayscale (gint32 image_ID)
 {
@@ -124,7 +124,7 @@ gimp_image_convert_grayscale (gint32 image_ID)
  * location ('Fixed' dithering).
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_convert_indexed (gint32                  image_ID,
                             GimpConvertDitherType   dither_type,
@@ -171,7 +171,7 @@ gimp_image_convert_indexed (gint32                  image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_convert_set_dither_matrix (gint          width,
                                       gint          height,
diff --git a/libgimp/gimpdisplay_pdb.c b/libgimp/gimpdisplay_pdb.c
index fb6a21d..7e704b4 100644
--- a/libgimp/gimpdisplay_pdb.c
+++ b/libgimp/gimpdisplay_pdb.c
@@ -46,7 +46,7 @@
  * Returns: Whether the display ID is valid.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_display_is_valid (gint32 display_ID)
 {
@@ -80,7 +80,7 @@ gimp_display_is_valid (gint32 display_ID)
  * procedure only makes sense for use with the GIMP UI.
  *
  * Returns: The new display.
- */
+ **/
 gint32
 gimp_display_new (gint32 image_ID)
 {
@@ -114,7 +114,7 @@ gimp_display_new (gint32 image_ID)
  * procedure.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_display_delete (gint32 display_ID)
 {
@@ -149,7 +149,7 @@ gimp_display_delete (gint32 display_ID)
  * Returns: The native window handle or 0.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_display_get_window_handle (gint32 display_ID)
 {
@@ -181,7 +181,7 @@ gimp_display_get_window_handle (gint32 display_ID)
  * appropriate.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_displays_flush (void)
 {
@@ -213,7 +213,7 @@ gimp_displays_flush (void)
  * without success. You should rarely need to use this function.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_displays_reconnect (gint32 old_image_ID,
                          gint32 new_image_ID)
diff --git a/libgimp/gimpdrawable_pdb.c b/libgimp/gimpdrawable_pdb.c
index f5e4199..134bb71 100644
--- a/libgimp/gimpdrawable_pdb.c
+++ b/libgimp/gimpdrawable_pdb.c
@@ -48,7 +48,7 @@
  * This procedure returns the drawable's type.
  *
  * Returns: The drawable's type.
- */
+ **/
 GimpImageType
 gimp_drawable_type (gint32 drawable_ID)
 {
@@ -81,7 +81,7 @@ gimp_drawable_type (gint32 drawable_ID)
  * the drawable's type is simply returned.
  *
  * Returns: The drawable's type with alpha.
- */
+ **/
 GimpImageType
 gimp_drawable_type_with_alpha (gint32 drawable_ID)
 {
@@ -113,7 +113,7 @@ gimp_drawable_type_with_alpha (gint32 drawable_ID)
  * will be one of: { RGBA , GRAYA, INDEXEDA }.
  *
  * Returns: Does the drawable have an alpha channel?
- */
+ **/
 gboolean
 gimp_drawable_has_alpha (gint32 drawable_ID)
 {
@@ -144,7 +144,7 @@ gimp_drawable_has_alpha (gint32 drawable_ID)
  * RGB, RGBA }.
  *
  * Returns: TRUE if the drawable is an RGB type.
- */
+ **/
 gboolean
 gimp_drawable_is_rgb (gint32 drawable_ID)
 {
@@ -175,7 +175,7 @@ gimp_drawable_is_rgb (gint32 drawable_ID)
  * Gray, GrayA }.
  *
  * Returns: TRUE if the drawable is a grayscale type.
- */
+ **/
 gboolean
 gimp_drawable_is_gray (gint32 drawable_ID)
 {
@@ -206,7 +206,7 @@ gimp_drawable_is_gray (gint32 drawable_ID)
  * Indexed, IndexedA }.
  *
  * Returns: TRUE if the drawable is an indexed type.
- */
+ **/
 gboolean
 gimp_drawable_is_indexed (gint32 drawable_ID)
 {
@@ -237,7 +237,7 @@ gimp_drawable_is_indexed (gint32 drawable_ID)
  * of channels) for the specified drawable.
  *
  * Returns: Bytes per pixel.
- */
+ **/
 gint
 gimp_drawable_bpp (gint32 drawable_ID)
 {
@@ -267,7 +267,7 @@ gimp_drawable_bpp (gint32 drawable_ID)
  * This procedure returns the specified drawable's width in pixels.
  *
  * Returns: Width of drawable.
- */
+ **/
 gint
 gimp_drawable_width (gint32 drawable_ID)
 {
@@ -297,7 +297,7 @@ gimp_drawable_width (gint32 drawable_ID)
  * This procedure returns the specified drawable's height in pixels.
  *
  * Returns: Height of drawable.
- */
+ **/
 gint
 gimp_drawable_height (gint32 drawable_ID)
 {
@@ -331,7 +331,7 @@ gimp_drawable_height (gint32 drawable_ID)
  * The offsets of a channel will be returned as 0.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_drawable_offsets (gint32  drawable_ID,
                        gint   *offset_x,
@@ -370,7 +370,7 @@ gimp_drawable_offsets (gint32  drawable_ID,
  * Deprecated: There is no replacement for this procedure.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_drawable_set_image (gint32 drawable_ID,
                          gint32 image_ID)
@@ -417,7 +417,7 @@ gimp_drawable_set_image (gint32 drawable_ID,
  * return value which is more useful in most cases.
  *
  * Returns: TRUE if there is a selection.
- */
+ **/
 gboolean
 gimp_drawable_mask_bounds (gint32  drawable_ID,
                            gint   *x1,
@@ -468,7 +468,7 @@ gimp_drawable_mask_bounds (gint32  drawable_ID,
  * Returns: TRUE if the returned area is not empty.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_drawable_mask_intersect (gint32  drawable_ID,
                               gint   *x,
@@ -512,7 +512,7 @@ gimp_drawable_mask_intersect (gint32  drawable_ID,
  * Requesting no undo is useful for such applications as 'auto-apply'.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_drawable_merge_shadow (gint32   drawable_ID,
                             gboolean undo)
@@ -548,7 +548,7 @@ gimp_drawable_merge_shadow (gint32   drawable_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_drawable_free_shadow (gint32 drawable_ID)
 {
@@ -584,7 +584,7 @@ gimp_drawable_free_shadow (gint32 drawable_ID)
  * (0, 0, width, height).
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_drawable_update (gint32 drawable_ID,
                       gint   x,
@@ -626,7 +626,7 @@ gimp_drawable_update (gint32 drawable_ID,
  * bytes-per-pixel value for the specified drawable.
  *
  * Returns: The pixel value.
- */
+ **/
 guint8 *
 gimp_drawable_get_pixel (gint32  drawable_ID,
                          gint    x_coord,
@@ -677,7 +677,7 @@ gimp_drawable_get_pixel (gint32  drawable_ID,
  * just created yourself.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_drawable_set_pixel (gint32        drawable_ID,
                          gint          x_coord,
@@ -725,7 +725,7 @@ gimp_drawable_set_pixel (gint32        drawable_ID,
  * cannot be undone.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_drawable_fill (gint32       drawable_ID,
                     GimpFillType fill_type)
@@ -766,7 +766,7 @@ gimp_drawable_fill (gint32       drawable_ID,
  * specified by the 'fill-type' parameter.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_drawable_offset (gint32         drawable_ID,
                       gboolean       wrap_around,
@@ -813,7 +813,7 @@ gimp_drawable_offset (gint32         drawable_ID,
  * the number of bytes in the image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 _gimp_drawable_thumbnail (gint32   drawable_ID,
                           gint     width,
@@ -885,7 +885,7 @@ _gimp_drawable_thumbnail (gint32   drawable_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 _gimp_drawable_sub_thumbnail (gint32   drawable_ID,
                               gint     src_x,
@@ -954,7 +954,7 @@ _gimp_drawable_sub_thumbnail (gint32   drawable_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_drawable_foreground_extract (gint32                    drawable_ID,
                                   GimpForegroundExtractMode mode,
diff --git a/libgimp/gimpdrawabletransform_pdb.c b/libgimp/gimpdrawabletransform_pdb.c
index 4665580..037e81b 100644
--- a/libgimp/gimpdrawabletransform_pdb.c
+++ b/libgimp/gimpdrawabletransform_pdb.c
@@ -57,7 +57,7 @@
  * Returns: The flipped drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_flip_simple (gint32              drawable_ID,
                                      GimpOrientationType flip_type,
@@ -115,7 +115,7 @@ gimp_drawable_transform_flip_simple (gint32              drawable_ID,
  * Returns: The flipped drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_flip (gint32                 drawable_ID,
                               gdouble                x0,
@@ -173,7 +173,7 @@ gimp_drawable_transform_flip (gint32                 drawable_ID,
  * Returns: The flipped drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_flip_default (gint32   drawable_ID,
                                       gdouble  x0,
@@ -245,7 +245,7 @@ gimp_drawable_transform_flip_default (gint32   drawable_ID,
  * Returns: The newly mapped drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_perspective (gint32                 drawable_ID,
                                      gdouble                x0,
@@ -316,7 +316,7 @@ gimp_drawable_transform_perspective (gint32                 drawable_ID,
  * Returns: The newly mapped drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_perspective_default (gint32              drawable_ID,
                                              gdouble             x0,
@@ -380,7 +380,7 @@ gimp_drawable_transform_perspective_default (gint32              drawable_ID,
  * Returns: The rotated drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_rotate_simple (gint32           drawable_ID,
                                        GimpRotationType rotate_type,
@@ -438,7 +438,7 @@ gimp_drawable_transform_rotate_simple (gint32           drawable_ID,
  * Returns: The rotated drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_rotate (gint32                 drawable_ID,
                                 gdouble                angle,
@@ -497,7 +497,7 @@ gimp_drawable_transform_rotate (gint32                 drawable_ID,
  * Returns: The rotated drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_rotate_default (gint32              drawable_ID,
                                         gdouble             angle,
@@ -556,7 +556,7 @@ gimp_drawable_transform_rotate_default (gint32              drawable_ID,
  * Returns: The scaled drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_scale (gint32                 drawable_ID,
                                gdouble                x0,
@@ -614,7 +614,7 @@ gimp_drawable_transform_scale (gint32                 drawable_ID,
  * Returns: The scaled drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_scale_default (gint32              drawable_ID,
                                        gdouble             x0,
@@ -675,7 +675,7 @@ gimp_drawable_transform_scale_default (gint32              drawable_ID,
  * Returns: The sheared drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_shear (gint32                 drawable_ID,
                                GimpOrientationType    shear_type,
@@ -728,7 +728,7 @@ gimp_drawable_transform_shear (gint32                 drawable_ID,
  * Returns: The sheared drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_shear_default (gint32              drawable_ID,
                                        GimpOrientationType shear_type,
@@ -789,7 +789,7 @@ gimp_drawable_transform_shear_default (gint32              drawable_ID,
  * Returns: The transformed drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_2d (gint32                 drawable_ID,
                             gdouble                source_x,
@@ -856,7 +856,7 @@ gimp_drawable_transform_2d (gint32                 drawable_ID,
  * Returns: The transformed drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_2d_default (gint32              drawable_ID,
                                     gdouble             source_x,
@@ -927,7 +927,7 @@ gimp_drawable_transform_2d_default (gint32              drawable_ID,
  * Returns: The transformed drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_matrix (gint32                 drawable_ID,
                                 gdouble                coeff_0_0,
@@ -1000,7 +1000,7 @@ gimp_drawable_transform_matrix (gint32                 drawable_ID,
  * Returns: The transformed drawable.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_drawable_transform_matrix_default (gint32              drawable_ID,
                                         gdouble             coeff_0_0,
diff --git a/libgimp/gimpedit_pdb.c b/libgimp/gimpedit_pdb.c
index 18791d5..dcb86e0 100644
--- a/libgimp/gimpedit_pdb.c
+++ b/libgimp/gimpedit_pdb.c
@@ -50,7 +50,7 @@
  * there is nothing to copy from.
  *
  * Returns: TRUE if the cut was successful, FALSE if there was nothing to copy from.
- */
+ **/
 gboolean
 gimp_edit_cut (gint32 drawable_ID)
 {
@@ -87,7 +87,7 @@ gimp_edit_cut (gint32 drawable_ID)
  * nothing to copy from.
  *
  * Returns: TRUE if the cut was successful, FALSE if there was nothing to copy from.
- */
+ **/
 gboolean
 gimp_edit_copy (gint32 drawable_ID)
 {
@@ -124,7 +124,7 @@ gimp_edit_copy (gint32 drawable_ID)
  * Returns: TRUE if the copy was successful.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_edit_copy_visible (gint32 image_ID)
 {
@@ -169,7 +169,7 @@ gimp_edit_copy_visible (gint32 image_ID)
  * not needed.
  *
  * Returns: The new floating selection.
- */
+ **/
 gint32
 gimp_edit_paste (gint32   drawable_ID,
                  gboolean paste_into)
@@ -205,7 +205,7 @@ gimp_edit_paste (gint32   drawable_ID,
  * Returns: The new image.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint32
 gimp_edit_paste_as_new (void)
 {
@@ -240,7 +240,7 @@ gimp_edit_paste_as_new (void)
  * Returns: The real name given to the buffer, or NULL if the cut failed.
  *
  * Since: GIMP 2.4
- */
+ **/
 gchar *
 gimp_edit_named_cut (gint32       drawable_ID,
                      const gchar *buffer_name)
@@ -278,7 +278,7 @@ gimp_edit_named_cut (gint32       drawable_ID,
  * Returns: The real name given to the buffer, or NULL if the copy failed.
  *
  * Since: GIMP 2.4
- */
+ **/
 gchar *
 gimp_edit_named_copy (gint32       drawable_ID,
                       const gchar *buffer_name)
@@ -316,7 +316,7 @@ gimp_edit_named_copy (gint32       drawable_ID,
  * Returns: The real name given to the buffer, or NULL if the copy failed.
  *
  * Since: GIMP 2.4
- */
+ **/
 gchar *
 gimp_edit_named_copy_visible (gint32       image_ID,
                               const gchar *buffer_name)
@@ -353,7 +353,7 @@ gimp_edit_named_copy_visible (gint32       image_ID,
  * Returns: The new floating selection.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint32
 gimp_edit_named_paste (gint32       drawable_ID,
                        const gchar *buffer_name,
@@ -390,7 +390,7 @@ gimp_edit_named_paste (gint32       drawable_ID,
  * Returns: The new image.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint32
 gimp_edit_named_paste_as_new (const gchar *buffer_name)
 {
@@ -424,7 +424,7 @@ gimp_edit_named_paste_as_new (const gchar *buffer_name)
  * a selection if there is a selection active.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_edit_clear (gint32 drawable_ID)
 {
@@ -460,7 +460,7 @@ gimp_edit_clear (gint32 drawable_ID)
  * use gimp_drawable_fill().
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_edit_fill (gint32       drawable_ID,
                 GimpFillType fill_type)
@@ -510,7 +510,7 @@ gimp_edit_fill (gint32       drawable_ID,
  * relative to the drawable's origin.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_edit_bucket_fill (gint32               drawable_ID,
                        GimpBucketFillMode   fill_mode,
@@ -576,7 +576,7 @@ gimp_edit_bucket_fill (gint32               drawable_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_edit_bucket_fill_full (gint32               drawable_ID,
                             GimpBucketFillMode   fill_mode,
@@ -642,7 +642,7 @@ gimp_edit_bucket_fill_full (gint32               drawable_ID,
  * each gradient type.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_edit_blend (gint32               drawable_ID,
                  GimpBlendMode        blend_mode,
@@ -704,7 +704,7 @@ gimp_edit_blend (gint32               drawable_ID,
  * selection.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_edit_stroke (gint32 drawable_ID)
 {
@@ -737,7 +737,7 @@ gimp_edit_stroke (gint32 drawable_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_edit_stroke_vectors (gint32 drawable_ID,
                           gint32 vectors_ID)
diff --git a/libgimp/gimpfileops_pdb.c b/libgimp/gimpfileops_pdb.c
index c1e9d7b..7d24819 100644
--- a/libgimp/gimpfileops_pdb.c
+++ b/libgimp/gimpfileops_pdb.c
@@ -53,7 +53,7 @@
  * will not look like a URL.\"
  *
  * Returns: The output image.
- */
+ **/
 gint32
 gimp_file_load (GimpRunMode  run_mode,
                 const gchar *filename,
@@ -94,7 +94,7 @@ gimp_file_load (GimpRunMode  run_mode,
  * Returns: The layer created when loading the image file.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint32
 gimp_file_load_layer (GimpRunMode  run_mode,
                       gint32       image_ID,
@@ -136,7 +136,7 @@ gimp_file_load_layer (GimpRunMode  run_mode,
  * Returns: The list of loaded layers.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint *
 gimp_file_load_layers (GimpRunMode  run_mode,
                        gint32       image_ID,
@@ -188,7 +188,7 @@ gimp_file_load_layers (GimpRunMode  run_mode,
  * fetch a URL, and the full pathname will not look like a URL.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_file_save (GimpRunMode  run_mode,
                 gint32       image_ID,
@@ -231,7 +231,7 @@ gimp_file_save (GimpRunMode  run_mode,
  * explicitely save a thumbnail with a file.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_file_save_thumbnail (gint32       image_ID,
                           const gchar *filename)
@@ -263,7 +263,7 @@ gimp_file_save_thumbnail (gint32       image_ID,
  * user's gimprc.
  *
  * Returns: The new temp filename.
- */
+ **/
 gchar *
 gimp_temp_name (const gchar *extension)
 {
@@ -297,7 +297,7 @@ gimp_temp_name (const gchar *extension)
  * of a particular file format using magic file information.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_register_magic_load_handler (const gchar *procedure_name,
                                   const gchar *extensions,
@@ -335,7 +335,7 @@ gimp_register_magic_load_handler (const gchar *procedure_name,
  * of a particular file format.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_register_load_handler (const gchar *procedure_name,
                             const gchar *extensions,
@@ -371,7 +371,7 @@ gimp_register_load_handler (const gchar *procedure_name,
  * in a particular file format.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_register_save_handler (const gchar *procedure_name,
                             const gchar *extensions,
@@ -409,7 +409,7 @@ gimp_register_save_handler (const gchar *procedure_name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_register_file_handler_mime (const gchar *procedure_name,
                                  const gchar *mime_type)
@@ -448,7 +448,7 @@ gimp_register_file_handler_mime (const gchar *procedure_name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_register_thumbnail_loader (const gchar *load_proc,
                                 const gchar *thumb_proc)
diff --git a/libgimp/gimpfloatingsel_pdb.c b/libgimp/gimpfloatingsel_pdb.c
index dd8411f..561594c 100644
--- a/libgimp/gimpfloatingsel_pdb.c
+++ b/libgimp/gimpfloatingsel_pdb.c
@@ -48,7 +48,7 @@
  * any side effects. The associated drawable is then set to active.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_floating_sel_remove (gint32 floating_sel_ID)
 {
@@ -80,7 +80,7 @@ gimp_floating_sel_remove (gint32 floating_sel_ID)
  * after this operation.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_floating_sel_anchor (gint32 floating_sel_ID)
 {
@@ -116,7 +116,7 @@ gimp_floating_sel_anchor (gint32 floating_sel_ID)
  * selection is above an auxillary channel or a layer mask.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_floating_sel_to_layer (gint32 floating_sel_ID)
 {
@@ -147,7 +147,7 @@ gimp_floating_sel_to_layer (gint32 floating_sel_ID)
  * drawable.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_floating_sel_attach (gint32 layer_ID,
                           gint32 drawable_ID)
@@ -177,7 +177,7 @@ gimp_floating_sel_attach (gint32 layer_ID,
  * Deprecated: There is no replacement for this procedure.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_floating_sel_rigor (gint32   floating_sel_ID,
                          gboolean undo)
@@ -207,7 +207,7 @@ gimp_floating_sel_rigor (gint32   floating_sel_ID,
  * Deprecated: There is no replacement for this procedure.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_floating_sel_relax (gint32   floating_sel_ID,
                          gboolean undo)
diff --git a/libgimp/gimpfonts_pdb.c b/libgimp/gimpfonts_pdb.c
index ca3ee3a..7753af2 100644
--- a/libgimp/gimpfonts_pdb.c
+++ b/libgimp/gimpfonts_pdb.c
@@ -43,7 +43,7 @@
  * and updates the font dialogs accordingly.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_fonts_refresh (void)
 {
@@ -73,7 +73,7 @@ gimp_fonts_refresh (void)
  * available.
  *
  * Returns: The list of font names.
- */
+ **/
 gchar **
 gimp_fonts_get_list (const gchar *filter,
                      gint        *num_fonts)
diff --git a/libgimp/gimpfontselect_pdb.c b/libgimp/gimpfontselect_pdb.c
index aea1556..f25b957 100644
--- a/libgimp/gimpfontselect_pdb.c
+++ b/libgimp/gimpfontselect_pdb.c
@@ -45,7 +45,7 @@
  * This procedure opens the font selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_fonts_popup (const gchar *font_callback,
                   const gchar *popup_title,
@@ -78,7 +78,7 @@ gimp_fonts_popup (const gchar *font_callback,
  * This procedure closes an opened font selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_fonts_close_popup (const gchar *font_callback)
 {
@@ -108,7 +108,7 @@ gimp_fonts_close_popup (const gchar *font_callback)
  * Sets the current font in a font selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_fonts_set_popup (const gchar *font_callback,
                       const gchar *font_name)
diff --git a/libgimp/gimpgimprc_pdb.c b/libgimp/gimpgimprc_pdb.c
index b67846d..7aea43a 100644
--- a/libgimp/gimpgimprc_pdb.c
+++ b/libgimp/gimpgimprc_pdb.c
@@ -51,7 +51,7 @@
  * to be issued on gimprc parsing and will not be queryable.
  *
  * Returns: The value associated with the queried token.
- */
+ **/
 gchar *
 gimp_gimprc_query (const gchar *token)
 {
@@ -86,7 +86,7 @@ gimp_gimprc_query (const gchar *token)
  * will accept _only_ string values in UTF-8 encoding.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_gimprc_set (const gchar *token,
                  const gchar *value)
@@ -116,7 +116,7 @@ gimp_gimprc_set (const gchar *token,
  * Returns a copy of the default image comment.
  *
  * Returns: Default image comment.
- */
+ **/
 gchar *
 gimp_get_default_comment (void)
 {
@@ -146,7 +146,7 @@ gimp_get_default_comment (void)
  * Returns: Default unit.
  *
  * Since: GIMP 2.4
- */
+ **/
 GimpUnit
 gimp_get_default_unit (void)
 {
@@ -179,7 +179,7 @@ gimp_get_default_unit (void)
  * reasonable.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_get_monitor_resolution (gdouble *xres,
                              gdouble *yres)
@@ -216,7 +216,7 @@ gimp_get_monitor_resolution (gdouble *xres,
  * Returns a copy of the current GUI theme dir.
  *
  * Returns: The GUI theme dir.
- */
+ **/
 gchar *
 gimp_get_theme_dir (void)
 {
@@ -247,7 +247,7 @@ gimp_get_theme_dir (void)
  * Returns: Serialized color management configuration.
  *
  * Since: GIMP 2.4
- */
+ **/
 gchar *
 _gimp_get_color_configuration (void)
 {
@@ -275,7 +275,7 @@ _gimp_get_color_configuration (void)
  * Returns a copy of the list of modules which should not be loaded.
  *
  * Returns: The list of modules.
- */
+ **/
 gchar *
 gimp_get_module_load_inhibit (void)
 {
diff --git a/libgimp/gimpgradient_pdb.c b/libgimp/gimpgradient_pdb.c
index bb86279..f78776e 100644
--- a/libgimp/gimpgradient_pdb.c
+++ b/libgimp/gimpgradient_pdb.c
@@ -47,7 +47,7 @@
  * Returns: The actual new gradient name.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_gradient_new (const gchar *name)
 {
@@ -79,7 +79,7 @@ gimp_gradient_new (const gchar *name)
  * Returns: The name of the gradient's copy.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_gradient_duplicate (const gchar *name)
 {
@@ -111,7 +111,7 @@ gimp_gradient_duplicate (const gchar *name)
  * Returns: TRUE if the gradient can be edited.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_gradient_is_editable (const gchar *name)
 {
@@ -144,7 +144,7 @@ gimp_gradient_is_editable (const gchar *name)
  * Returns: The actual new name of the gradient.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_gradient_rename (const gchar *name,
                       const gchar *new_name)
@@ -178,7 +178,7 @@ gimp_gradient_rename (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_delete (const gchar *name)
 {
@@ -210,7 +210,7 @@ gimp_gradient_delete (const gchar *name)
  * Returns: Number of segments.
  *
  * Since: GIMP 2.6
- */
+ **/
 gint
 gimp_gradient_get_number_of_segments (const gchar *name)
 {
@@ -252,7 +252,7 @@ gimp_gradient_get_number_of_segments (const gchar *name)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_get_uniform_samples (const gchar  *name,
                                    gint          num_samples,
@@ -311,7 +311,7 @@ gimp_gradient_get_uniform_samples (const gchar  *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_get_custom_samples (const gchar    *name,
                                   gint            num_samples,
@@ -366,7 +366,7 @@ gimp_gradient_get_custom_samples (const gchar    *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_get_left_color (const gchar *name,
                                       gint         segment,
@@ -413,7 +413,7 @@ gimp_gradient_segment_get_left_color (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_set_left_color (const gchar   *name,
                                       gint           segment,
@@ -454,7 +454,7 @@ gimp_gradient_segment_set_left_color (const gchar   *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_get_right_color (const gchar *name,
                                        gint         segment,
@@ -501,7 +501,7 @@ gimp_gradient_segment_get_right_color (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_set_right_color (const gchar   *name,
                                        gint           segment,
@@ -541,7 +541,7 @@ gimp_gradient_segment_set_right_color (const gchar   *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_get_left_pos (const gchar *name,
                                     gint         segment,
@@ -587,7 +587,7 @@ gimp_gradient_segment_get_left_pos (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_set_left_pos (const gchar *name,
                                     gint         segment,
@@ -631,7 +631,7 @@ gimp_gradient_segment_set_left_pos (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_get_middle_pos (const gchar *name,
                                       gint         segment,
@@ -676,7 +676,7 @@ gimp_gradient_segment_get_middle_pos (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_set_middle_pos (const gchar *name,
                                       gint         segment,
@@ -720,7 +720,7 @@ gimp_gradient_segment_set_middle_pos (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_get_right_pos (const gchar *name,
                                      gint         segment,
@@ -766,7 +766,7 @@ gimp_gradient_segment_get_right_pos (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_set_right_pos (const gchar *name,
                                      gint         segment,
@@ -810,7 +810,7 @@ gimp_gradient_segment_set_right_pos (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_get_blending_function (const gchar             *name,
                                              gint                     segment,
@@ -852,7 +852,7 @@ gimp_gradient_segment_get_blending_function (const gchar             *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_get_coloring_type (const gchar              *name,
                                          gint                      segment,
@@ -895,7 +895,7 @@ gimp_gradient_segment_get_coloring_type (const gchar              *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_range_set_blending_function (const gchar             *name,
                                                    gint                     start_segment,
@@ -936,7 +936,7 @@ gimp_gradient_segment_range_set_blending_function (const gchar             *name
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_range_set_coloring_type (const gchar              *name,
                                                gint                      start_segment,
@@ -975,7 +975,7 @@ gimp_gradient_segment_range_set_coloring_type (const gchar              *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_range_flip (const gchar *name,
                                   gint         start_segment,
@@ -1015,7 +1015,7 @@ gimp_gradient_segment_range_flip (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_range_replicate (const gchar *name,
                                        gint         start_segment,
@@ -1055,7 +1055,7 @@ gimp_gradient_segment_range_replicate (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_range_split_midpoint (const gchar *name,
                                             gint         start_segment,
@@ -1094,7 +1094,7 @@ gimp_gradient_segment_range_split_midpoint (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_range_split_uniform (const gchar *name,
                                            gint         start_segment,
@@ -1133,7 +1133,7 @@ gimp_gradient_segment_range_split_uniform (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_range_delete (const gchar *name,
                                     gint         start_segment,
@@ -1171,7 +1171,7 @@ gimp_gradient_segment_range_delete (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_range_redistribute_handles (const gchar *name,
                                                   gint         start_segment,
@@ -1210,7 +1210,7 @@ gimp_gradient_segment_range_redistribute_handles (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_range_blend_colors (const gchar *name,
                                           gint         start_segment,
@@ -1249,7 +1249,7 @@ gimp_gradient_segment_range_blend_colors (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_gradient_segment_range_blend_opacity (const gchar *name,
                                            gint         start_segment,
@@ -1290,7 +1290,7 @@ gimp_gradient_segment_range_blend_opacity (const gchar *name,
  * Returns: The final delta by which the range moved.
  *
  * Since: GIMP 2.2
- */
+ **/
 gdouble
 gimp_gradient_segment_range_move (const gchar *name,
                                   gint         start_segment,
diff --git a/libgimp/gimpgradients_pdb.c b/libgimp/gimpgradients_pdb.c
index f325058..be71d91 100644
--- a/libgimp/gimpgradients_pdb.c
+++ b/libgimp/gimpgradients_pdb.c
@@ -48,7 +48,7 @@
  * gradient path and updates the gradient dialogs accordingly.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_gradients_refresh (void)
 {
@@ -79,7 +79,7 @@ gimp_gradients_refresh (void)
  * to set the active gradient.
  *
  * Returns: The list of gradient names.
- */
+ **/
 gchar **
 gimp_gradients_get_list (const gchar *filter,
                          gint        *num_gradients)
@@ -117,7 +117,7 @@ gimp_gradients_get_list (const gchar *filter,
  * Deprecated: Use gimp_gradient_get_uniform_samples() instead.
  *
  * Returns: Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
- */
+ **/
 gdouble *
 gimp_gradients_sample_uniform (gint     num_samples,
                                gboolean reverse)
@@ -156,7 +156,7 @@ gimp_gradients_sample_uniform (gint     num_samples,
  * Deprecated: Use gimp_gradient_get_custom_samples() instead.
  *
  * Returns: Color samples: { R1, G1, B1, A1, ..., Rn, Gn, Bn, An }.
- */
+ **/
 gdouble *
 gimp_gradients_sample_custom (gint           num_samples,
                               const gdouble *positions,
@@ -199,7 +199,7 @@ gimp_gradients_sample_custom (gint           num_samples,
  * Deprecated: Use gimp_gradient_get_uniform_samples() instead.
  *
  * Returns: The gradient name.
- */
+ **/
 gchar *
 gimp_gradients_get_gradient_data (const gchar  *name,
                                   gint          sample_size,
diff --git a/libgimp/gimpgradientselect_pdb.c b/libgimp/gimpgradientselect_pdb.c
index 624d3c8..5f5417c 100644
--- a/libgimp/gimpgradientselect_pdb.c
+++ b/libgimp/gimpgradientselect_pdb.c
@@ -46,7 +46,7 @@
  * This procedure opens the gradient selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_gradients_popup (const gchar *gradient_callback,
                       const gchar *popup_title,
@@ -81,7 +81,7 @@ gimp_gradients_popup (const gchar *gradient_callback,
  * This procedure closes an opened gradient selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_gradients_close_popup (const gchar *gradient_callback)
 {
@@ -111,7 +111,7 @@ gimp_gradients_close_popup (const gchar *gradient_callback)
  * Sets the current gradient in a gradient selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_gradients_set_popup (const gchar *gradient_callback,
                           const gchar *gradient_name)
diff --git a/libgimp/gimpgrid_pdb.c b/libgimp/gimpgrid_pdb.c
index a716381..f815f49 100644
--- a/libgimp/gimpgrid_pdb.c
+++ b/libgimp/gimpgrid_pdb.c
@@ -48,7 +48,7 @@
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_grid_get_spacing (gint32   image_ID,
                              gdouble *xspacing,
@@ -93,7 +93,7 @@ gimp_image_grid_get_spacing (gint32   image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_grid_set_spacing (gint32  image_ID,
                              gdouble xspacing,
@@ -131,7 +131,7 @@ gimp_image_grid_set_spacing (gint32  image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_grid_get_offset (gint32   image_ID,
                             gdouble *xoffset,
@@ -176,7 +176,7 @@ gimp_image_grid_get_offset (gint32   image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_grid_set_offset (gint32  image_ID,
                             gdouble xoffset,
@@ -212,7 +212,7 @@ gimp_image_grid_set_offset (gint32  image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_grid_get_foreground_color (gint32   image_ID,
                                       GimpRGB *fgcolor)
@@ -248,7 +248,7 @@ gimp_image_grid_get_foreground_color (gint32   image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_grid_set_foreground_color (gint32         image_ID,
                                       const GimpRGB *fgcolor)
@@ -282,7 +282,7 @@ gimp_image_grid_set_foreground_color (gint32         image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_grid_get_background_color (gint32   image_ID,
                                       GimpRGB *bgcolor)
@@ -318,7 +318,7 @@ gimp_image_grid_get_background_color (gint32   image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_grid_set_background_color (gint32         image_ID,
                                       const GimpRGB *bgcolor)
@@ -351,7 +351,7 @@ gimp_image_grid_set_background_color (gint32         image_ID,
  * Returns: The image's grid style.
  *
  * Since: GIMP 2.4
- */
+ **/
 GimpGridStyle
 gimp_image_grid_get_style (gint32 image_ID)
 {
@@ -385,7 +385,7 @@ gimp_image_grid_get_style (gint32 image_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_grid_set_style (gint32        image_ID,
                            GimpGridStyle style)
diff --git a/libgimp/gimpguides_pdb.c b/libgimp/gimpguides_pdb.c
index 398e486..ff7c2fe 100644
--- a/libgimp/gimpguides_pdb.c
+++ b/libgimp/gimpguides_pdb.c
@@ -46,7 +46,7 @@
  * returns the guide ID of the new guide.
  *
  * Returns: The new guide.
- */
+ **/
 gint32
 gimp_image_add_hguide (gint32 image_ID,
                        gint   yposition)
@@ -81,7 +81,7 @@ gimp_image_add_hguide (gint32 image_ID,
  * the guide ID of the new guide.
  *
  * Returns: The new guide.
- */
+ **/
 gint32
 gimp_image_add_vguide (gint32 image_ID,
                        gint   xposition)
@@ -115,7 +115,7 @@ gimp_image_add_vguide (gint32 image_ID,
  * the specified guide from the specified image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_delete_guide (gint32 image_ID,
                          gint32 guide_ID)
@@ -151,7 +151,7 @@ gimp_image_delete_guide (gint32 image_ID,
  * as an argument or the image has no guides.
  *
  * Returns: The next guide's ID.
- */
+ **/
 gint32
 gimp_image_find_next_guide (gint32 image_ID,
                             gint32 guide_ID)
@@ -185,7 +185,7 @@ gimp_image_find_next_guide (gint32 image_ID,
  * the orientations of the guide.
  *
  * Returns: The guide's orientation.
- */
+ **/
 GimpOrientationType
 gimp_image_get_guide_orientation (gint32 image_ID,
                                   gint32 guide_ID)
@@ -219,7 +219,7 @@ gimp_image_get_guide_orientation (gint32 image_ID,
  * the position of the guide relative to the top or left of the image.
  *
  * Returns: The guide's position relative to top or left of image.
- */
+ **/
 gint
 gimp_image_get_guide_position (gint32 image_ID,
                                gint32 guide_ID)
diff --git a/libgimp/gimphelp_pdb.c b/libgimp/gimphelp_pdb.c
index 1c1def8..bbe7b7a 100644
--- a/libgimp/gimphelp_pdb.c
+++ b/libgimp/gimphelp_pdb.c
@@ -49,7 +49,7 @@
  * the help domain of the main GIMP installation is used.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_help (const gchar *help_domain,
            const gchar *help_id)
diff --git a/libgimp/gimpimage_pdb.c b/libgimp/gimpimage_pdb.c
index 9b288ea..c0dd7ec 100644
--- a/libgimp/gimpimage_pdb.c
+++ b/libgimp/gimpimage_pdb.c
@@ -52,7 +52,7 @@
  * Returns: Whether the image ID is valid.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_is_valid (gint32 image_ID)
 {
@@ -82,7 +82,7 @@ gimp_image_is_valid (gint32 image_ID)
  * This procedure returns the list of images currently open in GIMP.
  *
  * Returns: The list of images currently open.
- */
+ **/
 gint *
 gimp_image_list (gint *num_images)
 {
@@ -126,7 +126,7 @@ gimp_image_list (gint *num_images)
  * gimp_image_insert_layer() command.
  *
  * Returns: The ID of the newly created image.
- */
+ **/
 gint32
 gimp_image_new (gint              width,
                 gint              height,
@@ -161,7 +161,7 @@ gimp_image_new (gint              width,
  * channels, and image information.
  *
  * Returns: The new, duplicated image.
- */
+ **/
 gint32
 gimp_image_duplicate (gint32 image_ID)
 {
@@ -196,7 +196,7 @@ gimp_image_duplicate (gint32 image_ID)
  * the image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_delete (gint32 image_ID)
 {
@@ -226,7 +226,7 @@ gimp_image_delete (gint32 image_ID)
  * must be of this subtype, but can have an optional alpha channel.
  *
  * Returns: The image's base type.
- */
+ **/
 GimpImageBaseType
 gimp_image_base_type (gint32 image_ID)
 {
@@ -257,7 +257,7 @@ gimp_image_base_type (gint32 image_ID)
  * of any of the layers in this image. This is the \"canvas\" width.
  *
  * Returns: The image's width.
- */
+ **/
 gint
 gimp_image_width (gint32 image_ID)
 {
@@ -288,7 +288,7 @@ gimp_image_width (gint32 image_ID)
  * of any of the layers in this image. This is the \"canvas\" height.
  *
  * Returns: The image's height.
- */
+ **/
 gint
 gimp_image_height (gint32 image_ID)
 {
@@ -316,7 +316,7 @@ gimp_image_height (gint32 image_ID)
  * Deprecated: Use gimp_drawable_free_shadow() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_free_shadow (gint32 image_ID)
 {
@@ -355,7 +355,7 @@ gimp_image_free_shadow (gint32 image_ID)
  * offsets.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_resize (gint32 image_ID,
                    gint   new_width,
@@ -397,7 +397,7 @@ gimp_image_resize (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_image_resize_to_layers (gint32 image_ID)
 {
@@ -432,7 +432,7 @@ gimp_image_resize_to_layers (gint32 image_ID)
  * is used.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_scale (gint32 image_ID,
                   gint   new_width,
@@ -474,7 +474,7 @@ gimp_image_scale (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_image_scale_full (gint32                image_ID,
                        gint                  new_width,
@@ -518,7 +518,7 @@ gimp_image_scale_full (gint32                image_ID,
  * range, an error is returned.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_crop (gint32 image_ID,
                  gint   new_width,
@@ -556,7 +556,7 @@ gimp_image_crop (gint32 image_ID,
  * This procedure flips (mirrors) the image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_flip (gint32              image_ID,
                  GimpOrientationType flip_type)
@@ -588,7 +588,7 @@ gimp_image_flip (gint32              image_ID,
  * This procedure rotates the image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_rotate (gint32           image_ID,
                    GimpRotationType rotate_type)
@@ -621,7 +621,7 @@ gimp_image_rotate (gint32           image_ID,
  * image. The order of layers is from topmost to bottommost.
  *
  * Returns: The list of layers contained in the image.
- */
+ **/
 gint *
 gimp_image_get_layers (gint32  image_ID,
                        gint   *num_layers)
@@ -663,7 +663,7 @@ gimp_image_get_layers (gint32  image_ID,
  * masks. The order is from topmost to bottommost.
  *
  * Returns: The list of channels contained in the image.
- */
+ **/
 gint *
 gimp_image_get_channels (gint32  image_ID,
                          gint   *num_channels)
@@ -706,7 +706,7 @@ gimp_image_get_channels (gint32  image_ID,
  * Returns: The list of vectors contained in the image.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint *
 gimp_image_get_vectors (gint32  image_ID,
                         gint   *num_vectors)
@@ -750,7 +750,7 @@ gimp_image_get_vectors (gint32  image_ID,
  * is the active drawable.
  *
  * Returns: The active drawable.
- */
+ **/
 gint32
 gimp_image_get_active_drawable (gint32 image_ID)
 {
@@ -783,7 +783,7 @@ gimp_image_get_active_drawable (gint32 image_ID)
  * existing active channel.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_unset_active_channel (gint32 image_ID)
 {
@@ -813,7 +813,7 @@ gimp_image_unset_active_channel (gint32 image_ID)
  * If it doesn't exist, -1 is returned as the layer ID.
  *
  * Returns: The image's floating selection.
- */
+ **/
 gint32
 gimp_image_get_floating_sel (gint32 image_ID)
 {
@@ -845,7 +845,7 @@ gimp_image_get_floating_sel (gint32 image_ID)
  * the drawable ID.
  *
  * Returns: The drawable the floating selection is attached to.
- */
+ **/
 gint32
 gimp_image_floating_sel_attached_to (gint32 image_ID)
 {
@@ -892,7 +892,7 @@ gimp_image_floating_sel_attached_to (gint32 image_ID)
  * a merged sampling, the supplied drawable is ignored.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_pick_color (gint32    image_ID,
                        gint32    drawable_ID,
@@ -943,7 +943,7 @@ gimp_image_pick_color (gint32    image_ID,
  * layer is found.
  *
  * Returns: The layer found at the specified coordinates.
- */
+ **/
 gint32
 gimp_image_pick_correlate_layer (gint32 image_ID,
                                  gint   x,
@@ -977,7 +977,7 @@ gimp_image_pick_correlate_layer (gint32 image_ID,
  * Deprecated: Use gimp_image_insert_layer() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_add_layer (gint32 image_ID,
                       gint32 layer_ID,
@@ -1022,7 +1022,7 @@ gimp_image_add_layer (gint32 image_ID,
  * layer. The layer type must be compatible with the image base type.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_insert_layer (gint32 image_ID,
                          gint32 layer_ID,
@@ -1062,7 +1062,7 @@ gimp_image_insert_layer (gint32 image_ID,
  * layer.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_remove_layer (gint32 image_ID,
                          gint32 layer_ID)
@@ -1093,7 +1093,7 @@ gimp_image_remove_layer (gint32 image_ID,
  * Deprecated: Use gimp_image_insert_channel() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_add_channel (gint32 image_ID,
                         gint32 channel_ID,
@@ -1134,7 +1134,7 @@ gimp_image_add_channel (gint32 image_ID,
  * channel is inserted above the active channel.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_insert_channel (gint32 image_ID,
                            gint32 channel_ID,
@@ -1171,7 +1171,7 @@ gimp_image_insert_channel (gint32 image_ID,
  * channel doesn't exist, an error is returned.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_remove_channel (gint32 image_ID,
                            gint32 channel_ID)
@@ -1202,7 +1202,7 @@ gimp_image_remove_channel (gint32 image_ID,
  * Deprecated: Use gimp_image_insert_vectors() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_add_vectors (gint32 image_ID,
                         gint32 vectors_ID,
@@ -1243,7 +1243,7 @@ gimp_image_add_vectors (gint32 image_ID,
  * vectors is inserted above the active vectors.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_insert_vectors (gint32 image_ID,
                            gint32 vectors_ID,
@@ -1282,7 +1282,7 @@ gimp_image_insert_vectors (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_remove_vectors (gint32 image_ID,
                            gint32 vectors_ID)
@@ -1319,7 +1319,7 @@ gimp_image_remove_vectors (gint32 image_ID,
  * Returns: The position of the item in its level in the item tree.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint
 gimp_image_get_item_position (gint32 image_ID,
                               gint32 item_ID)
@@ -1355,7 +1355,7 @@ gimp_image_get_item_position (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_image_raise_item (gint32 image_ID,
                        gint32 item_ID)
@@ -1390,7 +1390,7 @@ gimp_image_raise_item (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_image_lower_item (gint32 image_ID,
                        gint32 item_ID)
@@ -1425,7 +1425,7 @@ gimp_image_lower_item (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_image_raise_item_to_top (gint32 image_ID,
                               gint32 item_ID)
@@ -1461,7 +1461,7 @@ gimp_image_raise_item_to_top (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_image_lower_item_to_bottom (gint32 image_ID,
                                  gint32 item_ID)
@@ -1497,7 +1497,7 @@ gimp_image_lower_item_to_bottom (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_image_reorder_item (gint32 image_ID,
                          gint32 item_ID,
@@ -1533,7 +1533,7 @@ gimp_image_reorder_item (gint32 image_ID,
  * Returns: The position of the layer in the layer stack.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_image_get_layer_position (gint32 image_ID,
                                gint32 layer_ID)
@@ -1564,7 +1564,7 @@ gimp_image_get_layer_position (gint32 image_ID,
  * Deprecated: Use gimp_image_raise_item() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_raise_layer (gint32 image_ID,
                         gint32 layer_ID)
@@ -1594,7 +1594,7 @@ gimp_image_raise_layer (gint32 image_ID,
  * Deprecated: Use gimp_image_lower_item() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_lower_layer (gint32 image_ID,
                         gint32 layer_ID)
@@ -1624,7 +1624,7 @@ gimp_image_lower_layer (gint32 image_ID,
  * Deprecated: Use gimp_image_raise_item_to_top() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_raise_layer_to_top (gint32 image_ID,
                                gint32 layer_ID)
@@ -1654,7 +1654,7 @@ gimp_image_raise_layer_to_top (gint32 image_ID,
  * Deprecated: Use gimp_image_lower_item_to_bottom() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_lower_layer_to_bottom (gint32 image_ID,
                                   gint32 layer_ID)
@@ -1686,7 +1686,7 @@ gimp_image_lower_layer_to_bottom (gint32 image_ID,
  * Returns: The position of the channel in the channel stack.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_image_get_channel_position (gint32 image_ID,
                                  gint32 channel_ID)
@@ -1717,7 +1717,7 @@ gimp_image_get_channel_position (gint32 image_ID,
  * Deprecated: Use gimp_image_raise_item() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_raise_channel (gint32 image_ID,
                           gint32 channel_ID)
@@ -1747,7 +1747,7 @@ gimp_image_raise_channel (gint32 image_ID,
  * Deprecated: Use gimp_image_lower_item() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_lower_channel (gint32 image_ID,
                           gint32 channel_ID)
@@ -1779,7 +1779,7 @@ gimp_image_lower_channel (gint32 image_ID,
  * Returns: The position of the vectors object in the vectors stack.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_image_get_vectors_position (gint32 image_ID,
                                  gint32 vectors_ID)
@@ -1812,7 +1812,7 @@ gimp_image_get_vectors_position (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_raise_vectors (gint32 image_ID,
                           gint32 vectors_ID)
@@ -1844,7 +1844,7 @@ gimp_image_raise_vectors (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_lower_vectors (gint32 image_ID,
                           gint32 vectors_ID)
@@ -1876,7 +1876,7 @@ gimp_image_lower_vectors (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_raise_vectors_to_top (gint32 image_ID,
                                  gint32 vectors_ID)
@@ -1908,7 +1908,7 @@ gimp_image_raise_vectors_to_top (gint32 image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_image_lower_vectors_to_bottom (gint32 image_ID,
                                     gint32 vectors_ID)
@@ -1942,7 +1942,7 @@ gimp_image_lower_vectors_to_bottom (gint32 image_ID,
  * discarded, and the resulting image is stripped of its alpha channel.
  *
  * Returns: The resulting layer.
- */
+ **/
 gint32
 gimp_image_flatten (gint32 image_ID)
 {
@@ -1978,7 +1978,7 @@ gimp_image_flatten (gint32 image_ID)
  * final layer to the size of the bottommost layer.
  *
  * Returns: The resulting layer.
- */
+ **/
 gint32
 gimp_image_merge_visible_layers (gint32        image_ID,
                                  GimpMergeType merge_type)
@@ -2018,7 +2018,7 @@ gimp_image_merge_visible_layers (gint32        image_ID,
  * bottommost layer.
  *
  * Returns: The resulting layer.
- */
+ **/
 gint32
 gimp_image_merge_down (gint32        image_ID,
                        gint32        merge_layer_ID,
@@ -2057,7 +2057,7 @@ gimp_image_merge_down (gint32        image_ID,
  * returned.
  *
  * Returns: The image's colormap.
- */
+ **/
 guint8 *
 _gimp_image_get_colormap (gint32  image_ID,
                           gint   *num_bytes)
@@ -2102,7 +2102,7 @@ _gimp_image_get_colormap (gint32  image_ID,
  * colormap is 'num-bytes' / 3.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 _gimp_image_set_colormap (gint32        image_ID,
                           gint          num_bytes,
@@ -2140,7 +2140,7 @@ _gimp_image_set_colormap (gint32        image_ID,
  * call this function themselves after saving the image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_clean_all (gint32 image_ID)
 {
@@ -2172,7 +2172,7 @@ gimp_image_clean_all (gint32 image_ID)
  * after calling a save procedure to make the image clean.
  *
  * Returns: TRUE if the image has unsaved changes.
- */
+ **/
 gboolean
 gimp_image_is_dirty (gint32 image_ID)
 {
@@ -2212,7 +2212,7 @@ gimp_image_is_dirty (gint32 image_ID)
  * the number of bits per pixel in the image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 _gimp_image_thumbnail (gint32   image_ID,
                        gint     width,
@@ -2270,7 +2270,7 @@ _gimp_image_thumbnail (gint32   image_ID,
  * mask is active, then this will return the associated layer.
  *
  * Returns: The active layer.
- */
+ **/
 gint32
 gimp_image_get_active_layer (gint32 image_ID)
 {
@@ -2304,7 +2304,7 @@ gimp_image_get_active_layer (gint32 image_ID)
  * procedure will return an execution error.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_set_active_layer (gint32 image_ID,
                              gint32 active_layer_ID)
@@ -2336,7 +2336,7 @@ gimp_image_set_active_layer (gint32 image_ID,
  * otherwise, -1.
  *
  * Returns: The active channel.
- */
+ **/
 gint32
 gimp_image_get_active_channel (gint32 image_ID)
 {
@@ -2370,7 +2370,7 @@ gimp_image_get_active_channel (gint32 image_ID)
  * this procedure will return an execution error.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_set_active_channel (gint32 image_ID,
                                gint32 active_channel_ID)
@@ -2401,7 +2401,7 @@ gimp_image_set_active_channel (gint32 image_ID,
  * If there is an active path, its ID will be returned, otherwise, -1.
  *
  * Returns: The active vectors.
- */
+ **/
 gint32
 gimp_image_get_active_vectors (gint32 image_ID)
 {
@@ -2432,7 +2432,7 @@ gimp_image_get_active_vectors (gint32 image_ID)
  * If the path exists, it is set as the active path in the image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_set_active_vectors (gint32 image_ID,
                                gint32 active_vectors_ID)
@@ -2464,7 +2464,7 @@ gimp_image_set_active_vectors (gint32 image_ID,
  * represented as a channel internally.
  *
  * Returns: The selection channel.
- */
+ **/
 gint32
 gimp_image_get_selection (gint32 image_ID)
 {
@@ -2498,7 +2498,7 @@ gimp_image_get_selection (gint32 image_ID)
  * component is not valid for the image type, an error is returned.
  *
  * Returns: Component is active.
- */
+ **/
 gboolean
 gimp_image_get_component_active (gint32          image_ID,
                                  GimpChannelType component)
@@ -2535,7 +2535,7 @@ gimp_image_get_component_active (gint32          image_ID,
  * component is not valid for the image type, an error is returned.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_set_component_active (gint32          image_ID,
                                  GimpChannelType component,
@@ -2573,7 +2573,7 @@ gimp_image_set_component_active (gint32          image_ID,
  * returned.
  *
  * Returns: Component is visible.
- */
+ **/
 gboolean
 gimp_image_get_component_visible (gint32          image_ID,
                                   GimpChannelType component)
@@ -2610,7 +2610,7 @@ gimp_image_get_component_visible (gint32          image_ID,
  * component is not valid for the image type, an error is returned.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_set_component_visible (gint32          image_ID,
                                   GimpChannelType component,
@@ -2646,7 +2646,7 @@ gimp_image_set_component_visible (gint32          image_ID,
  * this function returns %NULL. See also gimp_image_get_uri().
  *
  * Returns: The filename.
- */
+ **/
 gchar *
 gimp_image_get_filename (gint32 image_ID)
 {
@@ -2678,7 +2678,7 @@ gimp_image_get_filename (gint32 image_ID)
  * should be in the filesystem encoding.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_set_filename (gint32       image_ID,
                          const gchar *filename)
@@ -2713,7 +2713,7 @@ gimp_image_set_filename (gint32       image_ID,
  * Returns: The URI.
  *
  * Since: GIMP 2.8
- */
+ **/
 gchar *
 gimp_image_get_uri (gint32 image_ID)
 {
@@ -2745,7 +2745,7 @@ gimp_image_get_uri (gint32 image_ID)
  * path). Otherwise it is the translated string \"Untitled\".
  *
  * Returns: The name.
- */
+ **/
 gchar *
 gimp_image_get_name (gint32 image_ID)
 {
@@ -2778,7 +2778,7 @@ gimp_image_get_name (gint32 image_ID)
  * inch. This value is independent of any of the layers in this image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_get_resolution (gint32   image_ID,
                            gdouble *xresolution,
@@ -2822,7 +2822,7 @@ gimp_image_get_resolution (gint32   image_ID,
  * No scaling or resizing is performed.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_set_resolution (gint32  image_ID,
                            gdouble xresolution,
@@ -2858,7 +2858,7 @@ gimp_image_set_resolution (gint32  image_ID,
  * and a description of the unit system.
  *
  * Returns: The unit.
- */
+ **/
 GimpUnit
 gimp_image_get_unit (gint32 image_ID)
 {
@@ -2893,7 +2893,7 @@ gimp_image_get_unit (gint32 image_ID)
  * system.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_set_unit (gint32   image_ID,
                      GimpUnit unit)
@@ -2926,7 +2926,7 @@ gimp_image_set_unit (gint32   image_ID,
  * Using this function at other times will produce unexpected results.
  *
  * Returns: The tattoo state.
- */
+ **/
 gint
 gimp_image_get_tattoo_state (gint32 image_ID)
 {
@@ -2968,7 +2968,7 @@ gimp_image_get_tattoo_state (gint32 image_ID)
  * that all is OK.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_set_tattoo_state (gint32 image_ID,
                              gint   tattoo_state)
@@ -3001,7 +3001,7 @@ gimp_image_set_tattoo_state (gint32 image_ID,
  * specified image.
  *
  * Returns: The layer with the specified tattoo.
- */
+ **/
 gint32
 gimp_image_get_layer_by_tattoo (gint32 image_ID,
                                 gint   tattoo)
@@ -3035,7 +3035,7 @@ gimp_image_get_layer_by_tattoo (gint32 image_ID,
  * specified image.
  *
  * Returns: The channel with the specified tattoo.
- */
+ **/
 gint32
 gimp_image_get_channel_by_tattoo (gint32 image_ID,
                                   gint   tattoo)
@@ -3071,7 +3071,7 @@ gimp_image_get_channel_by_tattoo (gint32 image_ID,
  * Returns: The vectors with the specified tattoo.
  *
  * Since: GIMP 2.6
- */
+ **/
 gint32
 gimp_image_get_vectors_by_tattoo (gint32 image_ID,
                                   gint   tattoo)
diff --git a/libgimp/gimpitem_pdb.c b/libgimp/gimpitem_pdb.c
index be995c8..cf7bec2 100644
--- a/libgimp/gimpitem_pdb.c
+++ b/libgimp/gimpitem_pdb.c
@@ -48,7 +48,7 @@
  * Returns: Whether the item ID is valid.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_is_valid (gint32 item_ID)
 {
@@ -80,7 +80,7 @@ gimp_item_is_valid (gint32 item_ID)
  * Returns: The item's image.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_item_get_image (gint32 item_ID)
 {
@@ -116,7 +116,7 @@ gimp_item_get_image (gint32 item_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_delete (gint32 item_ID)
 {
@@ -147,7 +147,7 @@ gimp_item_delete (gint32 item_ID)
  * Returns: TRUE if the item is a drawable, FALSE otherwise.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_is_drawable (gint32 item_ID)
 {
@@ -179,7 +179,7 @@ gimp_item_is_drawable (gint32 item_ID)
  * Returns: TRUE if the item is a layer, FALSE otherwise.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_is_layer (gint32 item_ID)
 {
@@ -211,7 +211,7 @@ gimp_item_is_layer (gint32 item_ID)
  * Returns: TRUE if the item is a text layer, FALSE otherwise.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_is_text_layer (gint32 item_ID)
 {
@@ -243,7 +243,7 @@ gimp_item_is_text_layer (gint32 item_ID)
  * Returns: TRUE if the item is a channel, FALSE otherwise.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_is_channel (gint32 item_ID)
 {
@@ -275,7 +275,7 @@ gimp_item_is_channel (gint32 item_ID)
  * Returns: TRUE if the item is a layer mask, FALSE otherwise.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_is_layer_mask (gint32 item_ID)
 {
@@ -307,7 +307,7 @@ gimp_item_is_layer_mask (gint32 item_ID)
  * Returns: TRUE if the item is a selection, FALSE otherwise.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_is_selection (gint32 item_ID)
 {
@@ -339,7 +339,7 @@ gimp_item_is_selection (gint32 item_ID)
  * Returns: TRUE if the item is a vectors, FALSE otherwise.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_is_vectors (gint32 item_ID)
 {
@@ -372,7 +372,7 @@ gimp_item_is_vectors (gint32 item_ID)
  * Returns: TRUE if the item is a group, FALSE otherwise.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_is_group (gint32 item_ID)
 {
@@ -404,7 +404,7 @@ gimp_item_is_group (gint32 item_ID)
  * Returns: The item's parent item.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_item_get_parent (gint32 item_ID)
 {
@@ -438,7 +438,7 @@ gimp_item_get_parent (gint32 item_ID)
  * Returns: The item's list of children.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint *
 gimp_item_get_children (gint32  item_ID,
                         gint   *num_children)
@@ -479,7 +479,7 @@ gimp_item_get_children (gint32  item_ID,
  * Returns: The item name.
  *
  * Since: GIMP 2.8
- */
+ **/
 gchar *
 gimp_item_get_name (gint32 item_ID)
 {
@@ -512,7 +512,7 @@ gimp_item_get_name (gint32 item_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_set_name (gint32       item_ID,
                     const gchar *name)
@@ -545,7 +545,7 @@ gimp_item_set_name (gint32       item_ID,
  * Returns: The item visibility.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_get_visible (gint32 item_ID)
 {
@@ -578,7 +578,7 @@ gimp_item_get_visible (gint32 item_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_set_visible (gint32   item_ID,
                        gboolean visible)
@@ -611,7 +611,7 @@ gimp_item_set_visible (gint32   item_ID,
  * Returns: The item linked state (for moves).
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_get_linked (gint32 item_ID)
 {
@@ -644,7 +644,7 @@ gimp_item_get_linked (gint32 item_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_set_linked (gint32   item_ID,
                       gboolean linked)
@@ -677,7 +677,7 @@ gimp_item_set_linked (gint32   item_ID,
  * Returns: Whether the item's contents are locked.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_get_lock_content (gint32 item_ID)
 {
@@ -710,7 +710,7 @@ gimp_item_get_lock_content (gint32 item_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_set_lock_content (gint32   item_ID,
                             gboolean lock_content)
@@ -745,7 +745,7 @@ gimp_item_set_lock_content (gint32   item_ID,
  * Returns: The item tattoo.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint
 gimp_item_get_tattoo (gint32 item_ID)
 {
@@ -780,7 +780,7 @@ gimp_item_get_tattoo (gint32 item_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_set_tattoo (gint32 item_ID,
                       gint   tattoo)
@@ -817,7 +817,7 @@ gimp_item_set_tattoo (gint32 item_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_to_selection (gint32         item_ID,
                         GimpChannelOps operation)
diff --git a/libgimp/gimpitemtransform_pdb.c b/libgimp/gimpitemtransform_pdb.c
index d26a95f..4686562 100644
--- a/libgimp/gimpitemtransform_pdb.c
+++ b/libgimp/gimpitemtransform_pdb.c
@@ -56,7 +56,7 @@
  * Returns: The flipped item.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_item_transform_flip_simple (gint32              item_ID,
                                  GimpOrientationType flip_type,
@@ -106,7 +106,7 @@ gimp_item_transform_flip_simple (gint32              item_ID,
  * Returns: The flipped item.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_item_transform_flip (gint32  item_ID,
                           gdouble x0,
@@ -169,7 +169,7 @@ gimp_item_transform_flip (gint32  item_ID,
  * Returns: The newly mapped item.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_item_transform_perspective (gint32  item_ID,
                                  gdouble x0,
@@ -229,7 +229,7 @@ gimp_item_transform_perspective (gint32  item_ID,
  * Returns: The rotated item.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_item_transform_rotate_simple (gint32           item_ID,
                                    GimpRotationType rotate_type,
@@ -281,7 +281,7 @@ gimp_item_transform_rotate_simple (gint32           item_ID,
  * Returns: The rotated item.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_item_transform_rotate (gint32   item_ID,
                             gdouble  angle,
@@ -332,7 +332,7 @@ gimp_item_transform_rotate (gint32   item_ID,
  * Returns: The scaled item.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_item_transform_scale (gint32  item_ID,
                            gdouble x0,
@@ -385,7 +385,7 @@ gimp_item_transform_scale (gint32  item_ID,
  * Returns: The sheared item.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_item_transform_shear (gint32              item_ID,
                            GimpOrientationType shear_type,
@@ -438,7 +438,7 @@ gimp_item_transform_shear (gint32              item_ID,
  * Returns: The transformed item.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_item_transform_2d (gint32  item_ID,
                         gdouble source_x,
@@ -501,7 +501,7 @@ gimp_item_transform_2d (gint32  item_ID,
  * Returns: The transformed item.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_item_transform_matrix (gint32  item_ID,
                             gdouble coeff_0_0,
diff --git a/libgimp/gimplayer_pdb.c b/libgimp/gimplayer_pdb.c
index 7c85377..0f29df3 100644
--- a/libgimp/gimplayer_pdb.c
+++ b/libgimp/gimplayer_pdb.c
@@ -54,7 +54,7 @@
  * should be set with explicit procedure calls.
  *
  * Returns: The newly created layer.
- */
+ **/
 gint32
 _gimp_layer_new (gint32                image_ID,
                  gint                  width,
@@ -104,7 +104,7 @@ _gimp_layer_new (gint32                image_ID,
  * Returns: The newly created layer.
  *
  * Since: GIMP 2.6
- */
+ **/
 gint32
 gimp_layer_new_from_visible (gint32       image_ID,
                              gint32       dest_image_ID,
@@ -143,7 +143,7 @@ gimp_layer_new_from_visible (gint32       image_ID,
  * mask modes, and offsets should be set with explicit procedure calls.
  *
  * Returns: The newly copied layer.
- */
+ **/
 gint32
 gimp_layer_new_from_drawable (gint32 drawable_ID,
                               gint32 dest_image_ID)
@@ -180,7 +180,7 @@ gimp_layer_new_from_drawable (gint32 drawable_ID,
  * Returns: The newly created layer group.
  *
  * Since: GIMP 2.8
- */
+ **/
 gint32
 gimp_layer_group_new (gint32 image_ID)
 {
@@ -216,7 +216,7 @@ gimp_layer_group_new (gint32 image_ID)
  * same image.
  *
  * Returns: The newly copied layer.
- */
+ **/
 gint32
 _gimp_layer_copy (gint32   layer_ID,
                   gboolean add_alpha)
@@ -252,7 +252,7 @@ _gimp_layer_copy (gint32   layer_ID,
  * to GRAYA, and INDEXED to INDEXEDA.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_add_alpha (gint32 layer_ID)
 {
@@ -286,7 +286,7 @@ gimp_layer_add_alpha (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_layer_flatten (gint32 layer_ID)
 {
@@ -322,7 +322,7 @@ gimp_layer_flatten (gint32 layer_ID)
  * to an image. The default interpolation method is used for scaling.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_scale (gint32   layer_ID,
                   gint     new_width,
@@ -368,7 +368,7 @@ gimp_layer_scale (gint32   layer_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_layer_scale_full (gint32                layer_ID,
                        gint                  new_width,
@@ -412,7 +412,7 @@ gimp_layer_scale_full (gint32                layer_ID,
  * operation only works if the layer has been added to an image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_resize (gint32 layer_ID,
                    gint   new_width,
@@ -450,7 +450,7 @@ gimp_layer_resize (gint32 layer_ID,
  * are equal to the width and height of its image container.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_resize_to_image_size (gint32 layer_ID)
 {
@@ -486,7 +486,7 @@ gimp_layer_resize_to_image_size (gint32 layer_ID)
  * the specified offsets.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_translate (gint32 layer_ID,
                       gint   offx,
@@ -523,7 +523,7 @@ gimp_layer_translate (gint32 layer_ID,
  * operation is valid only on layers which have been added to an image.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_set_offsets (gint32 layer_ID,
                         gint   offx,
@@ -566,7 +566,7 @@ gimp_layer_set_offsets (gint32 layer_ID,
  * to gimp_layer_add_mask().
  *
  * Returns: The newly created mask.
- */
+ **/
 gint32
 gimp_layer_create_mask (gint32          layer_ID,
                         GimpAddMaskType mask_type)
@@ -599,7 +599,7 @@ gimp_layer_create_mask (gint32          layer_ID,
  * exists.
  *
  * Returns: The layer mask.
- */
+ **/
 gint32
 gimp_layer_get_mask (gint32 layer_ID)
 {
@@ -632,7 +632,7 @@ gimp_layer_get_mask (gint32 layer_ID)
  * Returns: The mask's layer.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint32
 gimp_layer_from_mask (gint32 mask_ID)
 {
@@ -669,7 +669,7 @@ gimp_layer_from_mask (gint32 mask_ID)
  * with the procedure 'gimp-layer-create-mask'.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_add_mask (gint32 layer_ID,
                      gint32 mask_ID)
@@ -702,7 +702,7 @@ gimp_layer_add_mask (gint32 layer_ID,
  * the mask doesn't exist, an error is returned.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_remove_mask (gint32            layer_ID,
                         GimpMaskApplyMode mode)
@@ -735,7 +735,7 @@ gimp_layer_remove_mask (gint32            layer_ID,
  * to a specific drawable.
  *
  * Returns: TRUE if the layer is a floating selection.
- */
+ **/
 gboolean
 gimp_layer_is_floating_sel (gint32 layer_ID)
 {
@@ -766,7 +766,7 @@ gimp_layer_is_floating_sel (gint32 layer_ID)
  * setting.
  *
  * Returns: The layer's lock alpha channel setting.
- */
+ **/
 gboolean
 gimp_layer_get_lock_alpha (gint32 layer_ID)
 {
@@ -798,7 +798,7 @@ gimp_layer_get_lock_alpha (gint32 layer_ID)
  * setting.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_set_lock_alpha (gint32   layer_ID,
                            gboolean lock_alpha)
@@ -831,7 +831,7 @@ gimp_layer_set_lock_alpha (gint32   layer_ID,
  * being composited with the layer's alpha channel.
  *
  * Returns: The layer's apply mask setting.
- */
+ **/
 gboolean
 gimp_layer_get_apply_mask (gint32 layer_ID)
 {
@@ -865,7 +865,7 @@ gimp_layer_get_apply_mask (gint32 layer_ID)
  * error.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_set_apply_mask (gint32   layer_ID,
                            gboolean apply_mask)
@@ -899,7 +899,7 @@ gimp_layer_set_apply_mask (gint32   layer_ID,
  * function returns an error.
  *
  * Returns: The layer's show mask setting.
- */
+ **/
 gboolean
 gimp_layer_get_show_mask (gint32 layer_ID)
 {
@@ -933,7 +933,7 @@ gimp_layer_get_show_mask (gint32 layer_ID)
  * function will return an error.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_set_show_mask (gint32   layer_ID,
                           gboolean show_mask)
@@ -966,7 +966,7 @@ gimp_layer_set_show_mask (gint32   layer_ID,
  * active, and not the layer.
  *
  * Returns: The layer's edit mask setting.
- */
+ **/
 gboolean
 gimp_layer_get_edit_mask (gint32 layer_ID)
 {
@@ -1000,7 +1000,7 @@ gimp_layer_get_edit_mask (gint32 layer_ID)
  * procedure will return an error.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_set_edit_mask (gint32   layer_ID,
                           gboolean edit_mask)
@@ -1031,7 +1031,7 @@ gimp_layer_set_edit_mask (gint32   layer_ID,
  * This procedure returns the specified layer's opacity.
  *
  * Returns: The layer opacity.
- */
+ **/
 gdouble
 gimp_layer_get_opacity (gint32 layer_ID)
 {
@@ -1062,7 +1062,7 @@ gimp_layer_get_opacity (gint32 layer_ID)
  * This procedure sets the specified layer's opacity.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_set_opacity (gint32  layer_ID,
                         gdouble opacity)
@@ -1093,7 +1093,7 @@ gimp_layer_set_opacity (gint32  layer_ID,
  * This procedure returns the specified layer's combination mode.
  *
  * Returns: The layer combination mode.
- */
+ **/
 GimpLayerModeEffects
 gimp_layer_get_mode (gint32 layer_ID)
 {
@@ -1124,7 +1124,7 @@ gimp_layer_get_mode (gint32 layer_ID)
  * This procedure sets the specified layer's combination mode.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_layer_set_mode (gint32               layer_ID,
                      GimpLayerModeEffects mode)
diff --git a/libgimp/gimpmessage_pdb.c b/libgimp/gimpmessage_pdb.c
index 0faf57b..fb83cd2 100644
--- a/libgimp/gimpmessage_pdb.c
+++ b/libgimp/gimpmessage_pdb.c
@@ -44,7 +44,7 @@
  * reporting. The message must be in UTF-8 encoding.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_message (const gchar *message)
 {
@@ -74,7 +74,7 @@ gimp_message (const gchar *message)
  * gimp was started.
  *
  * Returns: The current handler type.
- */
+ **/
 GimpMessageHandlerType
 gimp_message_get_handler (void)
 {
@@ -105,7 +105,7 @@ gimp_message_get_handler (void)
  * was started.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_message_set_handler (GimpMessageHandlerType handler)
 {
diff --git a/libgimp/gimpmisc_pdb.c b/libgimp/gimpmisc_pdb.c
index 836889a..c97c474 100644
--- a/libgimp/gimpmisc_pdb.c
+++ b/libgimp/gimpmisc_pdb.c
@@ -43,7 +43,7 @@
  * GIMP.
  *
  * Returns: GIMP version number.
- */
+ **/
 gchar *
 gimp_version (void)
 {
@@ -73,7 +73,7 @@ gimp_version (void)
  * Returns: The PID.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_getpid (void)
 {
diff --git a/libgimp/gimppainttools_pdb.c b/libgimp/gimppainttools_pdb.c
index 1548ced..bc4cada 100644
--- a/libgimp/gimppainttools_pdb.c
+++ b/libgimp/gimppainttools_pdb.c
@@ -50,7 +50,7 @@
  * results in a thinner layer.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_airbrush (gint32         drawable_ID,
                gdouble        pressure,
@@ -91,7 +91,7 @@ gimp_airbrush (gint32         drawable_ID,
  * default for the option will be used.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_airbrush_default (gint32         drawable_ID,
                        gint           num_strokes,
@@ -141,7 +141,7 @@ gimp_airbrush_default (gint32         drawable_ID,
  * significantly slower.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_clone (gint32         drawable_ID,
             gint32         src_drawable_ID,
@@ -189,7 +189,7 @@ gimp_clone (gint32         drawable_ID,
  * will be used.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_clone_default (gint32         drawable_ID,
                     gint           num_strokes,
@@ -229,7 +229,7 @@ gimp_clone_default (gint32         drawable_ID,
  * between the specified stroke coordinates.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_convolve (gint32            drawable_ID,
                gdouble           pressure,
@@ -272,7 +272,7 @@ gimp_convolve (gint32            drawable_ID,
  * been activated then the dialogs default values will be used.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_convolve_default (gint32         drawable_ID,
                        gint           num_strokes,
@@ -310,7 +310,7 @@ gimp_convolve_default (gint32         drawable_ID,
  * Dodgeburn. More details here later.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_dodgeburn (gint32             drawable_ID,
                 gdouble            exposure,
@@ -354,7 +354,7 @@ gimp_dodgeburn (gint32             drawable_ID,
  * Dodgeburn. More details here later.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_dodgeburn_default (gint32         drawable_ID,
                         gint           num_strokes,
@@ -395,7 +395,7 @@ gimp_dodgeburn_default (gint32         drawable_ID,
  * tool linearly interpolates between the specified stroke coordinates.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_eraser (gint32                    drawable_ID,
              gint                      num_strokes,
@@ -438,7 +438,7 @@ gimp_eraser (gint32                    drawable_ID,
  * will be used.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_eraser_default (gint32         drawable_ID,
                      gint           num_strokes,
@@ -483,7 +483,7 @@ gimp_eraser_default (gint32         drawable_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_heal (gint32         drawable_ID,
            gint32         src_drawable_ID,
@@ -531,7 +531,7 @@ gimp_heal (gint32         drawable_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_heal_default (gint32         drawable_ID,
                    gint           num_strokes,
@@ -578,7 +578,7 @@ gimp_heal_default (gint32         drawable_ID,
  * pixels. If the gradient-length is 0, no gradient is used.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_paintbrush (gint32                    drawable_ID,
                  gdouble                   fade_out,
@@ -632,7 +632,7 @@ gimp_paintbrush (gint32                    drawable_ID,
  * is 0, no gradient is used.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_paintbrush_default (gint32         drawable_ID,
                          gint           num_strokes,
@@ -672,7 +672,7 @@ gimp_paintbrush_default (gint32         drawable_ID,
  * white.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_pencil (gint32         drawable_ID,
              gint           num_strokes,
@@ -710,7 +710,7 @@ gimp_pencil (gint32         drawable_ID,
  * lesser smudge.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_smudge (gint32         drawable_ID,
              gdouble        pressure,
@@ -750,7 +750,7 @@ gimp_smudge (gint32         drawable_ID,
  * tools option dialog has not been activated.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_smudge_default (gint32         drawable_ID,
                      gint           num_strokes,
diff --git a/libgimp/gimppalette_pdb.c b/libgimp/gimppalette_pdb.c
index ad515ec..8742667 100644
--- a/libgimp/gimppalette_pdb.c
+++ b/libgimp/gimppalette_pdb.c
@@ -47,7 +47,7 @@
  * Returns: The actual new palette name.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_palette_new (const gchar *name)
 {
@@ -79,7 +79,7 @@ gimp_palette_new (const gchar *name)
  * Returns: The name of the palette's copy.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_palette_duplicate (const gchar *name)
 {
@@ -112,7 +112,7 @@ gimp_palette_duplicate (const gchar *name)
  * Returns: The actual new name of the palette.
  *
  * Since: GIMP 2.2
- */
+ **/
 gchar *
 gimp_palette_rename (const gchar *name,
                      const gchar *new_name)
@@ -146,7 +146,7 @@ gimp_palette_rename (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_palette_delete (const gchar *name)
 {
@@ -177,7 +177,7 @@ gimp_palette_delete (const gchar *name)
  * Returns: TRUE if the palette can be edited.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_palette_is_editable (const gchar *name)
 {
@@ -211,7 +211,7 @@ gimp_palette_is_editable (const gchar *name)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_palette_get_info (const gchar *name,
                        gint        *num_colors)
@@ -249,7 +249,7 @@ gimp_palette_get_info (const gchar *name,
  * Returns: The colors in the palette.
  *
  * Since: GIMP 2.6
- */
+ **/
 GimpRGB *
 gimp_palette_get_colors (const gchar *name,
                          gint        *num_colors)
@@ -291,7 +291,7 @@ gimp_palette_get_colors (const gchar *name,
  * Returns: The number of columns used to display this palette.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_palette_get_columns (const gchar *name)
 {
@@ -326,7 +326,7 @@ gimp_palette_get_columns (const gchar *name)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_palette_set_columns (const gchar *name,
                           gint         columns)
@@ -363,7 +363,7 @@ gimp_palette_set_columns (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_palette_add_entry (const gchar   *name,
                         const gchar   *entry_name,
@@ -406,7 +406,7 @@ gimp_palette_add_entry (const gchar   *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_palette_delete_entry (const gchar *name,
                            gint         entry_num)
@@ -443,7 +443,7 @@ gimp_palette_delete_entry (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_palette_entry_get_color (const gchar *name,
                               gint         entry_num,
@@ -484,7 +484,7 @@ gimp_palette_entry_get_color (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_palette_entry_set_color (const gchar   *name,
                               gint           entry_num,
@@ -523,7 +523,7 @@ gimp_palette_entry_set_color (const gchar   *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_palette_entry_get_name (const gchar  *name,
                              gint          entry_num,
@@ -566,7 +566,7 @@ gimp_palette_entry_get_name (const gchar  *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_palette_entry_set_name (const gchar *name,
                              gint         entry_num,
diff --git a/libgimp/gimppalettes_pdb.c b/libgimp/gimppalettes_pdb.c
index 8eda74f..23645a1 100644
--- a/libgimp/gimppalettes_pdb.c
+++ b/libgimp/gimppalettes_pdb.c
@@ -46,7 +46,7 @@
  * palette path and updates the palette dialogs accordingly.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_palettes_refresh (void)
 {
@@ -77,7 +77,7 @@ gimp_palettes_refresh (void)
  * gimp_context_set_palette().
  *
  * Returns: The list of palette names.
- */
+ **/
 gchar **
 gimp_palettes_get_list (const gchar *filter,
                         gint        *num_palettes)
@@ -114,7 +114,7 @@ gimp_palettes_get_list (const gchar *filter,
  * Deprecated: Use gimp_context_get_palette() instead.
  *
  * Returns: The palette name.
- */
+ **/
 gchar *
 gimp_palettes_get_palette (gint *num_colors)
 {
@@ -147,7 +147,7 @@ gimp_palettes_get_palette (gint *num_colors)
  * Deprecated: Use gimp_palette_entry_get_color() instead.
  *
  * Returns: The palette name.
- */
+ **/
 gchar *
 gimp_palettes_get_palette_entry (const gchar *name,
                                  gint         entry_num,
diff --git a/libgimp/gimppaletteselect_pdb.c b/libgimp/gimppaletteselect_pdb.c
index c8fb908..88db4ac 100644
--- a/libgimp/gimppaletteselect_pdb.c
+++ b/libgimp/gimppaletteselect_pdb.c
@@ -45,7 +45,7 @@
  * This procedure opens the palette selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_palettes_popup (const gchar *palette_callback,
                      const gchar *popup_title,
@@ -78,7 +78,7 @@ gimp_palettes_popup (const gchar *palette_callback,
  * This procedure closes an opened palette selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_palettes_close_popup (const gchar *palette_callback)
 {
@@ -108,7 +108,7 @@ gimp_palettes_close_popup (const gchar *palette_callback)
  * Sets the current palette in a palette selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_palettes_set_popup (const gchar *palette_callback,
                          const gchar *palette_name)
diff --git a/libgimp/gimpparasite_pdb.c b/libgimp/gimpparasite_pdb.c
index 133f84b..1f4fb44 100644
--- a/libgimp/gimpparasite_pdb.c
+++ b/libgimp/gimpparasite_pdb.c
@@ -46,7 +46,7 @@
  * Finds and returns the global parasite that was previously attached.
  *
  * Returns: The found parasite.
- */
+ **/
 GimpParasite *
 gimp_parasite_find (const gchar *name)
 {
@@ -76,7 +76,7 @@ gimp_parasite_find (const gchar *name)
  * This procedure attaches a global parasite. It has no return values.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_parasite_attach (const GimpParasite *parasite)
 {
@@ -106,7 +106,7 @@ gimp_parasite_attach (const GimpParasite *parasite)
  * values.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_parasite_detach (const gchar *name)
 {
@@ -136,7 +136,7 @@ gimp_parasite_detach (const gchar *name)
  * Returns a list of all currently attached global parasites.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_parasite_list (gint    *num_parasites,
                     gchar ***parasites)
@@ -179,7 +179,7 @@ gimp_parasite_list (gint    *num_parasites,
  * image.
  *
  * Returns: The found parasite.
- */
+ **/
 GimpParasite *
 gimp_image_parasite_find (gint32       image_ID,
                           const gchar *name)
@@ -213,7 +213,7 @@ gimp_image_parasite_find (gint32       image_ID,
  * values.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_parasite_attach (gint32              image_ID,
                             const GimpParasite *parasite)
@@ -246,7 +246,7 @@ gimp_image_parasite_attach (gint32              image_ID,
  * values.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_parasite_detach (gint32       image_ID,
                             const gchar *name)
@@ -279,7 +279,7 @@ gimp_image_parasite_detach (gint32       image_ID,
  * Returns a list of all currently attached parasites.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_parasite_list (gint32    image_ID,
                           gint     *num_parasites,
@@ -325,7 +325,7 @@ gimp_image_parasite_list (gint32    image_ID,
  * Returns: The found parasite.
  *
  * Since: GIMP 2.8
- */
+ **/
 GimpParasite *
 gimp_item_parasite_find (gint32       item_ID,
                          const gchar *name)
@@ -361,7 +361,7 @@ gimp_item_parasite_find (gint32       item_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_parasite_attach (gint32              item_ID,
                            const GimpParasite *parasite)
@@ -396,7 +396,7 @@ gimp_item_parasite_attach (gint32              item_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_parasite_detach (gint32       item_ID,
                            const gchar *name)
@@ -431,7 +431,7 @@ gimp_item_parasite_detach (gint32       item_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_item_parasite_list (gint32    item_ID,
                          gint     *num_parasites,
@@ -473,7 +473,7 @@ gimp_item_parasite_list (gint32    item_ID,
  * Deprecated: Use gimp_item_parasite_find() instead.
  *
  * Returns: The found parasite.
- */
+ **/
 GimpParasite *
 gimp_drawable_parasite_find (gint32       drawable_ID,
                              const gchar *name)
@@ -504,7 +504,7 @@ gimp_drawable_parasite_find (gint32       drawable_ID,
  * Deprecated: Use gimp_item_parasite_attach() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_drawable_parasite_attach (gint32              drawable_ID,
                                const GimpParasite *parasite)
@@ -534,7 +534,7 @@ gimp_drawable_parasite_attach (gint32              drawable_ID,
  * Deprecated: Use gimp_item_parasite_detach() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_drawable_parasite_detach (gint32       drawable_ID,
                                const gchar *name)
@@ -565,7 +565,7 @@ gimp_drawable_parasite_detach (gint32       drawable_ID,
  * Deprecated: Use gimp_item_parasite_list() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_drawable_parasite_list (gint32    drawable_ID,
                              gint     *num_parasites,
@@ -609,7 +609,7 @@ gimp_drawable_parasite_list (gint32    drawable_ID,
  * Returns: The found parasite.
  *
  * Since: GIMP 2.4
- */
+ **/
 GimpParasite *
 gimp_vectors_parasite_find (gint32       vectors_ID,
                             const gchar *name)
@@ -642,7 +642,7 @@ gimp_vectors_parasite_find (gint32       vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_parasite_attach (gint32              vectors_ID,
                               const GimpParasite *parasite)
@@ -674,7 +674,7 @@ gimp_vectors_parasite_attach (gint32              vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_parasite_detach (gint32       vectors_ID,
                               const gchar *name)
@@ -707,7 +707,7 @@ gimp_vectors_parasite_detach (gint32       vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_parasite_list (gint32    vectors_ID,
                             gint     *num_parasites,
diff --git a/libgimp/gimppaths_pdb.c b/libgimp/gimppaths_pdb.c
index db4ec73..8fc972d 100644
--- a/libgimp/gimppaths_pdb.c
+++ b/libgimp/gimppaths_pdb.c
@@ -47,7 +47,7 @@
  * Deprecated: Use gimp_image_get_vectors() instead.
  *
  * Returns: List of the paths belonging to this image.
- */
+ **/
 gchar **
 gimp_path_list (gint32  image_ID,
                 gint   *num_paths)
@@ -84,7 +84,7 @@ gimp_path_list (gint32  image_ID,
  * Deprecated: Use gimp_image_get_active_vectors() instead.
  *
  * Returns: The name of the current path.
- */
+ **/
 gchar *
 gimp_path_get_current (gint32 image_ID)
 {
@@ -113,7 +113,7 @@ gimp_path_get_current (gint32 image_ID)
  * Deprecated: Use gimp_image_set_active_vectors() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_path_set_current (gint32       image_ID,
                        const gchar *name)
@@ -143,7 +143,7 @@ gimp_path_set_current (gint32       image_ID,
  * Deprecated: Use gimp_image_remove_vectors() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_path_delete (gint32       image_ID,
                   const gchar *name)
@@ -176,7 +176,7 @@ gimp_path_delete (gint32       image_ID,
  * Deprecated: Use gimp_vectors_stroke_get_points() instead.
  *
  * Returns: The type of the path. Currently only one type (1 = Bezier) is supported.
- */
+ **/
 gint
 gimp_path_get_points (gint32        image_ID,
                       const gchar  *name,
@@ -223,7 +223,7 @@ gimp_path_get_points (gint32        image_ID,
  * Deprecated: Use gimp_vectors_stroke_new_from_points() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_path_set_points (gint32         image_ID,
                       const gchar   *name,
@@ -258,7 +258,7 @@ gimp_path_set_points (gint32         image_ID,
  * Deprecated: Use gimp_edit_stroke_vectors() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_path_stroke_current (gint32 image_ID)
 {
@@ -288,7 +288,7 @@ gimp_path_stroke_current (gint32 image_ID)
  * Deprecated: Use gimp_vectors_stroke_get_point_at_dist() instead.
  *
  * Returns: The x position of the point.
- */
+ **/
 gint
 gimp_path_get_point_at_dist (gint32   image_ID,
                              gdouble  distance,
@@ -325,7 +325,7 @@ gimp_path_get_point_at_dist (gint32   image_ID,
  * Deprecated: Use gimp_vectors_get_tattoo() instead.
  *
  * Returns: The tattoo associated with the named path.
- */
+ **/
 gint
 gimp_path_get_tattoo (gint32       image_ID,
                       const gchar *name)
@@ -357,7 +357,7 @@ gimp_path_get_tattoo (gint32       image_ID,
  * Deprecated: Use gimp_vectors_set_tattoo() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_path_set_tattoo (gint32       image_ID,
                       const gchar *name,
@@ -389,7 +389,7 @@ gimp_path_set_tattoo (gint32       image_ID,
  * Deprecated: Use gimp_image_get_vectors_by_tattoo() instead.
  *
  * Returns: The name of the path with the specified tattoo.
- */
+ **/
 gchar *
 gimp_get_path_by_tattoo (gint32 image_ID,
                          gint   tattoo)
@@ -420,7 +420,7 @@ gimp_get_path_by_tattoo (gint32 image_ID,
  * Deprecated: Use gimp_vectors_get_linked() instead.
  *
  * Returns: TRUE if the path is locked, FALSE otherwise.
- */
+ **/
 gboolean
 gimp_path_get_locked (gint32       image_ID,
                       const gchar *name)
@@ -452,7 +452,7 @@ gimp_path_get_locked (gint32       image_ID,
  * Deprecated: Use gimp_vectors_set_linked() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_path_set_locked (gint32       image_ID,
                       const gchar *name,
@@ -489,7 +489,7 @@ gimp_path_set_locked (gint32       image_ID,
  * Deprecated: Use gimp_vectors_to_selection() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_path_to_selection (gint32          image_ID,
                         const gchar    *name,
@@ -531,7 +531,7 @@ gimp_path_to_selection (gint32          image_ID,
  * Deprecated: Use gimp_vectors_import_from_file() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_path_import (gint32       image_ID,
                   const gchar *filename,
diff --git a/libgimp/gimppattern_pdb.c b/libgimp/gimppattern_pdb.c
index 52ec1bc..3a37543 100644
--- a/libgimp/gimppattern_pdb.c
+++ b/libgimp/gimppattern_pdb.c
@@ -51,7 +51,7 @@
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_pattern_get_info (const gchar *name,
                        gint        *width,
@@ -103,7 +103,7 @@ gimp_pattern_get_info (const gchar *name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_pattern_get_pixels (const gchar  *name,
                          gint         *width,
diff --git a/libgimp/gimppatterns_pdb.c b/libgimp/gimppatterns_pdb.c
index 555a4a1..ffaee6d 100644
--- a/libgimp/gimppatterns_pdb.c
+++ b/libgimp/gimppatterns_pdb.c
@@ -48,7 +48,7 @@
  * pattern path and updates all pattern dialogs accordingly.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_patterns_refresh (void)
 {
@@ -79,7 +79,7 @@ gimp_patterns_refresh (void)
  * gimp_context_set_pattern().
  *
  * Returns: The list of pattern names.
- */
+ **/
 gchar **
 gimp_patterns_get_list (const gchar *filter,
                         gint        *num_patterns)
@@ -117,7 +117,7 @@ gimp_patterns_get_list (const gchar *filter,
  * Deprecated: Use gimp_context_get_pattern() instead.
  *
  * Returns: The pattern name.
- */
+ **/
 gchar *
 gimp_patterns_get_pattern (gint *width,
                            gint *height)
@@ -154,7 +154,7 @@ gimp_patterns_get_pattern (gint *width,
  * Deprecated: Use gimp_pattern_get_pixels() instead.
  *
  * Returns: The pattern name.
- */
+ **/
 gchar *
 gimp_patterns_get_pattern_data (const gchar  *name,
                                 gint         *width,
diff --git a/libgimp/gimppatternselect_pdb.c b/libgimp/gimppatternselect_pdb.c
index 881cc8b..2f96410 100644
--- a/libgimp/gimppatternselect_pdb.c
+++ b/libgimp/gimppatternselect_pdb.c
@@ -45,7 +45,7 @@
  * This procedure opens the pattern selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_patterns_popup (const gchar *pattern_callback,
                      const gchar *popup_title,
@@ -78,7 +78,7 @@ gimp_patterns_popup (const gchar *pattern_callback,
  * This procedure closes an opened pattern selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_patterns_close_popup (const gchar *pattern_callback)
 {
@@ -108,7 +108,7 @@ gimp_patterns_close_popup (const gchar *pattern_callback)
  * Sets the current pattern in a pattern selection dialog.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_patterns_set_popup (const gchar *pattern_callback,
                          const gchar *pattern_name)
diff --git a/libgimp/gimpplugin_pdb.c b/libgimp/gimpplugin_pdb.c
index 85125a6..86fc690 100644
--- a/libgimp/gimpplugin_pdb.c
+++ b/libgimp/gimpplugin_pdb.c
@@ -52,7 +52,7 @@
  * it has to be called before any procedure is installed.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_plugin_domain_register (const gchar *domain_name,
                              const gchar *domain_path)
@@ -88,7 +88,7 @@ gimp_plugin_domain_register (const gchar *domain_name,
  * that maps the help IDs to the actual help files.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_plugin_help_register (const gchar *domain_name,
                            const gchar *domain_uri)
@@ -123,7 +123,7 @@ gimp_plugin_help_register (const gchar *domain_name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_plugin_menu_register (const gchar *procedure_name,
                            const gchar *menu_path)
@@ -160,7 +160,7 @@ gimp_plugin_menu_register (const gchar *procedure_name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_plugin_menu_branch_register (const gchar *menu_path,
                                   const gchar *menu_name)
@@ -196,7 +196,7 @@ gimp_plugin_menu_branch_register (const gchar *menu_path,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 _gimp_plugin_icon_register (const gchar  *procedure_name,
                             GimpIconType  icon_type,
@@ -240,7 +240,7 @@ _gimp_plugin_icon_register (const gchar  *procedure_name,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_plugin_set_pdb_error_handler (GimpPDBErrorHandler handler)
 {
@@ -272,7 +272,7 @@ gimp_plugin_set_pdb_error_handler (GimpPDBErrorHandler handler)
  * Returns: Who is responsible for handling procedure call errors.
  *
  * Since: GIMP 2.6
- */
+ **/
 GimpPDBErrorHandler
 gimp_plugin_get_pdb_error_handler (void)
 {
diff --git a/libgimp/gimpproceduraldb_pdb.c b/libgimp/gimpproceduraldb_pdb.c
index c172fb3..e5d6ba7 100644
--- a/libgimp/gimpproceduraldb_pdb.c
+++ b/libgimp/gimpproceduraldb_pdb.c
@@ -46,7 +46,7 @@
  * guaranteed to be unique.
  *
  * Returns: A unique temporary name for a temporary PDB entry.
- */
+ **/
 gchar *
 gimp_procedural_db_temp_name (void)
 {
@@ -77,7 +77,7 @@ gimp_procedural_db_temp_name (void)
  * provided for each registered procedure.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_procedural_db_dump (const gchar *filename)
 {
@@ -126,7 +126,7 @@ gimp_procedural_db_dump (const gchar *filename)
  * entries is 0.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_procedural_db_query (const gchar   *name,
                           const gchar   *blurb,
@@ -184,7 +184,7 @@ gimp_procedural_db_query (const gchar   *name,
  * Returns: Whether a procedure of that name is registered.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_procedural_db_proc_exists (const gchar *procedure_name)
 {
@@ -228,7 +228,7 @@ gimp_procedural_db_proc_exists (const gchar *procedure_name)
  * gimp_procedural_db_proc_val() procedures.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 _gimp_procedural_db_proc_info (const gchar      *procedure_name,
                                gchar           **blurb,
@@ -292,7 +292,7 @@ _gimp_procedural_db_proc_info (const gchar      *procedure_name,
  * argument. The argument type, name, and a description are retrieved.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_procedural_db_proc_arg (const gchar     *procedure_name,
                              gint             arg_num,
@@ -344,7 +344,7 @@ gimp_procedural_db_proc_arg (const gchar     *procedure_name,
  * retrieved.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_procedural_db_proc_val (const gchar     *procedure_name,
                              gint             val_num,
@@ -394,7 +394,7 @@ gimp_procedural_db_proc_val (const gchar     *procedure_name,
  * is returned.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 _gimp_procedural_db_get_data (const gchar  *identifier,
                               gint         *bytes,
@@ -439,7 +439,7 @@ _gimp_procedural_db_get_data (const gchar  *identifier,
  * associated with the identifier, an error is returned.
  *
  * Returns: The number of bytes in the data.
- */
+ **/
 gint
 gimp_procedural_db_get_data_size (const gchar *identifier)
 {
@@ -473,7 +473,7 @@ gimp_procedural_db_get_data_size (const gchar *identifier)
  * 'procedural-db-get-data'.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 _gimp_procedural_db_set_data (const gchar  *identifier,
                               gint          bytes,
diff --git a/libgimp/gimpprogress_pdb.c b/libgimp/gimpprogress_pdb.c
index a62d6dd..0a3c2f3 100644
--- a/libgimp/gimpprogress_pdb.c
+++ b/libgimp/gimpprogress_pdb.c
@@ -45,7 +45,7 @@
  * valid to call this procedure from a plug-in.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 _gimp_progress_init (const gchar *message,
                      gint32       gdisplay_ID)
@@ -77,7 +77,7 @@ _gimp_progress_init (const gchar *message,
  * to call this procedure from a plug-in.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 _gimp_progress_update (gdouble percentage)
 {
@@ -111,7 +111,7 @@ _gimp_progress_update (gdouble percentage)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_progress_pulse (void)
 {
@@ -143,7 +143,7 @@ gimp_progress_pulse (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_progress_set_text (const gchar *message)
 {
@@ -175,7 +175,7 @@ gimp_progress_set_text (const gchar *message)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_progress_end (void)
 {
@@ -206,7 +206,7 @@ gimp_progress_end (void)
  * Returns: The progress bar's toplevel window.
  *
  * Since: GIMP 2.2
- */
+ **/
 gint
 gimp_progress_get_window_handle (void)
 {
@@ -240,7 +240,7 @@ gimp_progress_get_window_handle (void)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 _gimp_progress_install (const gchar *progress_callback)
 {
@@ -272,7 +272,7 @@ _gimp_progress_install (const gchar *progress_callback)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 _gimp_progress_uninstall (const gchar *progress_callback)
 {
@@ -303,7 +303,7 @@ _gimp_progress_uninstall (const gchar *progress_callback)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.2
- */
+ **/
 gboolean
 gimp_progress_cancel (const gchar *progress_callback)
 {
diff --git a/libgimp/gimpselection_pdb.c b/libgimp/gimpselection_pdb.c
index bec80e2..852aa6f 100644
--- a/libgimp/gimpselection_pdb.c
+++ b/libgimp/gimpselection_pdb.c
@@ -58,7 +58,7 @@
  * (x2 - x1), its height as (y2 - y1).
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_bounds (gint32    image_ID,
                        gboolean *non_empty,
@@ -110,7 +110,7 @@ gimp_selection_bounds (gint32    image_ID,
  * coordinates. If the coordinates lie out of bounds, 0 is returned.
  *
  * Returns: Value of the selection.
- */
+ **/
 gint
 gimp_selection_value (gint32 image_ID,
                       gint   x,
@@ -145,7 +145,7 @@ gimp_selection_value (gint32 image_ID,
  * is empty.
  *
  * Returns: Is the selection empty?
- */
+ **/
 gboolean
 gimp_selection_is_empty (gint32 image_ID)
 {
@@ -181,7 +181,7 @@ gimp_selection_is_empty (gint32 image_ID)
  * because of this call are lost.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_translate (gint32 image_ID,
                           gint   offx,
@@ -221,7 +221,7 @@ gimp_selection_translate (gint32 image_ID,
  * positioning of the new floating selection.
  *
  * Returns: The floated layer.
- */
+ **/
 gint32
 _gimp_selection_float (gint32 drawable_ID,
                        gint   offx,
@@ -256,7 +256,7 @@ _gimp_selection_float (gint32 drawable_ID,
  * selection channel, its new value is calculated as (255 - old-value).
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_invert (gint32 image_ID)
 {
@@ -288,7 +288,7 @@ gimp_selection_invert (gint32 image_ID)
  * might exist in the selection mask's boundary.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_sharpen (gint32 image_ID)
 {
@@ -318,7 +318,7 @@ gimp_selection_sharpen (gint32 image_ID)
  * image. Every pixel in the selection channel is set to 255.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_all (gint32 image_ID)
 {
@@ -348,7 +348,7 @@ gimp_selection_all (gint32 image_ID)
  * selection channel is set to 0.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_none (gint32 image_ID)
 {
@@ -379,7 +379,7 @@ gimp_selection_none (gint32 image_ID)
  * using a gaussian blur.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_feather (gint32  image_ID,
                         gdouble radius)
@@ -413,7 +413,7 @@ gimp_selection_feather (gint32  image_ID,
  * selection at every point within the specified radius.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_border (gint32 image_ID,
                        gint   radius)
@@ -446,7 +446,7 @@ gimp_selection_border (gint32 image_ID,
  * boundary in all directions by the specified pixel amount.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_grow (gint32 image_ID,
                      gint   steps)
@@ -480,7 +480,7 @@ gimp_selection_grow (gint32 image_ID,
  * of pixels.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_shrink (gint32 image_ID,
                        gint   steps)
@@ -509,7 +509,7 @@ gimp_selection_shrink (gint32 image_ID,
  * Deprecated: Use gimp_item_to_selection() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_layer_alpha (gint32 layer_ID)
 {
@@ -536,7 +536,7 @@ gimp_selection_layer_alpha (gint32 layer_ID)
  * Deprecated: Use gimp_item_to_selection() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_load (gint32 channel_ID)
 {
@@ -567,7 +567,7 @@ gimp_selection_load (gint32 channel_ID)
  * image's list of channels.
  *
  * Returns: The new channel.
- */
+ **/
 gint32
 gimp_selection_save (gint32 image_ID)
 {
@@ -596,7 +596,7 @@ gimp_selection_save (gint32 image_ID)
  * Deprecated: Use gimp_item_to_selection() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_selection_combine (gint32         channel_ID,
                         GimpChannelOps operation)
diff --git a/libgimp/gimpselectiontools_pdb.c b/libgimp/gimpselectiontools_pdb.c
index b7c007d..3b1e74b 100644
--- a/libgimp/gimpselectiontools_pdb.c
+++ b/libgimp/gimpselectiontools_pdb.c
@@ -63,7 +63,7 @@
  * In the case of a merged sampling, the supplied drawable is ignored.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_by_color_select (gint32          drawable_ID,
                       const GimpRGB  *color,
@@ -132,7 +132,7 @@ gimp_by_color_select (gint32          drawable_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_by_color_select_full (gint32               drawable_ID,
                            const GimpRGB       *color,
@@ -197,7 +197,7 @@ gimp_by_color_select_full (gint32               drawable_ID,
  * radius.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_ellipse_select (gint32         image_ID,
                      gdouble        x,
@@ -258,7 +258,7 @@ gimp_ellipse_select (gint32         image_ID,
  * radius.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_free_select (gint32          image_ID,
                   gint            num_segs,
@@ -325,7 +325,7 @@ gimp_free_select (gint32          image_ID,
  * drawable's origin.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_fuzzy_select (gint32         drawable_ID,
                    gdouble        x,
@@ -401,7 +401,7 @@ gimp_fuzzy_select (gint32         drawable_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_fuzzy_select_full (gint32              drawable_ID,
                         gdouble             x,
@@ -464,7 +464,7 @@ gimp_fuzzy_select_full (gint32              drawable_ID,
  * radius.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_rect_select (gint32         image_ID,
                   gdouble        x,
@@ -526,7 +526,7 @@ gimp_rect_select (gint32         image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_round_rect_select (gint32         image_ID,
                         gdouble        x,
diff --git a/libgimp/gimptextlayer_pdb.c b/libgimp/gimptextlayer_pdb.c
index 3b29d35..5ad295c 100644
--- a/libgimp/gimptextlayer_pdb.c
+++ b/libgimp/gimptextlayer_pdb.c
@@ -57,7 +57,7 @@
  * Returns: The new text layer.
  *
  * Since: GIMP 2.6
- */
+ **/
 gint32
 gimp_text_layer_new (gint32       image_ID,
                      const gchar *text,
@@ -97,7 +97,7 @@ gimp_text_layer_new (gint32       image_ID,
  * Returns: The text from the specified text layer.
  *
  * Since: GIMP 2.6
- */
+ **/
 gchar *
 gimp_text_layer_get_text (gint32 layer_ID)
 {
@@ -130,7 +130,7 @@ gimp_text_layer_get_text (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_text (gint32       layer_ID,
                           const gchar *text)
@@ -167,7 +167,7 @@ gimp_text_layer_set_text (gint32       layer_ID,
  * Returns: The markup which represents the style of the specified text layer.
  *
  * Since: GIMP 2.8
- */
+ **/
 gchar *
 gimp_text_layer_get_markup (gint32 layer_ID)
 {
@@ -199,7 +199,7 @@ gimp_text_layer_get_markup (gint32 layer_ID)
  * Returns: The font which is used in the specified text layer.
  *
  * Since: GIMP 2.6
- */
+ **/
 gchar *
 gimp_text_layer_get_font (gint32 layer_ID)
 {
@@ -232,7 +232,7 @@ gimp_text_layer_get_font (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_font (gint32       layer_ID,
                           const gchar *font)
@@ -268,7 +268,7 @@ gimp_text_layer_set_font (gint32       layer_ID,
  * Returns: The font size.
  *
  * Since: GIMP 2.6
- */
+ **/
 gdouble
 gimp_text_layer_get_font_size (gint32    layer_ID,
                                GimpUnit *unit)
@@ -307,7 +307,7 @@ gimp_text_layer_get_font_size (gint32    layer_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_font_size (gint32   layer_ID,
                                gdouble  font_size,
@@ -343,7 +343,7 @@ gimp_text_layer_set_font_size (gint32   layer_ID,
  * Returns: A flag which is true if antialiasing is used for rendering the font in the text layer.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_get_antialias (gint32 layer_ID)
 {
@@ -377,7 +377,7 @@ gimp_text_layer_get_antialias (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_antialias (gint32   layer_ID,
                                gboolean antialias)
@@ -412,7 +412,7 @@ gimp_text_layer_set_antialias (gint32   layer_ID,
  * Returns: The hint style used for font outlines.
  *
  * Since: GIMP 2.8
- */
+ **/
 GimpTextHintStyle
 gimp_text_layer_get_hint_style (gint32 layer_ID)
 {
@@ -447,7 +447,7 @@ gimp_text_layer_get_hint_style (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_text_layer_set_hint_style (gint32            layer_ID,
                                 GimpTextHintStyle style)
@@ -481,7 +481,7 @@ gimp_text_layer_set_hint_style (gint32            layer_ID,
  * Returns: A flag which is true if kerning is used in the text layer.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_get_kerning (gint32 layer_ID)
 {
@@ -514,7 +514,7 @@ gimp_text_layer_get_kerning (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_kerning (gint32   layer_ID,
                              gboolean kerning)
@@ -548,7 +548,7 @@ gimp_text_layer_set_kerning (gint32   layer_ID,
  * Returns: The language used in the text layer.
  *
  * Since: GIMP 2.6
- */
+ **/
 gchar *
 gimp_text_layer_get_language (gint32 layer_ID)
 {
@@ -582,7 +582,7 @@ gimp_text_layer_get_language (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_language (gint32       layer_ID,
                               const gchar *language)
@@ -616,7 +616,7 @@ gimp_text_layer_set_language (gint32       layer_ID,
  * Returns: The based direction used for the text layer.
  *
  * Since: GIMP 2.6
- */
+ **/
 GimpTextDirection
 gimp_text_layer_get_base_direction (gint32 layer_ID)
 {
@@ -650,7 +650,7 @@ gimp_text_layer_get_base_direction (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_base_direction (gint32            layer_ID,
                                     GimpTextDirection direction)
@@ -684,7 +684,7 @@ gimp_text_layer_set_base_direction (gint32            layer_ID,
  * Returns: The justification used in the text layer.
  *
  * Since: GIMP 2.6
- */
+ **/
 GimpTextJustification
 gimp_text_layer_get_justification (gint32 layer_ID)
 {
@@ -718,7 +718,7 @@ gimp_text_layer_get_justification (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_justification (gint32                layer_ID,
                                    GimpTextJustification justify)
@@ -752,7 +752,7 @@ gimp_text_layer_set_justification (gint32                layer_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_get_color (gint32   layer_ID,
                            GimpRGB *color)
@@ -788,7 +788,7 @@ gimp_text_layer_get_color (gint32   layer_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_color (gint32         layer_ID,
                            const GimpRGB *color)
@@ -822,7 +822,7 @@ gimp_text_layer_set_color (gint32         layer_ID,
  * Returns: The indentation value of the first line.
  *
  * Since: GIMP 2.6
- */
+ **/
 gdouble
 gimp_text_layer_get_indent (gint32 layer_ID)
 {
@@ -856,7 +856,7 @@ gimp_text_layer_get_indent (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_indent (gint32  layer_ID,
                             gdouble indent)
@@ -890,7 +890,7 @@ gimp_text_layer_set_indent (gint32  layer_ID,
  * Returns: The line-spacing value.
  *
  * Since: GIMP 2.6
- */
+ **/
 gdouble
 gimp_text_layer_get_line_spacing (gint32 layer_ID)
 {
@@ -924,7 +924,7 @@ gimp_text_layer_get_line_spacing (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_line_spacing (gint32  layer_ID,
                                   gdouble line_spacing)
@@ -958,7 +958,7 @@ gimp_text_layer_set_line_spacing (gint32  layer_ID,
  * Returns: The letter-spacing value.
  *
  * Since: GIMP 2.6
- */
+ **/
 gdouble
 gimp_text_layer_get_letter_spacing (gint32 layer_ID)
 {
@@ -992,7 +992,7 @@ gimp_text_layer_get_letter_spacing (gint32 layer_ID)
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_letter_spacing (gint32  layer_ID,
                                     gdouble letter_spacing)
@@ -1029,7 +1029,7 @@ gimp_text_layer_set_letter_spacing (gint32  layer_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.8
- */
+ **/
 gboolean
 gimp_text_layer_resize (gint32  layer_ID,
                         gdouble width,
@@ -1061,7 +1061,7 @@ gimp_text_layer_resize (gint32  layer_ID,
  * Deprecated: Use gimp_text_layer_get_hint_style() instead.
  *
  * Returns: A flag which is true if hinting is used on the font.
- */
+ **/
 gboolean
 gimp_text_layer_get_hinting (gint32    layer_ID,
                              gboolean *autohint)
@@ -1097,7 +1097,7 @@ gimp_text_layer_get_hinting (gint32    layer_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_text_layer_set_hinting (gint32   layer_ID,
                              gboolean hinting,
diff --git a/libgimp/gimptexttool_pdb.c b/libgimp/gimptexttool_pdb.c
index 0367b3a..652b383 100644
--- a/libgimp/gimptexttool_pdb.c
+++ b/libgimp/gimptexttool_pdb.c
@@ -68,7 +68,7 @@
  * vertical resolution.
  *
  * Returns: The new text layer or -1 if no layer was created.
- */
+ **/
 gint32
 gimp_text_fontname (gint32        image_ID,
                     gint32        drawable_ID,
@@ -129,7 +129,7 @@ gimp_text_fontname (gint32        image_ID,
  * into account.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_text_get_extents_fontname (const gchar  *text,
                                 gdouble       size,
@@ -195,7 +195,7 @@ gimp_text_get_extents_fontname (const gchar  *text,
  * Deprecated: Use gimp_text_fontname() instead.
  *
  * Returns: The new text layer or -1 if no layer was created.
- */
+ **/
 gint32
 gimp_text (gint32        image_ID,
            gint32        drawable_ID,
@@ -269,7 +269,7 @@ gimp_text (gint32        image_ID,
  * Deprecated: Use gimp_text_get_extents_fontname() instead.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_text_get_extents (const gchar  *text,
                        gdouble       size,
diff --git a/libgimp/gimptransformtools_pdb.c b/libgimp/gimptransformtools_pdb.c
index c50fea0..753f537 100644
--- a/libgimp/gimptransformtools_pdb.c
+++ b/libgimp/gimptransformtools_pdb.c
@@ -45,7 +45,7 @@
  * Deprecated: Use gimp_drawable_transform_flip_simple() instead.
  *
  * Returns: The flipped drawable.
- */
+ **/
 gint32
 gimp_flip (gint32              drawable_ID,
            GimpOrientationType flip_type)
@@ -85,7 +85,7 @@ gimp_flip (gint32              drawable_ID,
  * instead.
  *
  * Returns: The newly mapped drawable.
- */
+ **/
 gint32
 gimp_perspective (gint32   drawable_ID,
                   gboolean interpolation,
@@ -133,7 +133,7 @@ gimp_perspective (gint32   drawable_ID,
  * Deprecated: Use gimp_drawable_transform_rotate_default() instead.
  *
  * Returns: The rotated drawable.
- */
+ **/
 gint32
 gimp_rotate (gint32   drawable_ID,
              gboolean interpolation,
@@ -170,7 +170,7 @@ gimp_rotate (gint32   drawable_ID,
  * Deprecated: Use gimp_drawable_transform_scale_default() instead.
  *
  * Returns: The scaled drawable.
- */
+ **/
 gint32
 gimp_scale (gint32   drawable_ID,
             gboolean interpolation,
@@ -211,7 +211,7 @@ gimp_scale (gint32   drawable_ID,
  * Deprecated: Use gimp_drawable_transform_shear_default() instead.
  *
  * Returns: The sheared drawable.
- */
+ **/
 gint32
 gimp_shear (gint32              drawable_ID,
             gboolean            interpolation,
@@ -253,7 +253,7 @@ gimp_shear (gint32              drawable_ID,
  * Deprecated: Use gimp_drawable_transform_2d_default() instead.
  *
  * Returns: The transformed drawable.
- */
+ **/
 gint32
 gimp_transform_2d (gint32   drawable_ID,
                    gboolean interpolation,
diff --git a/libgimp/gimpundo_pdb.c b/libgimp/gimpundo_pdb.c
index 3e426b2..389bd44 100644
--- a/libgimp/gimpundo_pdb.c
+++ b/libgimp/gimpundo_pdb.c
@@ -46,7 +46,7 @@
  * call.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_undo_group_start (gint32 image_ID)
 {
@@ -76,7 +76,7 @@ gimp_image_undo_group_start (gint32 image_ID)
  * gimp_image_undo_group_start() call that is made.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 gimp_image_undo_group_end (gint32 image_ID)
 {
@@ -108,7 +108,7 @@ gimp_image_undo_group_end (gint32 image_ID)
  * gimp_image_undo_disable() or gimp_image_undo_freeze().
  *
  * Returns: TRUE if undo is enabled for this image.
- */
+ **/
 gboolean
 gimp_image_undo_is_enabled (gint32 image_ID)
 {
@@ -142,7 +142,7 @@ gimp_image_undo_is_enabled (gint32 image_ID)
  * be time and memory intensive.
  *
  * Returns: TRUE if the image undo has been disabled.
- */
+ **/
 gboolean
 gimp_image_undo_disable (gint32 image_ID)
 {
@@ -175,7 +175,7 @@ gimp_image_undo_disable (gint32 image_ID)
  * image undo stack.
  *
  * Returns: TRUE if the image undo has been enabled.
- */
+ **/
 gboolean
 gimp_image_undo_enable (gint32 image_ID)
 {
@@ -215,7 +215,7 @@ gimp_image_undo_enable (gint32 image_ID)
  * behaviour is undefined.
  *
  * Returns: TRUE if the image undo has been frozen.
- */
+ **/
 gboolean
 gimp_image_undo_freeze (gint32 image_ID)
 {
@@ -254,7 +254,7 @@ gimp_image_undo_freeze (gint32 image_ID)
  * responsibility of the caller.
  *
  * Returns: TRUE if the image undo has been thawed.
- */
+ **/
 gboolean
 gimp_image_undo_thaw (gint32 image_ID)
 {
diff --git a/libgimp/gimpunit_pdb.c b/libgimp/gimpunit_pdb.c
index 8e725b6..cdbba6c 100644
--- a/libgimp/gimpunit_pdb.c
+++ b/libgimp/gimpunit_pdb.c
@@ -43,7 +43,7 @@
  * This procedure returns the number of defined units.
  *
  * Returns: The number of units.
- */
+ **/
 gint
 _gimp_unit_get_number_of_units (void)
 {
@@ -71,7 +71,7 @@ _gimp_unit_get_number_of_units (void)
  * This procedure returns the number of defined units built-in to GIMP.
  *
  * Returns: The number of built-in units.
- */
+ **/
 gint
 _gimp_unit_get_number_of_built_in_units (void)
 {
@@ -109,7 +109,7 @@ _gimp_unit_get_number_of_built_in_units (void)
  * make it persistent.
  *
  * Returns: The new unit's ID.
- */
+ **/
 GimpUnit
 _gimp_unit_new (const gchar *identifier,
                 gdouble      factor,
@@ -153,7 +153,7 @@ _gimp_unit_new (const gchar *identifier,
  * file on gimp exit.
  *
  * Returns: The unit's deletion flag.
- */
+ **/
 gboolean
 _gimp_unit_get_deletion_flag (GimpUnit unit_id)
 {
@@ -186,7 +186,7 @@ _gimp_unit_get_deletion_flag (GimpUnit unit_id)
  * saved in the user's unitrc.
  *
  * Returns: TRUE on success.
- */
+ **/
 gboolean
 _gimp_unit_set_deletion_flag (GimpUnit unit_id,
                               gboolean deletion_flag)
@@ -219,7 +219,7 @@ _gimp_unit_set_deletion_flag (GimpUnit unit_id,
  * name. For user-defined units this should equal to the singular form.
  *
  * Returns: The unit's textual identifier.
- */
+ **/
 gchar *
 _gimp_unit_get_identifier (GimpUnit unit_id)
 {
@@ -251,7 +251,7 @@ _gimp_unit_get_identifier (GimpUnit unit_id)
  * will produce an error.
  *
  * Returns: The unit's factor.
- */
+ **/
 gdouble
 _gimp_unit_get_factor (GimpUnit unit_id)
 {
@@ -284,7 +284,7 @@ _gimp_unit_get_factor (GimpUnit unit_id)
  * \"pixels\" will produce an error.
  *
  * Returns: The unit's number of digits.
- */
+ **/
 gint
 _gimp_unit_get_digits (GimpUnit unit_id)
 {
@@ -314,7 +314,7 @@ _gimp_unit_get_digits (GimpUnit unit_id)
  * This procedure returns the symbol of the unit (\"''\" for inches).
  *
  * Returns: The unit's symbol.
- */
+ **/
 gchar *
 _gimp_unit_get_symbol (GimpUnit unit_id)
 {
@@ -345,7 +345,7 @@ _gimp_unit_get_symbol (GimpUnit unit_id)
  * inches).
  *
  * Returns: The unit's abbreviation.
- */
+ **/
 gchar *
 _gimp_unit_get_abbreviation (GimpUnit unit_id)
 {
@@ -375,7 +375,7 @@ _gimp_unit_get_abbreviation (GimpUnit unit_id)
  * This procedure returns the singular form of the unit.
  *
  * Returns: The unit's singular form.
- */
+ **/
 gchar *
 _gimp_unit_get_singular (GimpUnit unit_id)
 {
@@ -405,7 +405,7 @@ _gimp_unit_get_singular (GimpUnit unit_id)
  * This procedure returns the plural form of the unit.
  *
  * Returns: 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 198f0ca..32f5d45 100644
--- a/libgimp/gimpvectors_pdb.c
+++ b/libgimp/gimpvectors_pdb.c
@@ -52,7 +52,7 @@
  * Returns: the current vector object, 0 if no vector exists in the image.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint32
 gimp_vectors_new (gint32       image_ID,
                   const gchar *name)
@@ -88,7 +88,7 @@ gimp_vectors_new (gint32       image_ID,
  * Returns: The vectors of the text layer.
  *
  * Since: GIMP 2.6
- */
+ **/
 gint32
 gimp_vectors_new_from_text_layer (gint32 image_ID,
                                   gint32 layer_ID)
@@ -123,7 +123,7 @@ gimp_vectors_new_from_text_layer (gint32 image_ID,
  * Returns: The newly copied vectors object.
  *
  * Since: GIMP 2.6
- */
+ **/
 gint32
 gimp_vectors_copy (gint32 vectors_ID)
 {
@@ -157,7 +157,7 @@ gimp_vectors_copy (gint32 vectors_ID)
  * Returns: List of the strokes belonging to the path.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint *
 gimp_vectors_get_strokes (gint32  vectors_ID,
                           gint   *num_strokes)
@@ -200,7 +200,7 @@ gimp_vectors_get_strokes (gint32  vectors_ID,
  * Returns: The length (in pixels) of the given stroke.
  *
  * Since: GIMP 2.4
- */
+ **/
 gdouble
 gimp_vectors_stroke_get_length (gint32  vectors_ID,
                                 gint    stroke_id,
@@ -248,7 +248,7 @@ gimp_vectors_stroke_get_length (gint32  vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_stroke_get_point_at_dist (gint32    vectors_ID,
                                        gint      stroke_id,
@@ -303,7 +303,7 @@ gimp_vectors_stroke_get_point_at_dist (gint32    vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_remove_stroke (gint32 vectors_ID,
                             gint   stroke_id)
@@ -337,7 +337,7 @@ gimp_vectors_remove_stroke (gint32 vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_stroke_close (gint32 vectors_ID,
                            gint   stroke_id)
@@ -373,7 +373,7 @@ gimp_vectors_stroke_close (gint32 vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_stroke_translate (gint32 vectors_ID,
                                gint   stroke_id,
@@ -413,7 +413,7 @@ gimp_vectors_stroke_translate (gint32 vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_stroke_scale (gint32  vectors_ID,
                            gint    stroke_id,
@@ -454,7 +454,7 @@ gimp_vectors_stroke_scale (gint32  vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_stroke_rotate (gint32  vectors_ID,
                             gint    stroke_id,
@@ -496,7 +496,7 @@ gimp_vectors_stroke_rotate (gint32  vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_stroke_flip (gint32              vectors_ID,
                           gint                stroke_id,
@@ -540,7 +540,7 @@ gimp_vectors_stroke_flip (gint32              vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_stroke_flip_free (gint32  vectors_ID,
                                gint    stroke_id,
@@ -588,7 +588,7 @@ gimp_vectors_stroke_flip_free (gint32  vectors_ID,
  * Returns: type of the stroke (always GIMP_VECTORS_STROKE_TYPE_BEZIER for now).
  *
  * Since: GIMP 2.4
- */
+ **/
 GimpVectorsStrokeType
 gimp_vectors_stroke_get_points (gint32     vectors_ID,
                                 gint       stroke_id,
@@ -646,7 +646,7 @@ gimp_vectors_stroke_get_points (gint32     vectors_ID,
  * Returns: The stroke ID of the newly created stroke.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_vectors_stroke_new_from_points (gint32                 vectors_ID,
                                      GimpVectorsStrokeType  type,
@@ -690,7 +690,7 @@ gimp_vectors_stroke_new_from_points (gint32                 vectors_ID,
  * Returns: List of the coords along the path (x0, y0, x1, y1, ...).
  *
  * Since: GIMP 2.4
- */
+ **/
 gdouble *
 gimp_vectors_stroke_interpolate (gint32    vectors_ID,
                                  gint      stroke_id,
@@ -739,7 +739,7 @@ gimp_vectors_stroke_interpolate (gint32    vectors_ID,
  * Returns: The resulting stroke.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_vectors_bezier_stroke_new_moveto (gint32  vectors_ID,
                                        gdouble x0,
@@ -778,7 +778,7 @@ gimp_vectors_bezier_stroke_new_moveto (gint32  vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_bezier_stroke_lineto (gint32  vectors_ID,
                                    gint    stroke_id,
@@ -822,7 +822,7 @@ gimp_vectors_bezier_stroke_lineto (gint32  vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_bezier_stroke_conicto (gint32  vectors_ID,
                                     gint    stroke_id,
@@ -870,7 +870,7 @@ gimp_vectors_bezier_stroke_conicto (gint32  vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_bezier_stroke_cubicto (gint32  vectors_ID,
                                     gint    stroke_id,
@@ -920,7 +920,7 @@ gimp_vectors_bezier_stroke_cubicto (gint32  vectors_ID,
  * Returns: The resulting stroke.
  *
  * Since: GIMP 2.4
- */
+ **/
 gint
 gimp_vectors_bezier_stroke_new_ellipse (gint32  vectors_ID,
                                         gdouble x0,
@@ -965,7 +965,7 @@ gimp_vectors_bezier_stroke_new_ellipse (gint32  vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_to_selection (gint32         vectors_ID,
                            GimpChannelOps operation,
@@ -1012,7 +1012,7 @@ gimp_vectors_to_selection (gint32         vectors_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_import_from_file (gint32        image_ID,
                                const gchar  *filename,
@@ -1071,7 +1071,7 @@ gimp_vectors_import_from_file (gint32        image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.4
- */
+ **/
 gboolean
 gimp_vectors_import_from_string (gint32        image_ID,
                                  const gchar  *string,
@@ -1129,7 +1129,7 @@ gimp_vectors_import_from_string (gint32        image_ID,
  * Returns: TRUE on success.
  *
  * Since: GIMP 2.6
- */
+ **/
 gboolean
 gimp_vectors_export_to_file (gint32       image_ID,
                              const gchar *filename,
@@ -1168,7 +1168,7 @@ gimp_vectors_export_to_file (gint32       image_ID,
  * Returns: A string whose contents are a complete SVG document.
  *
  * Since: GIMP 2.6
- */
+ **/
 gchar *
 gimp_vectors_export_to_string (gint32 image_ID,
                                gint32 vectors_ID)
diff --git a/tools/pdbgen/lib.pl b/tools/pdbgen/lib.pl
index e83aca4..561befb 100644
--- a/tools/pdbgen/lib.pl
+++ b/tools/pdbgen/lib.pl
@@ -457,7 +457,7 @@ $argdesc *
 $procdesc
  *
  * Returns: $retdesc$sincedesc
- */
+ **/
 $rettype
 $wrapped$funcname ($clist)
 {



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]