diff options
author | Uli Schlachter <psychon@znc.in> | 2014-02-27 10:56:20 +0100 |
---|---|---|
committer | Bryce Harrington <b.harrington@samsung.com> | 2014-03-13 17:12:43 -0700 |
commit | bc05dbccd7dd2f137038479b30ed71c98ff81da6 (patch) | |
tree | b247e9b69f0e8ae2acc3ea28f9570b77b4316f5c /src/cairo-cache-private.h | |
parent | 0c189910539aa05125b60e59b7101e9b9685582f (diff) | |
download | cairo-bc05dbccd7dd2f137038479b30ed71c98ff81da6.tar.gz |
Fix warnings from check-doc-syntax.sh
$ ./check-doc-syntax.sh
Checking documentation for incorrect syntax
./cairo-types-private.h (148): WARNING: cairo_hash_entry_t: missing 'Since' field (is it a private type?)
./cairo-types-private.h (161): WARNING: cairo_hash_entry_t: not found
./cairo-types-private.h (175): WARNING: cairo_lcd_filter_t: missing 'Since' field (is it a private type?)
./cairo-cache-private.h (85): WARNING: cairo_cache_entry_t: missing 'Since' field (is it a private type?)
./cairo-region.c (857): WARNING: cairo_region_overlap_t: not found
./cairo-raster-source-pattern.c (62): WARNING: SECTION:cairo-raster-source 'Since' field in non-public element
The warnings about missing 'Since' fields are fixed by changing the
documentation comment so that the script can see that these are private types.
The documentation for cairo_region_overlap_t gets moved to cairo.h, just like
e.g. the documentation for cairo_status_t.
The 'Since' field from the SECTION:cairo-raster-source is removed, because this
kind of field is needed on the individual functions and structs, not on the
section.
Thanks to Bryce Harrington for bringing this up!
Signed-off-by: Uli Schlachter <psychon@znc.in>
Tested-by: Bryce Harrington <b.harrington@samsung.com>
Diffstat (limited to 'src/cairo-cache-private.h')
-rw-r--r-- | src/cairo-cache-private.h | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/src/cairo-cache-private.h b/src/cairo-cache-private.h index 76b556194..24b6d0b20 100644 --- a/src/cairo-cache-private.h +++ b/src/cairo-cache-private.h @@ -43,7 +43,7 @@ #include "cairo-types-private.h" /** - * cairo_cache_entry_t: + * _cairo_cache_entry: * * A #cairo_cache_entry_t contains both a key and a value for * #cairo_cache_t. User-derived types for #cairo_cache_entry_t must |