[cairo] [PATCH 04/12] doc: Manually fix remaining warnings about symmetry

Andrea Canciani ranma42 at gmail.com
Tue Mar 27 04:25:51 PDT 2012


The Python script is unable to fix all of the warnings, because some
point to comments that are not actually documentation.

Fixes the remaining 'documentation comment not closed with **/'
warnings.
---
 src/cairo-gl-surface-legacy.c |    2 +-
 src/cairo-qt-surface.cpp      |    2 +-
 src/cairo-skia-surface.cpp    |    4 ++--
 src/cairo-wideint.c           |    3 ++-
 4 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/cairo-gl-surface-legacy.c b/src/cairo-gl-surface-legacy.c
index 0ba356e..fe35e29 100644
--- a/src/cairo-gl-surface-legacy.c
+++ b/src/cairo-gl-surface-legacy.c
@@ -141,7 +141,7 @@ _cairo_gl_surface_clone_similar (void		     *abstract_surface,
     return UNSUPPORTED ("unknown src surface type in clone_similar");
 }
 
-/** Creates a cairo-gl pattern surface for the given trapezoids */
+/* Creates a cairo-gl pattern surface for the given trapezoids */
 static cairo_status_t
 _cairo_gl_get_traps_pattern (cairo_gl_surface_t *dst,
 			     int dst_x, int dst_y,
diff --git a/src/cairo-qt-surface.cpp b/src/cairo-qt-surface.cpp
index fbbe5a6..b75f522 100644
--- a/src/cairo-qt-surface.cpp
+++ b/src/cairo-qt-surface.cpp
@@ -313,7 +313,7 @@ _qmatrix_from_cairo_matrix (const cairo_matrix_t& m)
     return QMatrix(m.xx, m.yx, m.xy, m.yy, m.x0, m.y0);
 }
 
-/** Path conversion **/
+/* Path conversion */
 typedef struct _qpainter_path_transform {
     QPainterPath path;
     const cairo_matrix_t *ctm_inverse;
diff --git a/src/cairo-skia-surface.cpp b/src/cairo-skia-surface.cpp
index 537c1bc..21d6f07 100644
--- a/src/cairo-skia-surface.cpp
+++ b/src/cairo-skia-surface.cpp
@@ -1151,7 +1151,7 @@ cairo_skia_surface_get_image (cairo_surface_t *surface)
     return &_get_image_surface (esurf)->base;
 }
 
-/***
+/*
 
 Todo:
 
@@ -1171,4 +1171,4 @@ Medium:
 Low:
 - implement EXTEND_NONE
 
-***/
+*/
diff --git a/src/cairo-wideint.c b/src/cairo-wideint.c
index 59af2c8..bba266b 100644
--- a/src/cairo-wideint.c
+++ b/src/cairo-wideint.c
@@ -704,7 +704,8 @@ _cairo_int128_divrem (cairo_int128_t num, cairo_int128_t den)
  * bits then the returned remainder is equal to the divisor, and the
  * quotient is the largest representable 64 bit integer.  It is an
  * error to call this function with the high 32 bits of @num being
- * non-zero. */
+ * non-zero.
+ **/
 cairo_uquorem64_t
 _cairo_uint_96by64_32x64_divrem (cairo_uint128_t num,
 				 cairo_uint64_t den)
-- 
1.7.5.4



More information about the cairo mailing list