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

On Mon, Oct 27, 2014 at 10:54:13AM +0530, Ravi Nanjundappa wrote:
> $ ./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 <[email protected]>

Thanks for working on this, I noted some of these issues during the
release process.
Merged to master.

Reviewed-by: Bryce Harrington <[email protected]>

> ---
>  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
> 
> -- 
> cairo mailing list
> [email protected]
> http://lists.cairographics.org/mailman/listinfo/cairo
-- 
cairo mailing list
[email protected]
http://lists.cairographics.org/mailman/listinfo/cairo