[docs] Update templates

7 files changed, 267 insertions, 82 deletions

diff --git a/doc/public/tmpl/cairo-pattern.sgml b/doc/public/tmpl/cairo-pattern.sgml
index 9ffbe8b5..56b5a9d0 100644
--- a/doc/public/tmpl/cairo-pattern.sgml
+++ b/doc/public/tmpl/cairo-pattern.sgml
@@ -48,6 +48,31 @@ Gradients and filtered sources
 @alpha: 
 
 
+<!-- ##### FUNCTION cairo_pattern_get_color_stop_count ##### -->
+<para>
+
+</para>
+
+@pattern: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION cairo_pattern_get_color_stop_rgba ##### -->
+<para>
+
+</para>
+
+@pattern: 
+@index: 
+@offset: 
+@red: 
+@green: 
+@blue: 
+@alpha: 
+@Returns: 
+
+
 <!-- ##### FUNCTION cairo_pattern_create_rgb ##### -->
 <para>
 
@@ -71,6 +96,19 @@ Gradients and filtered sources
 @Returns: 
 
 
+<!-- ##### FUNCTION cairo_pattern_get_rgba ##### -->
+<para>
+
+</para>
+
+@pattern: 
+@red: 
+@green: 
+@blue: 
+@alpha: 
+@Returns: 
+
+
 <!-- ##### FUNCTION cairo_pattern_create_for_surface ##### -->
 <para>
 
@@ -80,6 +118,16 @@ Gradients and filtered sources
 @Returns: 
 
 
+<!-- ##### FUNCTION cairo_pattern_get_surface ##### -->
+<para>
+
+</para>
+
+@pattern: 
+@surface: 
+@Returns: 
+
+
 <!-- ##### FUNCTION cairo_pattern_create_linear ##### -->
 <para>
 
@@ -92,6 +140,19 @@ Gradients and filtered sources
 @Returns: 
 
 
+<!-- ##### FUNCTION cairo_pattern_get_linear_points ##### -->
+<para>
+
+</para>
+
+@pattern: 
+@x0: 
+@y0: 
+@x1: 
+@y1: 
+@Returns: 
+
+
 <!-- ##### FUNCTION cairo_pattern_create_radial ##### -->
 <para>
 
@@ -106,6 +167,21 @@ Gradients and filtered sources
 @Returns: 
 
 
+<!-- ##### FUNCTION cairo_pattern_get_radial_circles ##### -->
+<para>
+
+</para>
+
+@pattern: 
+@x0: 
+@y0: 
+@r0: 
+@x1: 
+@y1: 
+@r1: 
+@Returns: 
+
+
 <!-- ##### FUNCTION cairo_pattern_destroy ##### -->
 <para>
 
diff --git a/doc/public/tmpl/cairo-status.sgml b/doc/public/tmpl/cairo-status.sgml
index f943cac5..0f34961b 100644
--- a/doc/public/tmpl/cairo-status.sgml
+++ b/doc/public/tmpl/cairo-status.sgml
@@ -22,37 +22,37 @@ Decoding cairo's status
 
 </para>
 
-@CAIRO_STATUS_SUCCESS:
-@CAIRO_STATUS_NO_MEMORY:
-@CAIRO_STATUS_INVALID_RESTORE:
-@CAIRO_STATUS_INVALID_POP_GROUP:
-@CAIRO_STATUS_NO_CURRENT_POINT:
-@CAIRO_STATUS_INVALID_MATRIX:
-@CAIRO_STATUS_INVALID_STATUS:
-@CAIRO_STATUS_NULL_POINTER:
-@CAIRO_STATUS_INVALID_STRING:
-@CAIRO_STATUS_INVALID_PATH_DATA:
-@CAIRO_STATUS_READ_ERROR:
-@CAIRO_STATUS_WRITE_ERROR:
-@CAIRO_STATUS_SURFACE_FINISHED:
-@CAIRO_STATUS_SURFACE_TYPE_MISMATCH:
-@CAIRO_STATUS_PATTERN_TYPE_MISMATCH:
-@CAIRO_STATUS_INVALID_CONTENT:
-@CAIRO_STATUS_INVALID_FORMAT:
-@CAIRO_STATUS_INVALID_VISUAL:
-@CAIRO_STATUS_FILE_NOT_FOUND:
-@CAIRO_STATUS_INVALID_DASH:
-@CAIRO_STATUS_INVALID_DSC_COMMENT:
-@CAIRO_STATUS_INVALID_INDEX:
-@CAIRO_STATUS_CLIP_NOT_REPRESENTABLE:
+@CAIRO_STATUS_SUCCESS: 
+@CAIRO_STATUS_NO_MEMORY: 
+@CAIRO_STATUS_INVALID_RESTORE: 
+@CAIRO_STATUS_INVALID_POP_GROUP: 
+@CAIRO_STATUS_NO_CURRENT_POINT: 
+@CAIRO_STATUS_INVALID_MATRIX: 
+@CAIRO_STATUS_INVALID_STATUS: 
+@CAIRO_STATUS_NULL_POINTER: 
+@CAIRO_STATUS_INVALID_STRING: 
+@CAIRO_STATUS_INVALID_PATH_DATA: 
+@CAIRO_STATUS_READ_ERROR: 
+@CAIRO_STATUS_WRITE_ERROR: 
+@CAIRO_STATUS_SURFACE_FINISHED: 
+@CAIRO_STATUS_SURFACE_TYPE_MISMATCH: 
+@CAIRO_STATUS_PATTERN_TYPE_MISMATCH: 
+@CAIRO_STATUS_INVALID_CONTENT: 
+@CAIRO_STATUS_INVALID_FORMAT: 
+@CAIRO_STATUS_INVALID_VISUAL: 
+@CAIRO_STATUS_FILE_NOT_FOUND: 
+@CAIRO_STATUS_INVALID_DASH: 
+@CAIRO_STATUS_INVALID_DSC_COMMENT: 
+@CAIRO_STATUS_INVALID_INDEX: 
+@CAIRO_STATUS_CLIP_NOT_REPRESENTABLE: 
 
 <!-- ##### FUNCTION cairo_status_to_string ##### -->
 <para>
 
 </para>
 
-@status:
-@Returns:
+@status: 
+@Returns: 
 
 
 <!-- ##### FUNCTION cairo_debug_reset_static_data ##### -->
diff --git a/doc/public/tmpl/cairo-surface.sgml b/doc/public/tmpl/cairo-surface.sgml
index d9936365..2f7d49ec 100644
--- a/doc/public/tmpl/cairo-surface.sgml
+++ b/doc/public/tmpl/cairo-surface.sgml
@@ -28,20 +28,20 @@ Base class for surfaces
 
 </para>
 
-@CAIRO_CONTENT_COLOR:
-@CAIRO_CONTENT_ALPHA:
-@CAIRO_CONTENT_COLOR_ALPHA:
+@CAIRO_CONTENT_COLOR: 
+@CAIRO_CONTENT_ALPHA: 
+@CAIRO_CONTENT_COLOR_ALPHA: 
 
 <!-- ##### FUNCTION cairo_surface_create_similar ##### -->
 <para>
 
 </para>
 
-@other:
-@content:
-@width:
-@height:
-@Returns:
+@other: 
+@content: 
+@width: 
+@height: 
+@Returns: 
 
 
 <!-- ##### FUNCTION cairo_surface_destroy ##### -->
@@ -49,7 +49,7 @@ Base class for surfaces
 
 </para>
 
-@surface:
+@surface: 
 
 
 <!-- ##### FUNCTION cairo_surface_finish ##### -->
@@ -57,7 +57,7 @@ Base class for surfaces
 
 </para>
 
-@surface:
+@surface: 
 
 
 <!-- ##### FUNCTION cairo_surface_flush ##### -->
@@ -65,7 +65,7 @@ Base class for surfaces
 
 </para>
 
-@surface:
+@surface: 
 
 
 <!-- ##### FUNCTION cairo_surface_get_font_options ##### -->
@@ -73,8 +73,8 @@ Base class for surfaces
 
 </para>
 
-@surface:
-@options:
+@surface: 
+@options: 
 
 
 <!-- ##### FUNCTION cairo_surface_get_content ##### -->
@@ -82,8 +82,8 @@ Base class for surfaces
 
 </para>
 
-@surface:
-@Returns:
+@surface: 
+@Returns: 
 
 
 <!-- ##### FUNCTION cairo_surface_set_user_data ##### -->
@@ -91,11 +91,11 @@ Base class for surfaces
 
 </para>
 
-@surface:
-@key:
-@user_data:
-@destroy:
-@Returns:
+@surface: 
+@key: 
+@user_data: 
+@destroy: 
+@Returns: 
 
 
 <!-- ##### FUNCTION cairo_surface_get_user_data ##### -->
@@ -103,9 +103,9 @@ Base class for surfaces
 
 </para>
 
-@surface:
-@key:
-@Returns:
+@surface: 
+@key: 
+@Returns: 
 
 
 <!-- ##### FUNCTION cairo_surface_mark_dirty ##### -->
@@ -113,7 +113,7 @@ Base class for surfaces
 
 </para>
 
-@surface:
+@surface: 
 
 
 <!-- ##### FUNCTION cairo_surface_mark_dirty_rectangle ##### -->
@@ -121,11 +121,11 @@ Base class for surfaces
 
 </para>
 
-@surface:
-@x:
-@y:
-@width:
-@height:
+@surface: 
+@x: 
+@y: 
+@width: 
+@height: 
 
 
 <!-- ##### FUNCTION cairo_surface_reference ##### -->
@@ -133,8 +133,8 @@ Base class for surfaces
 
 </para>
 
-@surface:
-@Returns:
+@surface: 
+@Returns: 
 
 
 <!-- ##### FUNCTION cairo_surface_set_device_offset ##### -->
@@ -142,9 +142,9 @@ Base class for surfaces
 
 </para>
 
-@surface:
-@x_offset:
-@y_offset:
+@surface: 
+@x_offset: 
+@y_offset: 
 
 
 <!-- ##### FUNCTION cairo_surface_get_device_offset ##### -->
@@ -152,9 +152,9 @@ Base class for surfaces
 
 </para>
 
-@surface:
-@x_offset:
-@y_offset:
+@surface: 
+@x_offset: 
+@y_offset: 
 
 
 <!-- ##### FUNCTION cairo_surface_set_fallback_resolution ##### -->
@@ -162,9 +162,9 @@ Base class for surfaces
 
 </para>
 
-@surface:
-@x_pixels_per_inch:
-@y_pixels_per_inch:
+@surface: 
+@x_pixels_per_inch: 
+@y_pixels_per_inch: 
 
 
 <!-- ##### FUNCTION cairo_surface_status ##### -->
@@ -172,8 +172,8 @@ Base class for surfaces
 
 </para>
 
-@surface:
-@Returns:
+@surface: 
+@Returns: 
 
 
 <!-- ##### ENUM cairo_surface_type_t ##### -->
@@ -181,26 +181,26 @@ Base class for surfaces
 
 </para>
 
-@CAIRO_SURFACE_TYPE_IMAGE:
-@CAIRO_SURFACE_TYPE_PDF:
-@CAIRO_SURFACE_TYPE_PS:
-@CAIRO_SURFACE_TYPE_XLIB:
-@CAIRO_SURFACE_TYPE_XCB:
-@CAIRO_SURFACE_TYPE_GLITZ:
-@CAIRO_SURFACE_TYPE_QUARTZ:
-@CAIRO_SURFACE_TYPE_WIN32:
-@CAIRO_SURFACE_TYPE_BEOS:
-@CAIRO_SURFACE_TYPE_DIRECTFB:
-@CAIRO_SURFACE_TYPE_SVG:
-@CAIRO_SURFACE_TYPE_NQUARTZ:
-@CAIRO_SURFACE_TYPE_OS2:
+@CAIRO_SURFACE_TYPE_IMAGE: 
+@CAIRO_SURFACE_TYPE_PDF: 
+@CAIRO_SURFACE_TYPE_PS: 
+@CAIRO_SURFACE_TYPE_XLIB: 
+@CAIRO_SURFACE_TYPE_XCB: 
+@CAIRO_SURFACE_TYPE_GLITZ: 
+@CAIRO_SURFACE_TYPE_QUARTZ: 
+@CAIRO_SURFACE_TYPE_WIN32: 
+@CAIRO_SURFACE_TYPE_BEOS: 
+@CAIRO_SURFACE_TYPE_DIRECTFB: 
+@CAIRO_SURFACE_TYPE_SVG: 
+@CAIRO_SURFACE_TYPE_NQUARTZ: 
+@CAIRO_SURFACE_TYPE_OS2: 
 
 <!-- ##### FUNCTION cairo_surface_get_type ##### -->
 <para>
 
 </para>
 
-@surface:
-@Returns:
+@surface: 
+@Returns: 
 
 
diff --git a/doc/public/tmpl/cairo-text.sgml b/doc/public/tmpl/cairo-text.sgml
index 87f626c0..3db6bfda 100644
--- a/doc/public/tmpl/cairo-text.sgml
+++ b/doc/public/tmpl/cairo-text.sgml
@@ -22,6 +22,7 @@ Rendering text and sets of glyphs
 
 </para>
 
+@index: 
 @x: 
 @y: 
 
diff --git a/doc/public/tmpl/cairo-win32-fonts.sgml b/doc/public/tmpl/cairo-win32-fonts.sgml
index ab701c58..bc2aad87 100644
--- a/doc/public/tmpl/cairo-win32-fonts.sgml
+++ b/doc/public/tmpl/cairo-win32-fonts.sgml
@@ -62,3 +62,21 @@ Font support for Microsoft Windows
 @Returns: 
 
 
+<!-- ##### FUNCTION cairo_win32_scaled_font_get_logical_to_device ##### -->
+<para>
+
+</para>
+
+@scaled_font: 
+@logical_to_device: 
+
+
+<!-- ##### FUNCTION cairo_win32_scaled_font_get_device_to_logical ##### -->
+<para>
+
+</para>
+
+@scaled_font: 
+@device_to_logical: 
+
+
diff --git a/doc/public/tmpl/cairo-win32.sgml b/doc/public/tmpl/cairo-win32.sgml
index 91a8d04b..4e5dd34b 100644
--- a/doc/public/tmpl/cairo-win32.sgml
+++ b/doc/public/tmpl/cairo-win32.sgml
@@ -37,6 +37,18 @@ Microsoft Windows surface support
 @Returns: 
 
 
+<!-- ##### FUNCTION cairo_win32_surface_create_with_ddb ##### -->
+<para>
+
+</para>
+
+@hdc: 
+@format: 
+@width: 
+@height: 
+@Returns: 
+
+
 <!-- ##### FUNCTION cairo_win32_surface_get_dc ##### -->
 <para>
 
@@ -46,3 +58,12 @@ Microsoft Windows surface support
 @Returns: 
 
 
+<!-- ##### FUNCTION cairo_win32_surface_get_image ##### -->
+<para>
+
+</para>
+
+@surface: 
+@Returns: 
+
+
diff --git a/doc/public/tmpl/cairo.sgml b/doc/public/tmpl/cairo.sgml
index 3dc350ec..739f74bb 100644
--- a/doc/public/tmpl/cairo.sgml
+++ b/doc/public/tmpl/cairo.sgml
@@ -227,6 +227,27 @@ The cairo drawing context
 @offset: 
 
 
+<!-- ##### FUNCTION cairo_get_dash_count ##### -->
+<para>
+
+</para>
+
+@cr: 
+@count: 
+@Returns: 
+
+
+<!-- ##### FUNCTION cairo_get_dash ##### -->
+<para>
+
+</para>
+
+@cr: 
+@dashes: 
+@offset: 
+@Returns: 
+
+
 <!-- ##### ENUM cairo_fill_rule_t ##### -->
 <para>
 
@@ -415,6 +436,18 @@ The cairo drawing context
 @cr: 
 
 
+<!-- ##### FUNCTION cairo_clip_extents ##### -->
+<para>
+
+</para>
+
+@cr: 
+@x1: 
+@y1: 
+@x2: 
+@y2: 
+
+
 <!-- ##### FUNCTION cairo_reset_clip ##### -->
 <para>
 
@@ -423,6 +456,42 @@ The cairo drawing context
 @cr: 
 
 
+<!-- ##### STRUCT cairo_rectangle_t ##### -->
+<para>
+
+</para>
+
+@x: 
+@y: 
+@width: 
+@height: 
+
+<!-- ##### STRUCT cairo_rectangle_list_t ##### -->
+<para>
+
+</para>
+
+@status: 
+@rectangles: 
+@num_rectangles: 
+
+<!-- ##### FUNCTION cairo_rectangle_list_destroy ##### -->
+<para>
+
+</para>
+
+@rectangle_list: 
+
+
+<!-- ##### FUNCTION cairo_copy_clip_rectangles ##### -->
+<para>
+
+</para>
+
+@cr: 
+@Returns: 
+
+
 <!-- ##### FUNCTION cairo_fill ##### -->
 <para>