[cairo] [PATCH 03/12] doc: Make documentation comments symmetric
Andrea Canciani
ranma42 at gmail.com
Tue Mar 27 04:25:50 PDT 2012
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.
---
src/cairo-beos-surface.cpp | 2 +-
src/cairo-device.c | 2 +-
src/cairo-font-face.c | 2 +-
src/cairo-font-options.c | 2 +-
src/cairo-ft-font.c | 6 +++---
src/cairo-gl.h | 2 +-
src/cairo-gstate.c | 2 +-
src/cairo-image-surface.c | 4 ++--
src/cairo-malloc-private.h | 10 +++++-----
src/cairo-matrix.c | 2 +-
src/cairo-misc.c | 14 +++++++-------
src/cairo-path-stroke.c | 2 +-
src/cairo-path.c | 2 +-
src/cairo-pattern.c | 12 ++++++------
src/cairo-pdf-surface.c | 8 ++++----
src/cairo-pdf.h | 2 +-
src/cairo-png.c | 4 ++--
src/cairo-ps-surface.c | 6 +++---
src/cairo-ps.h | 2 +-
src/cairo-quartz-font.c | 6 +++---
src/cairo-quartz-image-surface.c | 2 +-
src/cairo-quartz-surface.c | 4 ++--
src/cairo-recording-surface.c | 4 ++--
src/cairo-region.c | 4 ++--
src/cairo-scaled-font.c | 2 +-
src/cairo-script-surface.c | 4 ++--
src/cairo-surface.c | 22 +++++++++++-----------
src/cairo-svg-surface.c | 6 +++---
src/cairo-svg.h | 2 +-
src/cairo-types-private.h | 2 +-
src/cairo-user-font.c | 4 ++--
src/cairo-version.c | 16 ++++++++--------
src/cairo-xcb-surface-render.c | 2 +-
src/cairo-xcb-surface.c | 4 ++--
src/cairo-xlib-surface.c | 8 ++++----
src/cairo.c | 16 ++++++++--------
src/cairo.h | 2 +-
src/win32/cairo-win32-display-surface.c | 4 ++--
src/win32/cairo-win32-font.c | 4 ++--
src/win32/cairo-win32-surface.c | 6 +++---
40 files changed, 105 insertions(+), 105 deletions(-)
diff --git a/src/cairo-beos-surface.cpp b/src/cairo-beos-surface.cpp
index 2d96778..eb672b6 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 fd1ec71..098f856 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 e379b25..f429da0 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 521d371..709c5f8 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 70e4a9e..69a701c 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 407a224..dd17be6 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 d232f9b..a2ec371 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 2a2d59d..52f1af8 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 3414bb8..1e2c67f 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 59f0b86..c3b9263 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 27c264b..60edaae 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 f25cfe4..2d32b91 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 d3d9131..f2a02f1 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 205dfe0..c4e6d31 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 b758d00..9658957 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 50460cc..1ddee3d 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 59bbe68..b36c8df 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 88c4834..c881516 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 fd1d21d..edd1e95 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 53d5c35..0336972 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 5adf521..763ce96 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 cdd5865..1141cd5 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 ebe6f50..4b42dab 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 9e03272..c3785eb 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 b1c4b87..29cea06 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 f235be9..e307c1b 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 237a17c..066c30c 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 7f87c93..950cb1f 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 0f739fc..18fef32 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 7fcdd1d..3c2d21a 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 1b507fc..bdac6e4 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 bc7fe10..11f919d 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 13d92f7..b1f6ec8 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 b254e2f..fff4f52 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 4664c96..0d47311 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 002d199..08ecff3 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 37fdf0c..5a4d6b1 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 a44b878..f393cbe 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 d85d5c9..8ad4832 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 cec47a2..0dcbbf8 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)
{
--
1.7.5.4
More information about the cairo
mailing list