[cairo-commit] cairo/doc/public/tmpl cairo-matrix.sgml, 1.9, 1.10 cairo-paths.sgml, 1.1, 1.2

[Billy Biggs]

Committed by: vektor

Update of /cvs/cairo/cairo/doc/public/tmpl
In directory gabe:/tmp/cvs-serv21181/doc/public/tmpl

Modified Files:
	cairo-matrix.sgml cairo-paths.sgml 
Log Message:
	* doc/public/tmpl/cairo-matrix.sgml: Update the long description
	of cairo_matrix_t to match the current sources.
	* doc/public/tmpl/cairo-paths.sgml: Add cairo_path_data_t.
	* src/cairo-ft-font.c:
	* src/cairo-path-data.c:
	* src/cairo-pattern.c:
	* src/cairo.c:
	* src/cairo.h: Some documentation updates and improvements.



Index: cairo-matrix.sgml
===================================================================
RCS file: /cvs/cairo/cairo/doc/public/tmpl/cairo-matrix.sgml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- cairo-matrix.sgml	23 Aug 2005 05:11:44 -0000	1.9
+++ cairo-matrix.sgml	24 Aug 2005 02:52:09 -0000	1.10
@@ -9,29 +9,21 @@
 <!-- ##### SECTION Long_Description ##### -->
 
   <para><indexterm><primary>types</primary><secondary>cairo_matrix</secondary></indexterm><indexterm><primary/></indexterm>
-    <structname>cairo_matrix_t</structname> is used throughout
-    Cairo to represents between different coordinates spaces.
-    A <structname>cairo_matrix</structname> holds an affine
-    transformation, such as a scale, rotation, or shear, or a
-    combination of those. Mathematically, the effect of an affine
-    transformation on a point (<literal>x</literal>,<literal>y</literal>) is given by:
+    #cairo_matrix_t is used throughout Cairo to convert between different
+    coordinate spaces.  A #cairo_matrix_t holds an affine transformation,
+    such as a scale, rotation, shear, or a combination of these.
+    The transformation on a point (<literal>x</literal>,<literal>y</literal>)
+    is given by:
   </para>
   <programlisting>
-    x_new = x * a + y * c + tx;
-    y_new = x * b + y * d + ty;
+    x_new = xx * x + xy * y + x0;
+    y_new = yx * x + yy * y + y0;
   </programlisting>
   <para>
-    The parameters <literal>a</literal>, <literal>b</literal>,
-    <literal>c</literal>, <literal>d</literal>, <literal>tx</literal>,
-    <literal>ty</literal> can be retrieved with
-    cairo_matrix_get_affine() and set with cairo_matrix_get_affine().
-  </para>
-  <para>
-    The primary use of transformation matrices in Cairo is as the
-    current transformation matrix in a #cairo_t. The current
-    transformation matrix gives the transformation from user space
-    coordinates to device coordinates. See cairo_set_matrix(),
-    cairo_current_matrix().
+    The current transformation matrix of a #cairo_t, represented as a
+    #cairo_matrix_t, defines the transformation from user space
+    coordinates to device coordinates. See cairo_get_matrix() and
+    cairo_set_matrix().
   </para>
 
 <!-- ##### SECTION See_Also ##### -->

Index: cairo-paths.sgml
===================================================================
RCS file: /cvs/cairo/cairo/doc/public/tmpl/cairo-paths.sgml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- cairo-paths.sgml	23 Aug 2005 05:11:44 -0000	1.1
+++ cairo-paths.sgml	24 Aug 2005 02:52:09 -0000	1.2
@@ -28,6 +28,12 @@
 @data: 
 @num_data: 
 
+<!-- ##### UNION cairo_path_data_t ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ENUM cairo_path_data_type_t ##### -->
 <para>