doc: Make documentation comments symmetric

Documentation comments should always start with "/**" and end with
"**/". This is not required by gtk-doc, but it makes the
documentations formatting more consistent and simplifies the checking
of documentation comments.

The following Python script tries to enforce this.

from sys import argv
from sre import search

for filename in argv[1:]:
    in_doc = False
    lines = open(filename, "r").read().split("\n")
    for i in range(len(lines)):
        ls = lines[i].strip()
        if ls == "/**":
            in_doc = True
        elif in_doc and ls == "*/":
            lines[i] = " **/"
        if ls.endswith("*/"):
            in_doc = False

    out = open(filename, "w")
    out.write("\n".join(lines))
    out.close()

This fixes most 'documentation comment not closed with **/' warnings
by check-doc-syntax.awk.

40 files changed, 105 insertions, 105 deletions

diff --git a/src/cairo-beos-surface.cpp b/src/cairo-beos-surface.cpp
index 2d96778d..eb672b63 100644
--- a/src/cairo-beos-surface.cpp
+++ b/src/cairo-beos-surface.cpp
@@ -61,7 +61,7 @@
  *
  * The BeOS surface is used to render cairo graphics to BeOS views 
  * and bitmaps.
- */
+ **/
 
 #define CAIRO_INT_STATUS_SUCCESS (cairo_int_status_t)(CAIRO_STATUS_SUCCESS)
 
diff --git a/src/cairo-device.c b/src/cairo-device.c
index fd1ec71d..098f8560 100644
--- a/src/cairo-device.c
+++ b/src/cairo-device.c
@@ -92,7 +92,7 @@
  * interactions with existing surface API of the device functions for
  * surfaces of that type.
  * </para></note>
- */
+ **/
 
 static const cairo_device_t _nil_device = {
     CAIRO_REFERENCE_COUNT_INVALID,
diff --git a/src/cairo-font-face.c b/src/cairo-font-face.c
index e379b25a..f429da05 100644
--- a/src/cairo-font-face.c
+++ b/src/cairo-font-face.c
@@ -56,7 +56,7 @@
  * or implicitly using the <firstterm>toy</firstterm> text API by way of
  * cairo_select_font_face().  The resulting face can be accessed using
  * cairo_get_font_face().
- */
+ **/
 
 /* #cairo_font_face_t */
 
diff --git a/src/cairo-font-options.c b/src/cairo-font-options.c
index 521d371a..709c5f80 100644
--- a/src/cairo-font-options.c
+++ b/src/cairo-font-options.c
@@ -47,7 +47,7 @@
  * time the font options implied by a surface are just right and do not 
  * need any changes, but for pixel-based targets tweaking font options 
  * may result in superior output on a particular display.
- */
+ **/
 
 static const cairo_font_options_t _cairo_font_options_nil = {
     CAIRO_ANTIALIAS_DEFAULT,
diff --git a/src/cairo-ft-font.c b/src/cairo-ft-font.c
index 70e4a9e4..69a701cc 100644
--- a/src/cairo-ft-font.c
+++ b/src/cairo-ft-font.c
@@ -101,14 +101,14 @@
  *
  * The FreeType font backend is primarily used to render text on GNU/Linux
  * systems, but can be used on other platforms too.
- */
+ **/
 
 /**
  * CAIRO_HAS_FT_FONT:
  *
  * Defined if the FreeType font backend is available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 /**
  * CAIRO_HAS_FC_FONT:
@@ -116,7 +116,7 @@
  * Defined if the Fontconfig-specific functions of the FreeType font backend
  * are available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 /*
  * The simple 2x2 matrix is converted into separate scale and shape
diff --git a/src/cairo-gl.h b/src/cairo-gl.h
index 407a224e..dd17be63 100644
--- a/src/cairo-gl.h
+++ b/src/cairo-gl.h
@@ -55,7 +55,7 @@
  * call which interacts with a cairo-gl surface or the cairo-gl
  * device.  As a result, the user must make their own context current
  * between any cairo calls and their own OpenGL rendering.
- */
+ **/
 
 #ifndef CAIRO_GL_H
 #define CAIRO_GL_H
diff --git a/src/cairo-gstate.c b/src/cairo-gstate.c
index d232f9b5..a2ec371b 100644
--- a/src/cairo-gstate.c
+++ b/src/cairo-gstate.c
@@ -382,7 +382,7 @@ _cairo_gstate_get_original_target (cairo_gstate_t *gstate)
  * This space left intentionally blank.
  *
  * Return value: a pointer to the gstate's #cairo_clip_t structure.
- */
+ **/
 cairo_clip_t *
 _cairo_gstate_get_clip (cairo_gstate_t *gstate)
 {
diff --git a/src/cairo-image-surface.c b/src/cairo-image-surface.c
index 2a2d59d4..52f1af87 100644
--- a/src/cairo-image-surface.c
+++ b/src/cairo-image-surface.c
@@ -68,7 +68,7 @@
  * Image surfaces provide the ability to render to memory buffers
  * either allocated by cairo or by the calling code.  The supported
  * image formats are those defined in #cairo_format_t.
- */
+ **/
 
 /**
  * CAIRO_HAS_IMAGE_SURFACE:
@@ -78,7 +78,7 @@
  * This macro was added for completeness in cairo 1.8.
  *
  * @Since: 1.8
- */
+ **/
 
 static cairo_bool_t
 _cairo_image_surface_is_size_valid (int width, int height)
diff --git a/src/cairo-malloc-private.h b/src/cairo-malloc-private.h
index 3414bb80..1e2c67f8 100644
--- a/src/cairo-malloc-private.h
+++ b/src/cairo-malloc-private.h
@@ -57,7 +57,7 @@
  *
  * Return value: A pointer to the newly allocated memory, or %NULL in
  * case of malloc() failure or size is 0.
- */
+ **/
 
 #define _cairo_malloc(size) \
    ((size) ? malloc((unsigned) (size)) : NULL)
@@ -77,7 +77,7 @@
  *
  * Return value: A pointer to the newly allocated memory, or %NULL in
  * case of malloc() failure or overflow.
- */
+ **/
 
 #define _cairo_malloc_ab(a, size) \
   ((size) && (unsigned) (a) >= INT32_MAX / (unsigned) (size) ? NULL : \
@@ -99,7 +99,7 @@
  * Return value: A pointer to the newly allocated memory, or %NULL in
  * case of realloc() failure or overflow (whereupon the original block
  * of memory * is left untouched).
- */
+ **/
 
 #define _cairo_realloc_ab(ptr, a, size) \
   ((size) && (unsigned) (a) >= INT32_MAX / (unsigned) (size) ? NULL : \
@@ -120,7 +120,7 @@
  *
  * Return value: A pointer to the newly allocated memory, or %NULL in
  * case of malloc() failure or overflow.
- */
+ **/
 
 #define _cairo_malloc_abc(a, b, size) \
   ((b) && (unsigned) (a) >= INT32_MAX / (unsigned) (b) ? NULL : \
@@ -139,7 +139,7 @@
  *
  * Return value: A pointer to the newly allocated memory, or %NULL in
  * case of malloc() failure or overflow.
- */
+ **/
 
 #define _cairo_malloc_ab_plus_c(a, size, c) \
   ((size) && (unsigned) (a) >= INT32_MAX / (unsigned) (size) ? NULL : \
diff --git a/src/cairo-matrix.c b/src/cairo-matrix.c
index 59f0b866..c3b92635 100644
--- a/src/cairo-matrix.c
+++ b/src/cairo-matrix.c
@@ -67,7 +67,7 @@
  * #cairo_matrix_t, defines the transformation from user-space
  * coordinates to device-space coordinates. See cairo_get_matrix() and
  * cairo_set_matrix().
- */
+ **/
 
 static void
 _cairo_matrix_scalar_multiply (cairo_matrix_t *matrix, double scalar);
diff --git a/src/cairo-misc.c b/src/cairo-misc.c
index 27c264b5..60edaae9 100644
--- a/src/cairo-misc.c
+++ b/src/cairo-misc.c
@@ -62,7 +62,7 @@ COMPILE_TIME_ASSERT (CAIRO_INT_STATUS_LAST_STATUS <= 127);
  * the mean time, it is safe to call all cairo functions normally even if the
  * underlying object is in an error status.  This means that no error handling
  * code is required before or after each individual cairo function call.
- */
+ **/
 
 /* Public stuff */
 
@@ -73,7 +73,7 @@ COMPILE_TIME_ASSERT (CAIRO_INT_STATUS_LAST_STATUS <= 127);
  * Provides a human-readable description of a #cairo_status_t.
  *
  * Returns: a string representation of the status
- */
+ **/
 const char *
 cairo_status_to_string (cairo_status_t status)
 {
@@ -180,7 +180,7 @@ cairo_status_to_string (cairo_status_t status)
  *          freed using cairo_glyph_free()
  *
  * Since: 1.8
- */
+ **/
 cairo_glyph_t *
 cairo_glyph_allocate (int num_glyphs)
 {
@@ -203,7 +203,7 @@ slim_hidden_def (cairo_glyph_allocate);
  * for glyphs.
  *
  * Since: 1.8
- */
+ **/
 void
 cairo_glyph_free (cairo_glyph_t *glyphs)
 {
@@ -230,7 +230,7 @@ slim_hidden_def (cairo_glyph_free);
  *          freed using cairo_text_cluster_free()
  *
  * Since: 1.8
- */
+ **/
 cairo_text_cluster_t *
 cairo_text_cluster_allocate (int num_clusters)
 {
@@ -253,7 +253,7 @@ slim_hidden_def (cairo_text_cluster_allocate);
  * for text clusters.
  *
  * Since: 1.8
- */
+ **/
 void
 cairo_text_cluster_free (cairo_text_cluster_t *clusters)
 {
@@ -281,7 +281,7 @@ slim_hidden_def (cairo_text_cluster_free);
  *               %CAIRO_STATUS_INVALID_CLUSTERS on error.
  *               The error is either invalid UTF-8 input,
  *               or bad cluster mapping.
- */
+ **/
 cairo_status_t
 _cairo_validate_text_clusters (const char		   *utf8,
 			       int			    utf8_len,
diff --git a/src/cairo-path-stroke.c b/src/cairo-path-stroke.c
index f25cfe4f..2d32b914 100644
--- a/src/cairo-path-stroke.c
+++ b/src/cairo-path-stroke.c
@@ -184,7 +184,7 @@ _cairo_stroker_join_is_clockwise (const cairo_stroke_face_t *in,
  *
  * Return -1, 0 or 1 depending on the relative slopes of
  * two lines.
- */
+ **/
 static int
 _cairo_slope_compare_sgn (double dx1, double dy1, double dx2, double dy2)
 {
diff --git a/src/cairo-path.c b/src/cairo-path.c
index d3d91311..f2a02f18 100644
--- a/src/cairo-path.c
+++ b/src/cairo-path.c
@@ -48,7 +48,7 @@
  *
  * Paths are the most basic drawing tools and are primarily used to implicitly
  * generate simple masks.
- */
+ **/
 
 static const cairo_path_t _cairo_path_nil = { CAIRO_STATUS_NO_MEMORY, NULL, 0 };
 
diff --git a/src/cairo-pattern.c b/src/cairo-pattern.c
index 205dfe05..c4e6d31d 100644
--- a/src/cairo-pattern.c
+++ b/src/cairo-pattern.c
@@ -59,7 +59,7 @@
  * or implicitly through
  * <function>cairo_set_source_<emphasis>type</emphasis>()</function>
  * functions.
- */
+ **/
 
 static freed_pool_t freed_pattern_pool[5];
 
@@ -1910,7 +1910,7 @@ cairo_pattern_add_color_stop_rgb (cairo_pattern_t *pattern,
  * Note: If the pattern is not a gradient pattern, (eg. a linear or
  * radial pattern), then the pattern will be put into an error status
  * with a status of %CAIRO_STATUS_PATTERN_TYPE_MISMATCH.
- */
+ **/
 void
 cairo_pattern_add_color_stop_rgba (cairo_pattern_t *pattern,
 				   double	   offset,
@@ -3307,7 +3307,7 @@ _cairo_pattern_is_clear (const cairo_pattern_t *abstract_pattern)
  * XXX: We don't actually have any way of querying the backend for
  *      the filter radius, so we just guess base on what we know that
  *      backends do currently (see bug #10508)
- */
+ **/
 cairo_filter_t
 _cairo_pattern_analyze_filter (const cairo_pattern_t	*pattern,
 			       double			*pad_out)
@@ -4082,7 +4082,7 @@ cairo_pattern_get_color_stop_rgba (cairo_pattern_t *pattern,
  * pattern.
  *
  * Since: 1.4
- */
+ **/
 cairo_status_t
 cairo_pattern_get_color_stop_count (cairo_pattern_t *pattern,
 				    int *count)
@@ -4207,7 +4207,7 @@ cairo_pattern_get_radial_circles (cairo_pattern_t *pattern,
  * pattern.
  *
  * Since: 1.12
- */
+ **/
 cairo_status_t
 cairo_mesh_pattern_get_patch_count (cairo_pattern_t *pattern,
 				    unsigned int *count)
@@ -4247,7 +4247,7 @@ slim_hidden_def (cairo_mesh_pattern_get_patch_count);
  * status %CAIRO_STATUS_PATTERN_TYPE_MISMATCH is returned.
  *
  * Since: 1.12
- */
+ **/
 cairo_path_t *
 cairo_mesh_pattern_get_path (cairo_pattern_t *pattern,
 			     unsigned int patch_num)
diff --git a/src/cairo-pdf-surface.c b/src/cairo-pdf-surface.c
index b758d001..96589576 100644
--- a/src/cairo-pdf-surface.c
+++ b/src/cairo-pdf-surface.c
@@ -130,7 +130,7 @@
  *
  * The PDF surface is used to render cairo graphics to Adobe
  * PDF files and is a multi-page vector surface backend.
- */
+ **/
 
 static cairo_bool_t
 _cairo_pdf_surface_get_extents (void		        *abstract_surface,
@@ -141,7 +141,7 @@ _cairo_pdf_surface_get_extents (void		        *abstract_surface,
  *
  * Defined if the PDF surface backend is available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 static const cairo_pdf_version_t _cairo_pdf_versions[] =
 {
@@ -461,7 +461,7 @@ BAIL0:
  * occurs. You can use cairo_surface_status() to check for this.
  *
  * Since: 1.2
- */
+ **/
 cairo_surface_t *
 cairo_pdf_surface_create_for_stream (cairo_write_func_t		 write_func,
 				     void			*closure,
@@ -1295,7 +1295,7 @@ _get_source_surface_size (cairo_surface_t         *source,
  *
  * Only one of @source_pattern or @source_surface is to be
  * specified. Set the other to NULL.
- */
+ **/
 static cairo_status_t
 _cairo_pdf_surface_add_source_surface (cairo_pdf_surface_t	    *surface,
 				       cairo_surface_t	            *source_surface,
diff --git a/src/cairo-pdf.h b/src/cairo-pdf.h
index 50460ccd..1ddee3d5 100644
--- a/src/cairo-pdf.h
+++ b/src/cairo-pdf.h
@@ -52,7 +52,7 @@ CAIRO_BEGIN_DECLS
  * specification that a generated PDF file will conform to.
  *
  * Since 1.10
- */
+ **/
 typedef enum _cairo_pdf_version {
     CAIRO_PDF_VERSION_1_4,
     CAIRO_PDF_VERSION_1_5
diff --git a/src/cairo-png.c b/src/cairo-png.c
index 59bbe686..b36c8df4 100644
--- a/src/cairo-png.c
+++ b/src/cairo-png.c
@@ -62,7 +62,7 @@
  * cairo_image_surface_get_data() or a backend-specific access
  * function, and process it with another library, e.g. gdk-pixbuf or
  * libpng.
- */
+ **/
 
 /**
  * CAIRO_HAS_PNG_FUNCTIONS:
@@ -70,7 +70,7 @@
  * Defined if the PNG functions are available.
  * This macro can be used to conditionally compile code using the cairo
  * PNG functions.
- */
+ **/
 
 struct png_read_closure_t {
     cairo_read_func_t		 read_func;
diff --git a/src/cairo-ps-surface.c b/src/cairo-ps-surface.c
index 88c48347..c881516c 100644
--- a/src/cairo-ps-surface.c
+++ b/src/cairo-ps-surface.c
@@ -104,14 +104,14 @@
  *
  * The PostScript surface is used to render cairo graphics to Adobe
  * PostScript files and is a multi-page vector surface backend.
- */
+ **/
 
 /**
  * CAIRO_HAS_PS_SURFACE:
  * 
  * Defined if the PostScript surface backend is available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 typedef enum {
     CAIRO_PS_COMPRESS_NONE,
@@ -1121,7 +1121,7 @@ cairo_ps_surface_create (const char		*filename,
  * occurs. You can use cairo_surface_status() to check for this.
  *
  * Since: 1.2
- */
+ **/
 cairo_surface_t *
 cairo_ps_surface_create_for_stream (cairo_write_func_t	write_func,
 				    void	       *closure,
diff --git a/src/cairo-ps.h b/src/cairo-ps.h
index fd1d21de..edd1e95d 100644
--- a/src/cairo-ps.h
+++ b/src/cairo-ps.h
@@ -55,7 +55,7 @@ CAIRO_BEGIN_DECLS
  * #cairo_ps_level_t is used to describe the language level of the
  * PostScript Language Reference that a generated PostScript file will
  * conform to.
- */
+ **/
 typedef enum _cairo_ps_level {
     CAIRO_PS_LEVEL_2,
     CAIRO_PS_LEVEL_3
diff --git a/src/cairo-quartz-font.c b/src/cairo-quartz-font.c
index 53d5c35f..03369727 100644
--- a/src/cairo-quartz-font.c
+++ b/src/cairo-quartz-font.c
@@ -53,14 +53,14 @@
  * The Quartz font backend is primarily used to render text on Apple
  * MacOS X systems.  The CGFont API is used for the internal
  * implementation of the font backend methods.
- */
+ **/
 
 /**
  * CAIRO_HAS_QUARTZ_FONT:
  *
  * Defined if the Quartz font backend is available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 static CFDataRef (*CGFontCopyTableForTagPtr) (CGFontRef font, uint32_t tag) = NULL;
 
@@ -351,7 +351,7 @@ const cairo_font_face_backend_t _cairo_quartz_font_face_backend = {
  *  cairo_font_face_destroy() when you are done using it.
  *
  * Since: 1.6
- */
+ **/
 cairo_font_face_t *
 cairo_quartz_font_face_create_for_cgfont (CGFontRef font)
 {
diff --git a/src/cairo-quartz-image-surface.c b/src/cairo-quartz-image-surface.c
index 5adf5214..763ce966 100644
--- a/src/cairo-quartz-image-surface.c
+++ b/src/cairo-quartz-image-surface.c
@@ -296,7 +296,7 @@ static const cairo_surface_backend_t cairo_quartz_image_surface_backend = {
  * Return value: the newly created surface.
  *
  * Since: 1.6
- */
+ **/
 cairo_surface_t *
 cairo_quartz_image_surface_create (cairo_surface_t *surface)
 {
diff --git a/src/cairo-quartz-surface.c b/src/cairo-quartz-surface.c
index cdd58658..1141cd5f 100644
--- a/src/cairo-quartz-surface.c
+++ b/src/cairo-quartz-surface.c
@@ -74,14 +74,14 @@
  *
  * The Quartz surface is used to render cairo graphics targeting the
  * Apple OS X Quartz rendering system.
- */
+ **/
 
 /**
  * CAIRO_HAS_QUARTZ_SURFACE:
  *
  * Defined if the Quartz surface backend is available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 #if __MAC_OS_X_VERSION_MIN_REQUIRED < 1050
 /* This method is private, but it exists.  Its params are are exposed
diff --git a/src/cairo-recording-surface.c b/src/cairo-recording-surface.c
index ebe6f50f..4b42dabc 100644
--- a/src/cairo-recording-surface.c
+++ b/src/cairo-recording-surface.c
@@ -74,7 +74,7 @@
  * improved by improving the implementation of snapshot for the
  * various objects. For example, it would be nice to have a
  * copy-on-write implementation for _cairo_surface_snapshot.
- */
+ **/
 
 #include "cairoint.h"
 
@@ -105,7 +105,7 @@ static const cairo_surface_backend_t cairo_recording_surface_backend;
  * This macro was added for completeness in cairo 1.10.
  *
  * Since: 1.10
- */
+ **/
 
 /* Currently all recording surfaces do have a size which should be passed
  * in as the maximum size of any target surface against which the
diff --git a/src/cairo-region.c b/src/cairo-region.c
index 9e032729..c3785eb6 100644
--- a/src/cairo-region.c
+++ b/src/cairo-region.c
@@ -52,7 +52,7 @@
  * Regions are a simple graphical data type representing an area of 
  * integer-aligned rectangles. They are often used on raster surfaces 
  * to track areas of interest, such as change or clip areas.
- */
+ **/
 
 static const cairo_region_t _cairo_region_nil = {
     CAIRO_REFERENCE_COUNT_INVALID,	/* ref_count */
@@ -848,7 +848,7 @@ slim_hidden_def (cairo_region_translate);
  *     partially outside the region.
  * 
  * Used as the return value for cairo_region_contains_rectangle().
- */
+ **/
 
 /**
  * cairo_region_contains_rectangle:
diff --git a/src/cairo-scaled-font.c b/src/cairo-scaled-font.c
index b1c4b87e..29cea063 100644
--- a/src/cairo-scaled-font.c
+++ b/src/cairo-scaled-font.c
@@ -59,7 +59,7 @@
  *
  * #cairo_scaled_font_t represents a realization of a font face at a particular
  * size and transformation and a certain set of font options.
- */
+ **/
 
 static uint32_t
 _cairo_scaled_font_compute_hash (cairo_scaled_font_t *scaled_font);
diff --git a/src/cairo-script-surface.c b/src/cairo-script-surface.c
index f235be97..e307c1b8 100644
--- a/src/cairo-script-surface.c
+++ b/src/cairo-script-surface.c
@@ -52,7 +52,7 @@
  * script that matches the cairo drawing model. The scripts can
  * be replayed using tools under the util/cairo-script directoriy,
  * or with cairo-perf-trace.
- */
+ **/
 
 /**
  * CAIRO_HAS_SCRIPT_SURFACE:
@@ -61,7 +61,7 @@
  * The script surface backend is always built in since 1.12.
  *
  * @Since: 1.10
- */
+ **/
 
 
 #include "cairoint.h"
diff --git a/src/cairo-surface.c b/src/cairo-surface.c
index 237a17ca..066c30ce 100644
--- a/src/cairo-surface.c
+++ b/src/cairo-surface.c
@@ -93,7 +93,7 @@
  * Note that for other surface types it might be necessary to acquire the
  * surface's device first. See cairo_device_acquire() for a discussion of
  * devices.
- */
+ **/
 
 #define DEFINE_NIL_SURFACE(status, name)			\
 const cairo_surface_t name = {					\
@@ -1085,7 +1085,7 @@ _cairo_mime_data_destroy (void *ptr)
  * The Joint Photographic Experts Group (JPEG) 2000 image coding standard (ISO/IEC 15444-1).
  *
  * @Since: 1.10
- */
+ **/
 
 /**
  * CAIRO_MIME_TYPE_JPEG:
@@ -1093,7 +1093,7 @@ _cairo_mime_data_destroy (void *ptr)
  * The Joint Photographic Experts Group (JPEG) image coding standard (ISO/IEC 10918-1).
  *
  * @Since: 1.10
- */
+ **/
 
 /**
  * CAIRO_MIME_TYPE_PNG:
@@ -1101,7 +1101,7 @@ _cairo_mime_data_destroy (void *ptr)
  * The Portable Network Graphics image file format (ISO/IEC 15948).
  *
  * @Since: 1.10
- */
+ **/
 
 /**
  * CAIRO_MIME_TYPE_URI:
@@ -1109,7 +1109,7 @@ _cairo_mime_data_destroy (void *ptr)
  * URI for an image file (unofficial MIME type).
  *
  * @Since: 1.10
- */
+ **/
 
 /**
  * CAIRO_MIME_TYPE_UNIQUE_ID:
@@ -1117,7 +1117,7 @@ _cairo_mime_data_destroy (void *ptr)
  * Unique identifier for a surface (cairo specific MIME type).
  *
  * @Since: 1.12
- */
+ **/
 
 /**
  * cairo_surface_set_mime_data:
@@ -1380,7 +1380,7 @@ slim_hidden_def (cairo_surface_flush);
  * Tells cairo that drawing has been done to surface using means other
  * than cairo, and that cairo should reread any cached areas. Note
  * that you must call cairo_surface_flush() before doing such drawing.
- */
+ **/
 void
 cairo_surface_mark_dirty (cairo_surface_t *surface)
 {
@@ -1403,7 +1403,7 @@ slim_hidden_def (cairo_surface_mark_dirty);
  * Any cached clip set on the surface will be reset by this function,
  * to make sure that future cairo calls have the clip set that they
  * expect.
- */
+ **/
 void
 cairo_surface_mark_dirty_rectangle (cairo_surface_t *surface,
 				    int              x,
@@ -2069,7 +2069,7 @@ _cairo_surface_fill (cairo_surface_t		*surface,
  * namely cairo_copy_page().
  *
  * Since: 1.6
- */
+ **/
 void
 cairo_surface_copy_page (cairo_surface_t *surface)
 {
@@ -2147,7 +2147,7 @@ slim_hidden_def (cairo_surface_show_page);
  *
  * This behavior would have to be changed is we ever exported a public
  * variant of this function.
- */
+ **/
 cairo_bool_t
 _cairo_surface_get_extents (cairo_surface_t         *surface,
 			    cairo_rectangle_int_t   *extents)
@@ -2345,7 +2345,7 @@ _cairo_surface_show_text_glyphs (cairo_surface_t	    *surface,
  * Set the actual surface resolution of @surface to the given x and y DPI.
  * Mainly used for correctly computing the scale factor when fallback
  * rendering needs to take place in the paginated surface.
- */
+ **/
 void
 _cairo_surface_set_resolution (cairo_surface_t *surface,
 			       double x_res,
diff --git a/src/cairo-svg-surface.c b/src/cairo-svg-surface.c
index 7f87c934..950cb1f6 100644
--- a/src/cairo-svg-surface.c
+++ b/src/cairo-svg-surface.c
@@ -66,14 +66,14 @@
  *
  * The SVG surface is used to render cairo graphics to
  * SVG files and is a multi-page vector surface backend.
- */
+ **/
 
 /**
  * CAIRO_HAS_SVG_SURFACE:
  *
  * Defined if the SVG surface backend is available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 typedef struct cairo_svg_page cairo_svg_page_t;
 
@@ -205,7 +205,7 @@ static const cairo_paginated_surface_backend_t cairo_svg_surface_paginated_backe
  * occurs. You can use cairo_surface_status() to check for this.
  *
  * Since: 1.2
- */
+ **/
 cairo_surface_t *
 cairo_svg_surface_create_for_stream (cairo_write_func_t		 write_func,
 				     void			*closure,
diff --git a/src/cairo-svg.h b/src/cairo-svg.h
index 0f739fc0..18fef32c 100644
--- a/src/cairo-svg.h
+++ b/src/cairo-svg.h
@@ -45,7 +45,7 @@ CAIRO_BEGIN_DECLS
  *
  * #cairo_svg_version_t is used to describe the version number of the SVG
  * specification that a generated SVG file will conform to.
- */
+ **/
 typedef enum _cairo_svg_version {
     CAIRO_SVG_VERSION_1_1,
     CAIRO_SVG_VERSION_1_2
diff --git a/src/cairo-types-private.h b/src/cairo-types-private.h
index 7fcdd1d6..3c2d21a3 100644
--- a/src/cairo-types-private.h
+++ b/src/cairo-types-private.h
@@ -52,7 +52,7 @@ CAIRO_BEGIN_DECLS
  * @Short_Description: Generic data types
  *
  * This section lists generic data types used in the cairo API.
- */
+ **/
 
 typedef struct _cairo_array cairo_array_t;
 typedef struct _cairo_backend cairo_backend_t;
diff --git a/src/cairo-user-font.c b/src/cairo-user-font.c
index 1b507fce..bdac6e40 100644
--- a/src/cairo-user-font.c
+++ b/src/cairo-user-font.c
@@ -49,7 +49,7 @@
  * in a font.  This is most useful in implementing fonts in non-standard
  * formats, like SVG fonts and Flash fonts, but can also be used by games and
  * other application to draw "funky" fonts.
- */
+ **/
 
 /**
  * CAIRO_HAS_USER_FONT:
@@ -60,7 +60,7 @@
  * this feature (1.8 and later).
  *
  * @Since: 1.8
- */
+ **/
 
 typedef struct _cairo_user_scaled_font_methods {
     cairo_user_scaled_font_init_func_t			init;
diff --git a/src/cairo-version.c b/src/cairo-version.c
index bc7fe109..11f919d2 100644
--- a/src/cairo-version.c
+++ b/src/cairo-version.c
@@ -137,39 +137,39 @@
  * </programlisting></informalexample>
  * </para>
  * </refsect2>
- */
+ **/
 
 /**
  * CAIRO_VERSION:
  *
  * The version of cairo available at compile-time, encoded using
  * CAIRO_VERSION_ENCODE().
- */
+ **/
 
 /**
  * CAIRO_VERSION_MAJOR:
  *
  * The major component of the version of cairo available at compile-time.
- */
+ **/
 
 /**
  * CAIRO_VERSION_MINOR:
  *
  * The minor component of the version of cairo available at compile-time.
- */
+ **/
 
 /**
  * CAIRO_VERSION_MICRO:
  *
  * The micro component of the version of cairo available at compile-time.
- */
+ **/
 
 /**
  * CAIRO_VERSION_STRING:
  *
  * A human-readable string literal containing the version of cairo available
  * at compile-time, in the form of "X.Y.Z".
- */
+ **/
 
 /**
  * CAIRO_VERSION_ENCODE:
@@ -183,7 +183,7 @@
  * that later versions compare greater than earlier versions.
  *
  * @Returns: the encoded version.
- */
+ **/
 
 /**
  * CAIRO_VERSION_STRINGIZE:
@@ -198,7 +198,7 @@
  * @Returns: a string literal containing the version.
  *
  * @Since: 1.8
- */
+ **/
 
 /**
  * cairo_version:
diff --git a/src/cairo-xcb-surface-render.c b/src/cairo-xcb-surface-render.c
index 13d92f74..b1f6ec83 100644
--- a/src/cairo-xcb-surface-render.c
+++ b/src/cairo-xcb-surface-render.c
@@ -58,7 +58,7 @@
  *
  * Note that the XCB surface automatically takes advantage of the X Render
  * extension if it is available.
- */
+ **/
 
 static cairo_status_t
 _clip_and_composite_boxes (cairo_xcb_surface_t *dst,
diff --git a/src/cairo-xcb-surface.c b/src/cairo-xcb-surface.c
index b254e2f0..fff4f52d 100644
--- a/src/cairo-xcb-surface.c
+++ b/src/cairo-xcb-surface.c
@@ -65,7 +65,7 @@ slim_hidden_proto (cairo_xcb_surface_create_with_xrender_format);
  *
  * Note that the XCB surface automatically takes advantage of the X render
  * extension if it is available.
- */
+ **/
 
 /**
  * CAIRO_HAS_XCB_SURFACE:
@@ -74,7 +74,7 @@ slim_hidden_proto (cairo_xcb_surface_create_with_xrender_format);
  * This macro can be used to conditionally compile backend-specific code.
  *
  * Since: 1.12
- */
+ **/
 
 cairo_surface_t *
 _cairo_xcb_surface_create_similar (void			*abstract_other,
diff --git a/src/cairo-xlib-surface.c b/src/cairo-xlib-surface.c
index 4664c961..0d473118 100644
--- a/src/cairo-xlib-surface.c
+++ b/src/cairo-xlib-surface.c
@@ -125,14 +125,14 @@ _x_bread_crumb (Display *dpy,
  *
  * Note that the XLib surface automatically takes advantage of X render extension
  * if it is available.
- */
+ **/
 
 /**
  * CAIRO_HAS_XLIB_SURFACE:
  *
  * Defined if the Xlib surface backend is available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 /**
  * SECTION:cairo-xlib-xrender
@@ -145,14 +145,14 @@ _x_bread_crumb (Display *dpy,
  *
  * Note that the XLib surface automatically takes advantage of X Render extension
  * if it is available.
- */
+ **/
 
 /**
  * CAIRO_HAS_XLIB_XRENDER_SURFACE:
  *
  * Defined if the XLib/XRender surface functions are available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 /* Xlib doesn't define a typedef, so define one ourselves */
 typedef int (*cairo_xlib_error_func_t) (Display     *display,
diff --git a/src/cairo.c b/src/cairo.c
index 002d199f..08ecff32 100644
--- a/src/cairo.c
+++ b/src/cairo.c
@@ -65,7 +65,7 @@
  * #cairo_t<!-- -->'s can be pushed to a stack via cairo_save().
  * They may then safely be changed, without losing the current state.
  * Use cairo_restore() to restore to the saved state.
- */
+ **/
 
 /**
  * SECTION:cairo-text
@@ -92,7 +92,7 @@
  * the pangocairo that is part of the Pango text layout and rendering library.
  * Pango is available from <ulink
  * url="http://www.pango.org/">http://www.pango.org/</ulink>.
- */
+ **/
 
 /**
  * SECTION:cairo-transforms
@@ -105,7 +105,7 @@
  * drawing instruments from the <firstterm>user space</firstterm> into the
  * surface's canonical coordinate system, also known as the <firstterm>device
  * space</firstterm>.
- */
+ **/
 
 #define DEFINE_NIL_CONTEXT(status)					\
     {									\
@@ -468,7 +468,7 @@ slim_hidden_def(cairo_restore);
  * </programlisting></informalexample>
  *
  * Since: 1.2
- */
+ **/
 void
 cairo_push_group (cairo_t *cr)
 {
@@ -493,7 +493,7 @@ cairo_push_group (cairo_t *cr)
  * detailed description of group rendering.
  *
  * Since: 1.2
- */
+ **/
 void
 cairo_push_group_with_content (cairo_t *cr, cairo_content_t content)
 {
@@ -1052,7 +1052,7 @@ cairo_set_dash (cairo_t	     *cr,
  * Return value: the length of the dash array, or 0 if no dash array set.
  *
  * Since: 1.4
- */
+ **/
 int
 cairo_get_dash_count (cairo_t *cr)
 {
@@ -1951,7 +1951,7 @@ cairo_paint_with_alpha (cairo_t *cr,
  * using the alpha channel of @pattern as a mask. (Opaque
  * areas of @pattern are painted with the source, transparent
  * areas are not painted.)
- */
+ **/
 void
 cairo_mask (cairo_t         *cr,
 	    cairo_pattern_t *pattern)
@@ -1988,7 +1988,7 @@ slim_hidden_def (cairo_mask);
  * using the alpha channel of @surface as a mask. (Opaque
  * areas of @surface are painted with the source, transparent
  * areas are not painted.)
- */
+ **/
 void
 cairo_mask_surface (cairo_t         *cr,
 		    cairo_surface_t *surface,
diff --git a/src/cairo.h b/src/cairo.h
index 37fdf0c4..5a4d6b1d 100644
--- a/src/cairo.h
+++ b/src/cairo.h
@@ -2824,7 +2824,7 @@ cairo_pattern_get_extend (cairo_pattern_t *pattern);
  * applied when reading pixel values from patterns. See
  * cairo_pattern_set_filter() for indicating the desired filter to be
  * used with a particular pattern.
- */
+ **/
 typedef enum _cairo_filter {
     CAIRO_FILTER_FAST,
     CAIRO_FILTER_GOOD,
diff --git a/src/win32/cairo-win32-display-surface.c b/src/win32/cairo-win32-display-surface.c
index a44b878d..f393cbe8 100644
--- a/src/win32/cairo-win32-display-surface.c
+++ b/src/win32/cairo-win32-display-surface.c
@@ -86,14 +86,14 @@
  *
  * The surface returned by the other win32 constructors is of surface type
  * %CAIRO_SURFACE_TYPE_WIN32 and is a raster surface type.
- */
+ **/
 
 /**
  * CAIRO_HAS_WIN32_SURFACE:
  *
  * Defined if the Microsoft Windows surface backend is available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 static const cairo_surface_backend_t cairo_win32_display_surface_backend;
 
diff --git a/src/win32/cairo-win32-font.c b/src/win32/cairo-win32-font.c
index d85d5c94..8ad4832a 100644
--- a/src/win32/cairo-win32-font.c
+++ b/src/win32/cairo-win32-font.c
@@ -77,14 +77,14 @@
  *
  * The Microsoft Windows font backend is primarily used to render text on
  * Microsoft Windows systems.
- */
+ **/
 
 /**
  * CAIRO_HAS_WIN32_FONT:
  *
  * Defined if the Microsoft Windows font backend is available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 const cairo_scaled_font_backend_t _cairo_win32_scaled_font_backend;
 
diff --git a/src/win32/cairo-win32-surface.c b/src/win32/cairo-win32-surface.c
index cec47a24..0dcbbf8a 100644
--- a/src/win32/cairo-win32-surface.c
+++ b/src/win32/cairo-win32-surface.c
@@ -80,14 +80,14 @@
  *
  * The surface returned by the other win32 constructors is of surface type
  * %CAIRO_SURFACE_TYPE_WIN32 and is a raster surface type.
- */
+ **/
 
 /**
  * CAIRO_HAS_WIN32_SURFACE:
  *
  * Defined if the Microsoft Windows surface backend is available.
  * This macro can be used to conditionally compile backend-specific code.
- */
+ **/
 
 /**
  * _cairo_win32_print_gdi_error:
@@ -181,7 +181,7 @@ cairo_win32_surface_get_dc (cairo_surface_t *surface)
  * or %NULL if the win32 surface is not a DIB.
  *
  * Since: 1.4
- */
+ **/
 cairo_surface_t *
 cairo_win32_surface_get_image (cairo_surface_t *surface)
 {