[cairo] [PATCH] Fix warnings from check-doc-syntax.sh

Ravi Nanjundappa nravi.n at samsung.com
Sun Oct 26 22:24:13 PDT 2014


$ ./check-doc-syntax.sh
Checking documentation for incorrect syntax
./cairo-pattern.c (3346): ERROR: Will bad line: ' */'
./cairo-pattern.c (3346): ERROR: Will documentation comment not closed with **/
./cairo-pattern.c (3422): ERROR: _cairo_pattern_sampled_area invalid doc id (should be 'cairo_...:')

The warnings are about the documentation style used in cairo

Signed-off-by: Ravi Nanjundappa <nravi.n at samsung.com>
---
 src/cairo-pattern.c |    4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/cairo-pattern.c b/src/cairo-pattern.c
index 010de5c..4e3617a 100644
--- a/src/cairo-pattern.c
+++ b/src/cairo-pattern.c
@@ -3343,7 +3343,7 @@ _cairo_pattern_is_clear (const cairo_pattern_t *abstract_pattern)
  * This is true for scales larger than 1. Also it was judged acceptable
  * for scales larger than .75. And if there is integer translation
  * then a scale of exactly .5 works.
- */
+ **/
 static int
 use_bilinear(double x, double y, double t)
 {
@@ -3419,7 +3419,7 @@ _cairo_hypot(double x, double y)
 }
 
 /**
- * _cairo_pattern_sampled_area
+ * _cairo_pattern_sampled_area:
  *
  * Return region of @pattern that will be sampled to fill @extents,
  * based on the transformation and filter.
-- 
1.7.9.5



More information about the cairo mailing list