Protect less-than and greater-than symbols in documentation string.

8 files changed, 26 insertions, 43 deletions

diff --git a/ChangeLog b/ChangeLog
index a2a7ead69..3e6e5811b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2005-05-22  Carl Worth  <cworth@cworth.org>
 
+	* src/cairo.c (cairo_create): Protect less-than and greater-than
+	symbols in documentation string.
+
 	* TODO: Not that a patch has been submitted for consistent error
 	handling.
 	
diff --git a/doc/public/tmpl/cairo-atsui.sgml b/doc/public/tmpl/cairo-atsui.sgml
index a47ee8c68..4a8b35aaf 100644
--- a/doc/public/tmpl/cairo-atsui.sgml
+++ b/doc/public/tmpl/cairo-atsui.sgml
@@ -17,12 +17,3 @@ ATSUI Fonts
 <!-- ##### SECTION Stability_Level ##### -->
 
 
-<!-- ##### FUNCTION cairo_atsui_font_create ##### -->
-<para>
-
-</para>
-
-@style: 
-@Returns: 
-
-
diff --git a/doc/public/tmpl/cairo-pdf.sgml b/doc/public/tmpl/cairo-pdf.sgml
index 8ff0ea17e..2aa1473e1 100644
--- a/doc/public/tmpl/cairo-pdf.sgml
+++ b/doc/public/tmpl/cairo-pdf.sgml
@@ -22,31 +22,19 @@ PDF Backend
 
 </para>
 
+@filename: 
+@width_in_points: 
+@height_in_points: 
+@Returns: 
+<!-- # Unused Parameters # -->
 @fp: 
 @width_inches: 
 @height_inches: 
 @x_pixels_per_inch: 
 @y_pixels_per_inch: 
-@Returns: 
-<!-- # Unused Parameters # -->
 @write_func: 
 @destroy_closure_func: 
 @closure: 
 @file: 
 
 
-<!-- ##### FUNCTION cairo_pdf_surface_create_for_callback ##### -->
-<para>
-
-</para>
-
-@write_func: 
-@destroy_closure_func: 
-@closure: 
-@width_inches: 
-@height_inches: 
-@x_pixels_per_inch: 
-@y_pixels_per_inch: 
-@Returns: 
-
-
diff --git a/doc/public/tmpl/cairo-ps.sgml b/doc/public/tmpl/cairo-ps.sgml
index 4cb4a0268..a137f8d75 100644
--- a/doc/public/tmpl/cairo-ps.sgml
+++ b/doc/public/tmpl/cairo-ps.sgml
@@ -22,11 +22,15 @@ PS Backend
 
 </para>
 
+@filename: 
+@width_in_points: 
+@height_in_points: 
+@Returns: 
+<!-- # Unused Parameters # -->
 @file: 
 @width_inches: 
 @height_inches: 
 @x_pixels_per_inch: 
 @y_pixels_per_inch: 
-@Returns: 
 
 
diff --git a/doc/public/tmpl/cairo-xcb.sgml b/doc/public/tmpl/cairo-xcb.sgml
index 416d71638..25b2f0aa1 100644
--- a/doc/public/tmpl/cairo-xcb.sgml
+++ b/doc/public/tmpl/cairo-xcb.sgml
@@ -22,10 +22,15 @@ XCB Backend
 
 </para>
 
+@c: 
+@pixmap: 
+@visual: 
+@width: 
+@height: 
+@Returns: 
+<!-- # Unused Parameters # -->
 @dpy: 
 @drawable: 
-@visual: 
 @format: 
-@Returns: 
 
 
diff --git a/doc/public/tmpl/cairo-xlib.sgml b/doc/public/tmpl/cairo-xlib.sgml
index 30282b226..2357ea4c3 100644
--- a/doc/public/tmpl/cairo-xlib.sgml
+++ b/doc/public/tmpl/cairo-xlib.sgml
@@ -24,24 +24,15 @@ XLib Backend
 
 @dpy: 
 @drawable: 
-@format: 
+@visual: 
+@width: 
+@height: 
 @Returns: 
 <!-- # Unused Parameters # -->
-@visual: 
+@format: 
 @colormap: 
 
 
-<!-- ##### FUNCTION cairo_xlib_surface_create_with_visual ##### -->
-<para>
-
-</para>
-
-@dpy: 
-@drawable: 
-@visual: 
-@Returns: 
-
-
 <!-- ##### FUNCTION cairo_xlib_surface_set_size ##### -->
 <para>
 
diff --git a/doc/public/tmpl/cairo.sgml b/doc/public/tmpl/cairo.sgml
index 06a5fba6d..6deaeb580 100644
--- a/doc/public/tmpl/cairo.sgml
+++ b/doc/public/tmpl/cairo.sgml
@@ -718,6 +718,7 @@ Drawing contexts.
 
 @cr: 
 @matrix: 
+<!-- # Unused Parameters # -->
 @Returns: 
 
 
diff --git a/src/cairo.c b/src/cairo.c
index baee2e876..4dcfac853 100644
--- a/src/cairo.c
+++ b/src/cairo.c
@@ -81,7 +81,7 @@ cairo_sane_state (cairo_t *cr)
  * default values and with @target as a target surface. The target
  * surface should be constructed with a backend-specific function such
  * as cairo_image_surface_create (or any other
- * cairo_<backend>_surface_create variant).
+ * cairo_&lt;backend&gt;_surface_create variant).
  *
  * This function references @target, so you can immediately
  * call cairo_surface_destroy() on it if you don't need to