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

Andrea Canciani <[email protected]>
Newsgroups gmane.comp.lib.cairo
Message-ID <[email protected]>
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

--
cairo mailing list
[email protected]
http://lists.cairographics.org/mailman/listinfo/cairo
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.