From 398e813e3d7056ac288013a7c7eec7631df653c9 Mon Sep 17 00:00:00 2001
From: Martin Samesch <samesch@php.net>
Date: Tue, 29 Aug 2000 18:02:22 +0000
Subject: [PATCH] some more re-indenting,....

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@31493 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/cpdf.xml | 483 +++++++++++++++++++++++----------------------
 1 file changed, 246 insertions(+), 237 deletions(-)

diff --git a/functions/cpdf.xml b/functions/cpdf.xml
index 388b1112b8..adfbf57bba 100644
--- a/functions/cpdf.xml
+++ b/functions/cpdf.xml
@@ -666,10 +666,10 @@ cpdf_end_text($pdf)
      (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>).
     </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the
-     coordinates are measured in postscript points disregarding the current
-     unit.
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page is
+     used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
      <note>
       <simpara>
        The function <function>cpdf_show_xy</function> is identical to
@@ -711,13 +711,14 @@ cpdf_end_text($pdf)
      <parameter>text</parameter> at position with coordinates
      (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>).
     </para>
-    <para
-     The optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the
-     coordinates are measured in postscript points disregarding the current
-     unit. The optional parameter <parameter>orientation</parameter> is the rotation
-     of the text in degree. The optional parameter
-     <parameter>alignmode</parameter> determines how the text is align.
+    <para>
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page is
+     used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit. The optional parameter
+     <parameter>orientation</parameter> is the rotation of the text in degree.
+     The optional parameter <parameter>alignmode</parameter> determines how the
+     text is align.
     </para>
     <para>
      See the ClibPDF documentation for possible values.
@@ -900,10 +901,10 @@ cpdf_end_text($pdf)
      function call.
     </para>
     <para>
-     The last optional parameter <parameter>mode</parameter> determines
-     the unit length. If is 0 or omitted the default unit as specified
-     for the page is used. Otherwise the coodinates are measured in
-     postscript points disregarding the current unit.
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page is
+     used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
     </para>
     <para>
      See also <function>cpdf_show</function>,
@@ -1096,10 +1097,10 @@ cpdf_restore($pdf)
      <parameter>y-coor</parameter>).
     </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the
-     coordinates are measured in postscript points disregarding the current
-     unit.
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page
+     is used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
     </para>
    </refsect1>
   </refentry>
@@ -1121,8 +1122,8 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_scale</function> function set the scaling factor
-     in both directions.</para>
-
+     in both directions.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1142,8 +1143,8 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_rotate</function> function set the rotation in
-     degress to <parameter>angle</parameter>.</para>
-
+     degress to <parameter>angle</parameter>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1163,8 +1164,8 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_setflat</function> function set the flatness to
-     a value between 0 and 100.</para>
-
+     a value between 0 and 100.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1184,8 +1185,8 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_setlinejoin</function> function set the linejoin
-     parameter between a value of 0 and 2. 0 = miter, 1 = round, 2 = bevel.</para>
-
+     parameter between a value of 0 and 2. 0 = miter, 1 = round, 2 = bevel.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1206,8 +1207,8 @@ cpdf_restore($pdf)
     <para>
      The <function>cpdf_setlinecap</function> function set the linecap
      parameter between a value of 0 and 2. 0 = butt end, 1 = round,
-     2 = projecting square.</para>
-
+     2 = projecting square.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1227,8 +1228,8 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_setmiterlimit</function> function set the miter limit
-     to a value greater or equal than 1.</para>
-
+     to a value greater or equal than 1.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1248,8 +1249,8 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_setlinewidth</function> function set the line width
-     to <parameter>width</parameter>.</para>
-
+     to <parameter>width</parameter>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1271,35 +1272,33 @@ cpdf_restore($pdf)
     <para>
      The <function>cpdf_setdash</function> function set the dash pattern
      <parameter>white</parameter> white units and <parameter>black</parameter>
-     black units. If both are 0 a solid line is set.</para>
-
+     black units. If both are 0 a solid line is set.
+    </para>
    </refsect1>
   </refentry>
   
   <refentry id="function.cpdf-newpath">
-    <refnamediv>
-      <refname>cpdf_newpath</refname>
-      <refpurpose>
-        Starts a new path
-      </refpurpose>
-    </refnamediv>
-    <refsect1>
-      <title>Description</title>
-      <funcsynopsis>
+   <refnamediv>
+    <refname>cpdf_newpath</refname>
+    <refpurpose>Starts a new path</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
      <funcprototype>
-         <funcdef>void 
-           <function>cpdf_newpath</function>
-         </funcdef>
-         <paramdef>int 
-           <parameter>pdf_document</parameter>
-         </paramdef>
+      <funcdef>void 
+       <function>cpdf_newpath</function>
+      </funcdef>
+      <paramdef>int 
+       <parameter>pdf_document</parameter>
+      </paramdef>
      </funcprototype>
-      </funcsynopsis>
-      <para>
-        The <function>cpdf_newpath</function> starts a new path on the document
-        given by the <parameter>pdf_document</parameter> parameter.
-      </para>
-    </refsect1>
+    </funcsynopsis>
+    <para>
+     The <function>cpdf_newpath</function> starts a new path on the document
+     given by the <parameter>pdf_document</parameter> parameter.
+    </para>
+   </refsect1>
   </refentry>
   
   <refentry id="function.cpdf-moveto">
@@ -1313,21 +1312,22 @@ cpdf_restore($pdf)
      <funcprototype>
       <funcdef>void <function>cpdf_moveto</function></funcdef>
       <paramdef>int <parameter>pdf document</parameter></paramdef>
-      <paramdef>double <parameter>x-koor</parameter></paramdef>
-      <paramdef>double <parameter>y-koor</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>double <parameter>x-coor</parameter></paramdef>
+      <paramdef>double <parameter>y-coor</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>cpdf_moveto</function> function set the current point
-     to the coordinates <parameter>x-koor</parameter> and
-     <parameter>y-koor</parameter>.</para>
-
+     to the coordinates <parameter>x-coor</parameter> and
+     <parameter>y-coor</parameter>.
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
-
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page is
+     used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1342,23 +1342,25 @@ cpdf_restore($pdf)
      <funcprototype>
       <funcdef>void <function>cpdf_rmoveto</function></funcdef>
       <paramdef>int <parameter>pdf document</parameter></paramdef>
-      <paramdef>double <parameter>x-koor</parameter></paramdef>
-      <paramdef>double <parameter>y-koor</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>double <parameter>x-coor</parameter></paramdef>
+      <paramdef>double <parameter>y-coor</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>cpdf_rmoveto</function> function set the current point
-     relative to the coordinates <parameter>x-koor</parameter> and
-     <parameter>y-koor</parameter>.</para>
-
+     relative to the coordinates <parameter>x-coor</parameter> and
+     <parameter>y-coor</parameter>.
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
-
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page is
+     used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
     <para>
-     See also <function>cpdf_moveto</function>.</para>
+     See also <function>cpdf_moveto</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1379,7 +1381,7 @@ cpdf_restore($pdf)
       <paramdef>double <parameter>y2</parameter></paramdef>
       <paramdef>double <parameter>x3</parameter></paramdef>
       <paramdef>double <parameter>y3</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
@@ -1388,19 +1390,20 @@ cpdf_restore($pdf)
      (<parameter>x3</parameter>, <parameter>y3</parameter>) using
      (<parameter>x1</parameter>, <parameter>y1</parameter>) and
      (<parameter>x2</parameter>, <parameter>y2</parameter>) as control
-     points.</para>
-
+     points.
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
-
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page is
+     used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
     <para>
      See also <function>cpdf_moveto</function>,
               <function>cpdf_rmoveto</function>,
               <function>cpdf_rlineto</function>,
-              <function>cpdf_lineto</function>.</para>
-
+              <function>cpdf_lineto</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1415,26 +1418,27 @@ cpdf_restore($pdf)
      <funcprototype>
       <funcdef>void <function>cpdf_lineto</function></funcdef>
       <paramdef>int <parameter>pdf document</parameter></paramdef>
-      <paramdef>double <parameter>x-koor</parameter></paramdef>
-      <paramdef>double <parameter>y-koor</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>double <parameter>x-coor</parameter></paramdef>
+      <paramdef>double <parameter>y-coor</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>cpdf_lineto</function> function draws a line from
      the current point to the point with coordinates
-     (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>).</para>
-
+     (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>).
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
-
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page
+     is used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
     <para>
      See also <function>cpdf_moveto</function>,
               <function>cpdf_rmoveto</function>,
-              <function>cpdf_curveto</function>.</para>
-
+              <function>cpdf_curveto</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1449,26 +1453,27 @@ cpdf_restore($pdf)
      <funcprototype>
       <funcdef>void <function>cpdf_rlineto</function></funcdef>
       <paramdef>int <parameter>pdf document</parameter></paramdef>
-      <paramdef>double <parameter>x-koor</parameter></paramdef>
-      <paramdef>double <parameter>y-koor</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>double <parameter>x-coor</parameter></paramdef>
+      <paramdef>double <parameter>y-coor</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>cpdf_rlineto</function> function draws a line from
      the current point to the relative point with coordinates
-     (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>).</para>
-
+     (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>).
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
-
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page
+     is used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
     <para>
      See also <function>cpdf_moveto</function>,
               <function>cpdf_rmoveto</function>,
-              <function>cpdf_curveto</function>.</para>
-
+              <function>cpdf_curveto</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1483,26 +1488,27 @@ cpdf_restore($pdf)
      <funcprototype>
       <funcdef>void <function>cpdf_circle</function></funcdef>
       <paramdef>int <parameter>pdf document</parameter></paramdef>
-      <paramdef>double <parameter>x-koor</parameter></paramdef>
-      <paramdef>double <parameter>y-koor</parameter></paramdef>
+      <paramdef>double <parameter>x-coor</parameter></paramdef>
+      <paramdef>double <parameter>y-coor</parameter></paramdef>
       <paramdef>double <parameter>radius</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>cpdf_circle</function> function draws a circle with
      center at point 
-     (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>)
-     and radius <parameter>radius</parameter>.</para>
-
+     (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>)
+     and radius <parameter>radius</parameter>.
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
-
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page
+     is used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
     <para>
-     See also <function>cpdf_arc</function>.</para>
-
+     See also <function>cpdf_arc</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1517,30 +1523,31 @@ cpdf_restore($pdf)
      <funcprototype>
       <funcdef>void <function>cpdf_arc</function></funcdef>
       <paramdef>int <parameter>pdf document</parameter></paramdef>
-      <paramdef>double <parameter>x-koor</parameter></paramdef>
-      <paramdef>double <parameter>y-koor</parameter></paramdef>
+      <paramdef>double <parameter>x-coor</parameter></paramdef>
+      <paramdef>double <parameter>y-coor</parameter></paramdef>
       <paramdef>double <parameter>radius</parameter></paramdef>
       <paramdef>double <parameter>start</parameter></paramdef>
       <paramdef>double <parameter>end</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>cpdf_arc</function> function draws an arc with
      center at point 
-     (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>)
+     (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>)
      and radius <parameter>radius</parameter>, starting at angle
      <parameter>start</parameter> and ending at angle
-     <parameter>end</parameter>.</para>
-
+     <parameter>end</parameter>.
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
-
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page
+     is used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
     <para>
-     See also <function>cpdf_circle</function>.</para>
-
+     See also <function>cpdf_circle</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1555,25 +1562,26 @@ cpdf_restore($pdf)
      <funcprototype>
       <funcdef>void <function>cpdf_rect</function></funcdef>
       <paramdef>int <parameter>pdf document</parameter></paramdef>
-      <paramdef>double <parameter>x-koor</parameter></paramdef>
-      <paramdef>double <parameter>y-koor</parameter></paramdef>
+      <paramdef>double <parameter>x-coor</parameter></paramdef>
+      <paramdef>double <parameter>y-coor</parameter></paramdef>
       <paramdef>double <parameter>width</parameter></paramdef>
       <paramdef>double <parameter>height</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>cpdf_rect</function> function draws a rectangle with
      its lower left corner at point 
-     (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>).
+     (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>).
      This width is set to <parameter>widgth</parameter>.
-     This height is set to <parameter>height</parameter>.</para>
-
+     This height is set to <parameter>height</parameter>.
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
-
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page
+     is used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1592,8 +1600,8 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_closepath</function> function closes the
-     current path.</para>
-
+     current path.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1612,12 +1620,12 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_stroke</function> function draws a line along
-     current path.</para>
-
+     current path.
+    </para>
     <para>
      See also <function>cpdf_closepath</function>,
-              <function>cpdf_closepath_stroke</function>.</para>
-
+              <function>cpdf_closepath_stroke</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1637,12 +1645,12 @@ cpdf_restore($pdf)
     <para>
      The <function>cpdf_closepath_stroke</function> function is a
      combination of <function>cpdf_closepath</function> and
-     <function>cpdf_stroke</function>. Than clears the path.</para>
-
+     <function>cpdf_stroke</function>. Than clears the path.
+    </para>
     <para>
      See also <function>cpdf_closepath</function>,
-              <function>cpdf_stroke</function>.</para>
-
+              <function>cpdf_stroke</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1661,16 +1669,16 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_fill</function> function fills the interior of
-     the current path with the current fill color.</para>
-
+     the current path with the current fill color.
+    </para>
     <para>
      See also <function>cpdf_closepath</function>,
               <function>cpdf_stroke</function>,
               <function>cpdf_setgray_fill</function>,
               <function>cpdf_setgray</function>,
               <function>cpdf_setrgbcolor_fill</function>,
-              <function>cpdf_setrgbcolor</function>.</para>
-
+              <function>cpdf_setrgbcolor</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1689,8 +1697,8 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_fill_stroke</function> function fills the interior of
-     the current path with the current fill color and draws current path.</para>
-
+     the current path with the current fill color and draws current path.
+    </para>
     <para>
      See also <function>cpdf_closepath</function>,
               <function>cpdf_stroke</function>,
@@ -1698,8 +1706,8 @@ cpdf_restore($pdf)
               <function>cpdf_setgray_fill</function>,
               <function>cpdf_setgray</function>,
               <function>cpdf_setrgbcolor_fill</function>,
-              <function>cpdf_setrgbcolor</function>.</para>
-
+              <function>cpdf_setrgbcolor</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1718,9 +1726,9 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_closepath_fill_stroke</function> function closes,
-     fills the interior of
-     the current path with the current fill color and draws current path.</para>
-
+     fills the interior of the current path with the current fill color and
+     draws current path.
+    </para>
     <para>
      See also <function>cpdf_closepath</function>,
               <function>cpdf_stroke</function>,
@@ -1728,8 +1736,8 @@ cpdf_restore($pdf)
               <function>cpdf_setgray_fill</function>,
               <function>cpdf_setgray</function>,
               <function>cpdf_setrgbcolor_fill</function>,
-              <function>cpdf_setrgbcolor</function>.</para>
-
+              <function>cpdf_setrgbcolor</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1748,8 +1756,8 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_clip</function> function clips all drawing
-     to the current path.</para>
-
+     to the current path.
+    </para>
    </refsect1>
   </refentry>
   
@@ -1769,11 +1777,11 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_setgray_fill</function> function sets the current
-     gray value to fill a path.</para>
-
+     gray value to fill a path.
+    </para>
     <para>
-     See also <function>cpdf_setrgbcolor_fill</function>.</para>
-
+     See also <function>cpdf_setrgbcolor_fill</function>.
+    </para>
    </refsect1>
   </refentry>
   
@@ -1793,11 +1801,11 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_setgray_stroke</function> function sets the current
-     drawing color to the given gray value.</para>
-
+     drawing color to the given gray value.
+    </para>
     <para>
-     See also <function>cpdf_setrgbcolor_stroke</function>.</para>
-
+     See also <function>cpdf_setrgbcolor_stroke</function>.
+    </para>
    </refsect1>
   </refentry>
   
@@ -1817,12 +1825,12 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_setgray_stroke</function> function sets the current
-     drawing and filling color to the given gray value.</para>
-
+     drawing and filling color to the given gray value.
+    </para>
     <para>
      See also <function>cpdf_setrgbcolor_stroke</function>,
-              <function>cpdf_setrgbcolor_fill</function>.</para>
-
+              <function>cpdf_setrgbcolor_fill</function>.
+    </para>
    </refsect1>
   </refentry>
   
@@ -1844,12 +1852,12 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_setrgbcolor_fill</function> function sets the current
-     rgb color value to fill a path.</para>
-
+     rgb color value to fill a path.
+    </para>
     <para>
      See also <function>cpdf_setrgbcolor_stroke</function>,
-              <function>cpdf_setrgbcolor</function>.</para>
-
+              <function>cpdf_setrgbcolor</function>.
+    </para>
    </refsect1>
   </refentry>
   
@@ -1871,12 +1879,12 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_setrgbcolor_stroke</function> function sets the current
-     drawing color to the given rgb color value.</para>
-
+     drawing color to the given rgb color value.
+    </para>
     <para>
      See also <function>cpdf_setrgbcolor_fill</function>,
-              <function>cpdf_setrgbcolor</function>.</para>
-
+              <function>cpdf_setrgbcolor</function>.
+    </para>
    </refsect1>
   </refentry>
   
@@ -1898,12 +1906,12 @@ cpdf_restore($pdf)
     </funcsynopsis>
     <para>
      The <function>cpdf_setrgbcolor_stroke</function> function sets the current
-     drawing and filling color to the given rgb color value.</para>
-
+     drawing and filling color to the given rgb color value.
+    </para>
     <para>
      See also <function>cpdf_setrgbcolor_stroke</function>,
-              <function>cpdf_setrgbcolor_fill</function>.</para>
-
+              <function>cpdf_setrgbcolor_fill</function>.
+    </para>
    </refsect1>
   </refentry>
   
@@ -1924,7 +1932,6 @@ cpdf_restore($pdf)
     <para>
      The <function>cpdf_add_outline</function> function adds a bookmark
      with text <parameter>text</parameter> that points to the current page.
-
      <example>
       <title>Adding a page outline</title>
       <programlisting>
@@ -1939,10 +1946,10 @@ cpdf_finalize($cpdf);
 Header("Content-type: application/pdf");
 cpdf_output_buffer($cpdf);
 cpdf_close($cpdf);
-?>
-    </programlisting>
-    <para></para>
-  </example></para>
+?&gt;
+      </programlisting>
+     </example>
+    </para>
    </refsect1>
   </refentry>
 
@@ -1963,41 +1970,36 @@ cpdf_close($cpdf);
     </funcsynopsis>
     <para>
      The <function>cpdf_set_page_animation</function> function set the
-     transition between following pages.</para>
-
+     transition between following pages.
+    </para>
     <para>
      The value of <parameter>transition</parameter>
      can be
      <simplelist>
-      <member>
-       0 for none,
-      </member>
+      <member>0 for none,</member>
       <member>
        1 for two lines sweeping across the screen reveal the page,
       </member>
       <member>
        2 for multiple lines sweeping across the screen reveal the page,
       </member>
-      <member>
-       3 for a box reveals the page,
-      </member>
+      <member>3 for a box reveals the page,</member>
       <member>
        4 for a single line sweeping across the screen reveals the page,
       </member>
-      <member>
-       5 for the old page dissolves to reveal the page,
-      </member>
+      <member>5 for the old page dissolves to reveal the page,</member>
       <member>
        6 for the dissolve effect moves from one screen edge to another,
       </member>
       <member>
        7 for the old page is simply replaced by the new page (default)
       </member>
-     </simplelist></para>
-
+     </simplelist>
+    </para>
     <para>
      The value of <parameter>duration</parameter> is the number of seconds
-     between page flipping.</para>
+     between page flipping.
+    </para>
    </refsect1>
   </refentry>
 
@@ -2013,29 +2015,32 @@ cpdf_close($cpdf);
       <funcdef>int <function>cpdf_open_jpeg</function></funcdef>
       <paramdef>int <parameter>pdf document</parameter></paramdef>
       <paramdef>string <parameter>file name</parameter></paramdef>
-      <paramdef>double <parameter>x-koor</parameter></paramdef>
-      <paramdef>double <parameter>y-koor</parameter></paramdef>
+      <paramdef>double <parameter>x-coor</parameter></paramdef>
+      <paramdef>double <parameter>y-coor</parameter></paramdef>
       <paramdef>double <parameter>angle</parameter></paramdef>
       <paramdef>double <parameter>width</parameter></paramdef>
       <paramdef>double <parameter>height</parameter></paramdef>
       <paramdef>double <parameter>x-scale</parameter></paramdef>
       <paramdef>double <parameter>y-scale</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>cpdf_import_jpeg</function> function opens an image stored
      in the file with the name <parameter>file name</parameter>.
      The format of the image has to be jpeg. The image is placed on the current
-     page at position (<parameter>x-koor</parameter>, <parameter>y-koor</parameter>).
-     The image is rotated by <parameter>angle</parameter> degres.</para>
+     page at position (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>).
+     The image is rotated by <parameter>angle</parameter> degres.
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
-
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page
+     is used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
     <para>
-     See also <function>cpdf_place_inline_image</function>,</para>
+     See also <function>cpdf_place_inline_image</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -2051,27 +2056,29 @@ cpdf_close($cpdf);
       <funcdef>void <function>cpdf_place_inline_image</function></funcdef>
       <paramdef>int <parameter>pdf document</parameter></paramdef>
       <paramdef>int <parameter>image</parameter></paramdef>
-      <paramdef>double <parameter>x-koor</parameter></paramdef>
-      <paramdef>double <parameter>y-koor</parameter></paramdef>
+      <paramdef>double <parameter>x-coor</parameter></paramdef>
+      <paramdef>double <parameter>y-coor</parameter></paramdef>
       <paramdef>double <parameter>angle</parameter></paramdef>
       <paramdef>double <parameter>width</parameter></paramdef>
       <paramdef>double <parameter>height</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>cpdf_place_inline_image</function> function places an image
      created with the php image functions on the page at postion
-     (<parameter>x-koor</parameter>,
-     <parameter>y-koor</parameter>). The image can be scaled at the same
-     time.</para>
+     (<parameter>x-coor</parameter>, <parameter>y-coor</parameter>). The image
+     can be scaled at the same time.
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
-
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page
+     is used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
     <para>
-     See also <function>cpdf_import_jpeg</function>,</para>
+     See also <function>cpdf_import_jpeg</function>.
+    </para>
    </refsect1>
   </refentry>
 
@@ -2092,19 +2099,21 @@ cpdf_close($cpdf);
       <paramdef>double <parameter>ury</parameter></paramdef>
       <paramdef>string <parameter>title</parameter></paramdef>
       <paramdef>string <parameter>content</parameter></paramdef>
-      <paramdef>int <parameter>mode</parameter></paramdef>
+      <paramdef>int <parameter><optional>mode</optional></parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
      The <function>cpdf_add_annotation</function> adds a note with
      the lower left corner at (<parameter>llx</parameter>,
      <parameter>lly</parameter>) and the upper right corner at
-     (<parameter>urx</parameter>, <parameter>ury</parameter>).</para>
-
+     (<parameter>urx</parameter>, <parameter>ury</parameter>).
+    </para>
     <para>
-     The last optional parameter determines the unit length. If is 0 or omitted
-     the default unit as specified for the page is used. Otherwise the koodinates
-     are measured in postscript points disregarding the current unit.</para>
+     The optional parameter <parameter>mode</parameter> determines the unit
+     length. If it's 0 or omitted the default unit as specified for the page
+     is used. Otherwise the coordinates are measured in postscript points
+     disregarding the current unit.
+    </para>
    </refsect1>
   </refentry>