From 4af8e58936001a8f0ae0d2afef9c8225c0d43c14 Mon Sep 17 00:00:00 2001
From: Hartmut Holzgraefe <hholzgra@php.net>
Date: Sat, 31 Mar 2007 19:18:23 +0000
Subject: [PATCH] conversion to new format finished

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@233023 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/math/functions/abs.xml           |  14 +--
 reference/math/functions/acos.xml          |   4 +-
 reference/math/functions/asin.xml          |   4 +-
 reference/math/functions/asinh.xml         |  25 ++--
 reference/math/functions/atan.xml          |  25 ++--
 reference/math/functions/atan2.xml         |  28 ++---
 reference/math/functions/atanh.xml         |  19 ++-
 reference/math/functions/base-convert.xml  |  92 ++++++++------
 reference/math/functions/bindec.xml        |  94 ++++++++------
 reference/math/functions/ceil.xml          |  22 ++--
 reference/math/functions/cos.xml           |  65 +++++-----
 reference/math/functions/cosh.xml          |  26 ++--
 reference/math/functions/decbin.xml        |  64 +++++-----
 reference/math/functions/dechex.xml        |  64 +++++-----
 reference/math/functions/decoct.xml        |  64 +++++-----
 reference/math/functions/deg2rad.xml       |  58 ++++-----
 reference/math/functions/exp.xml           |  61 ++++-----
 reference/math/functions/expm1.xml         |  29 ++---
 reference/math/functions/floor.xml         |  62 +++++-----
 reference/math/functions/fmod.xml          |  70 +++++------
 reference/math/functions/getrandmax.xml    |  33 +----
 reference/math/functions/hexdec.xml        |  97 +++++++++------
 reference/math/functions/hypot.xml         |  30 ++---
 reference/math/functions/is-finite.xml     |  27 ++--
 reference/math/functions/is-infinite.xml   |  21 +---
 reference/math/functions/is-nan.xml        |  24 ++--
 reference/math/functions/lcg-value.xml     |  28 +----
 reference/math/functions/log.xml           |  65 ++++++----
 reference/math/functions/log10.xml         |  16 +--
 reference/math/functions/log1p.xml         |  22 ++--
 reference/math/functions/mt-getrandmax.xml |  35 +-----
 reference/math/functions/mt-rand.xml       | 112 ++++++++++-------
 reference/math/functions/mt-srand.xml      |  92 ++++++++------
 reference/math/functions/octdec.xml        |  94 ++++++++------
 reference/math/functions/pi.xml            |  46 ++-----
 reference/math/functions/pow.xml           | 137 +++++++++++++--------
 reference/math/functions/rad2deg.xml       |  58 ++++-----
 reference/math/functions/rand.xml          | 132 +++++++++++---------
 reference/math/functions/round.xml         |  63 +++++-----
 reference/math/functions/sin.xml           |  66 +++++-----
 reference/math/functions/sinh.xml          |  26 ++--
 reference/math/functions/sqrt.xml          |  58 ++++-----
 reference/math/functions/srand.xml         |  70 +++++------
 reference/math/functions/tan.xml           |  40 ++++--
 reference/math/functions/tanh.xml          |  26 ++--
 45 files changed, 1103 insertions(+), 1205 deletions(-)

diff --git a/reference/math/functions/abs.xml b/reference/math/functions/abs.xml
index ded03a598a..c940580a12 100644
--- a/reference/math/functions/abs.xml
+++ b/reference/math/functions/abs.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <refentry id="function.abs">
  <refnamediv>
   <refname>abs</refname>
@@ -12,11 +12,7 @@
     <methodparam><type>mixed</type><parameter>number</parameter></methodparam>
    </methodsynopsis>
   <para>
-   Returns the absolute value of <parameter>number</parameter>. If the
-   argument <parameter>number</parameter> is
-   of type <type>float</type>, the return type is also <type>float</type>, 
-   otherwise it is <type>integer</type> (as <type>float</type> usually has a
-   bigger value range than <type>integer</type>).
+   Returns the absolute value of <parameter>number</parameter>. 
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -37,7 +33,11 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   The absoulte value of <parameter>number</parameter>
+   The absoulte value of <parameter>number</parameter>. If the
+   argument <parameter>number</parameter> is
+   of type <type>float</type>, the return type is also <type>float</type>,
+   otherwise it is <type>integer</type> (as <type>float</type> usually has a
+   bigger value range than <type>integer</type>).
   </para>
  </refsect1>
  <refsect1 role="examples">
diff --git a/reference/math/functions/acos.xml b/reference/math/functions/acos.xml
index 93248709b1..92954e9a02 100644
--- a/reference/math/functions/acos.xml
+++ b/reference/math/functions/acos.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.acos">
  <refnamediv>
   <refname>acos</refname>
@@ -37,7 +37,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   The arc consine of <parameter>arg</parameter>
+   The arc consine of <parameter>arg</parameter> in radians.
   </para>
  </refsect1>
  <refsect1 role="seealso">
diff --git a/reference/math/functions/asin.xml b/reference/math/functions/asin.xml
index 4583282687..853093df4e 100644
--- a/reference/math/functions/asin.xml
+++ b/reference/math/functions/asin.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.asin">
  <refnamediv>
   <refname>asin</refname>
@@ -37,7 +37,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   The arc sine of <parameter>arg</parameter> 
+   The arc sine of <parameter>arg</parameter> in radians
   </para>
  </refsect1>
  <refsect1 role="seealso">
diff --git a/reference/math/functions/asinh.xml b/reference/math/functions/asinh.xml
index 309f135606..b78830a552 100644
--- a/reference/math/functions/asinh.xml
+++ b/reference/math/functions/asinh.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.asinh">
  <refnamediv>
   <refname>asinh</refname>
@@ -17,22 +17,16 @@
    hyperbolic sine is <parameter>arg</parameter>.
   </para>
   &note.no-windows;
-  <para>
-   See also:
-   <function>asin</function>,
-   <function>acosh</function>, and
-   <function>atanh</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-
+       The argument to process
       </para>
      </listitem>
     </varlistentry>
@@ -42,20 +36,17 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   The inverse hyperbolic sine of <parameter>arg</parameter> 
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>sinh</function></member>
+    <member><function>asin</function></member>
+    <member><function>acosh</function></member>
+    <member><function>atanh</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/atan.xml b/reference/math/functions/atan.xml
index 399bb980e0..88208ef13c 100644
--- a/reference/math/functions/atan.xml
+++ b/reference/math/functions/atan.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.atan">
  <refnamediv>
   <refname>atan</refname>
@@ -18,22 +18,16 @@
    <literal>a==tan(atan(a))</literal> for every value of a that is within
    <function>atan</function>'s range.
   </para>
-  <para>
-   See also:
-   <function>atanh</function>,
-   <function>asin</function>, and
-   <function>acos</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-
+       The argument to process
       </para>
      </listitem>
     </varlistentry>
@@ -43,20 +37,17 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   The arc tangent of <parameter>arg</parameter> in radians.
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>tan</function></member>
+    <member><function>atanh</function></member>
+    <member><function>asin</function></member>
+    <member><function>acos</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/atan2.xml b/reference/math/functions/atan2.xml
index 78544109ae..b4d0b187a7 100644
--- a/reference/math/functions/atan2.xml
+++ b/reference/math/functions/atan2.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.atan2">
  <refnamediv>
   <refname>atan2</refname>
@@ -24,19 +24,24 @@
    The function returns the result in radians, which is between -PI
    and PI (inclusive).
   </simpara>
-  <para>
-   See also <function>acos</function> and <function>atan</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>x</parameter></term>
      <listitem>
       <para>
-
+       Dividend parameter
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>y</parameter></term>
+     <listitem>
+      <para>
+       Divisor parameter
       </para>
      </listitem>
     </varlistentry>
@@ -46,20 +51,15 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   The arg tangent of <parameter>x</parameter>/<parameter>y</parameter> 
+   in radians.
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>atan</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/atanh.xml b/reference/math/functions/atanh.xml
index 0d06759740..683f8e21a3 100644
--- a/reference/math/functions/atanh.xml
+++ b/reference/math/functions/atanh.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.atanh">
  <refnamediv>
   <refname>atanh</refname>
@@ -29,10 +29,10 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-
+       The argument to process
       </para>
      </listitem>
     </varlistentry>
@@ -42,20 +42,17 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   Inverse hyperbolic tangent of <parameter>arg</parameter> 
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>tanh</function></member>
+    <member><function>atan </function></member>
+    <member><function>asinh</function></member>
+    <member><function>acosh</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/base-convert.xml b/reference/math/functions/base-convert.xml
index 15f9f75016..01fd1b1ac8 100644
--- a/reference/math/functions/base-convert.xml
+++ b/reference/math/functions/base-convert.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry id="function.base-convert">
  <refnamediv>
   <refname>base_convert</refname>
@@ -22,6 +22,56 @@
    have to be between 2 and 36, inclusive.  Digits in numbers with a
    base higher than 10 will be represented with the letters a-z,
    with a meaning 10, b meaning 11 and z meaning 35.
+  </para>
+  <warning>
+   <simpara>
+    <function>base_convert</function> may lose precision on large numbers
+    due to properties related to the internal "double" or "float" type used.
+    Please see the <link linkend="language.types.float">Floating point numbers</link>
+    section in the manual for more specific information and limitations.
+   </simpara>
+  </warning>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>number</parameter></term>
+     <listitem>
+      <para>
+       The number to convert
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>frombase</parameter></term>
+     <listitem>
+      <para>
+       The base <parameter>number</parameter> is in
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>tobase</parameter></term>
+     <listitem>
+      <para>
+       The base to convert <parameter>number</parameter> to
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <parameter>number</parameter> converted to base <parameter>tobase</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
    <example>
     <title><function>base_convert</function> example</title>
     <programlisting role="php">
@@ -42,50 +92,12 @@ echo base_convert($hexadecimal, 16, 2);
     </screen>
    </example>
   </para>
-  <warning>
-   <simpara>
-    <function>base_convert</function> may lose precision on large numbers
-    due to properties related to the internal "double" or "float" type used.
-    Please see the <link linkend="language.types.float">Floating point numbers</link>
-    section in the manual for more specific information and limitations.
-   </simpara>
-  </warning>
-  <para>
-   See also: <function>intval</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>intval</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/bindec.xml b/reference/math/functions/bindec.xml
index 741ed047b4..3b471e419a 100644
--- a/reference/math/functions/bindec.xml
+++ b/reference/math/functions/bindec.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <refentry id="function.bindec">
  <refnamediv>
   <refname>bindec</refname>
@@ -17,11 +17,57 @@
   </para>
   <para>
    <function>bindec</function> converts a binary number to an 
-   <type>integer</type>. The largest number that can be converted is 
-   31 bits of 1's or 2147483647 in decimal.
-   As of PHP 4.1.0, this function can also convert larger numbers. It returns
-   <type>float</type> in that case.
+   <type>integer</type> or, if needed for size reasons, <type>float</type>.
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>binary_string</parameter></term>
+     <listitem>
+      <para>
+       The binary string to convert
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The decimal value of <parameter>binary_string</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>Since 4.1.0</entry>
+       <entry>
+        The function can now convert numbers that are too large to
+        fit into the platforms <type>integer</type> type, larger values
+        are returned as <type>float</type> in that case.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>bindec</function> example</title>
@@ -45,45 +91,15 @@ echo bindec('111');
     </screen>
    </example>
   </para>
-  <para>
-   See also <function>decbin</function>,
-   <function>octdec</function>,
-   <function>hexdec</function> and
-   <function>base_convert</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>decbin</function></member>
+    <member><function>octdec</function></member>
+    <member><function>hexdec</function></member>
+    <member><function>base_convert</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/ceil.xml b/reference/math/functions/ceil.xml
index 04856ac6f8..e94db512d5 100644
--- a/reference/math/functions/ceil.xml
+++ b/reference/math/functions/ceil.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry id="function.ceil">
  <refnamediv>
   <refname>ceil</refname>
@@ -14,9 +14,6 @@
   <simpara>
    Returns the next highest integer value by rounding up 
    <parameter>value</parameter> if necessary. 
-   The return value of <function>ceil</function> is still of type
-   <type>float</type> as the value range of <type>float</type> is 
-   usually bigger than that of <type>integer</type>.
   </simpara>
   <para>
    <example>
@@ -32,20 +29,16 @@ echo ceil(-3.14);  // -3
     </programlisting>
    </example>
   </para>
-  <simpara>
-   See also <function>floor</function> and
-   <function>round</function>.
-  </simpara>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>value</parameter></term>
      <listitem>
       <para>
-
+       The value to round
       </para>
      </listitem>
     </varlistentry>
@@ -55,7 +48,11 @@ echo ceil(-3.14);  // -3
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
+   <parameter>value</parameter> rounded up to the next highest
+   integer.
+   The return value of <function>ceil</function> is still of type
+   <type>float</type> as the value range of <type>float</type> is 
+   usually bigger than that of <type>integer</type>.
   </para>
  </refsect1>
  <refsect1 role="examples">
@@ -68,7 +65,8 @@ echo ceil(-3.14);  // -3
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>floor</function></member>
+    <member><function>round</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/cos.xml b/reference/math/functions/cos.xml
index 9d37b313ea..558709e8a7 100644
--- a/reference/math/functions/cos.xml
+++ b/reference/math/functions/cos.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <refentry id="function.cos">
  <refnamediv>
   <refname>cos</refname>
@@ -15,6 +15,30 @@
    <function>cos</function> returns the cosine of the <parameter>arg</parameter>
    parameter.  The <parameter>arg</parameter> parameter is in radians.
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>arg</parameter></term>
+     <listitem>
+      <para>
+       An angle in radians 
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The cosine of <parameter>arg</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>cos</function> example</title>
@@ -29,46 +53,15 @@ echo cos(M_PI); // -1
     </programlisting>
    </example>
   </para>
-  <para>
-   See also:
-   <function>acos</function>,
-   <function>sin</function>,
-   <function>tan</function>, and
-   <function>deg2rad</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>acos</function></member>
+    <member><function>sin</function></member>
+    <member><function>tan</function></member>
+    <member><function>deg2rad</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/cosh.xml b/reference/math/functions/cosh.xml
index 1041fb3451..a31f1b57c4 100644
--- a/reference/math/functions/cosh.xml
+++ b/reference/math/functions/cosh.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.cosh">
  <refnamediv>
   <refname>cosh</refname>
@@ -15,23 +15,16 @@
    Returns the hyperbolic cosine of <parameter>arg</parameter>,
    defined as <literal>(exp(arg) + exp(-arg))/2</literal>.
   </para>
-  <para>
-   See also:
-   <function>cos</function>,
-   <function>acosh</function>,
-   <function>sin</function>, and
-   <function>tan</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-
+       The argument to process
       </para>
      </listitem>
     </varlistentry>
@@ -41,20 +34,17 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   The hyperbolic cosine of <parameter>arg</parameter>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>cos</function></member>
+    <member><function>acosh</function></member>
+    <member><function>sinh</function></member>
+    <member><function>cosh</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/decbin.xml b/reference/math/functions/decbin.xml
index ae3b0d0718..aee6623916 100644
--- a/reference/math/functions/decbin.xml
+++ b/reference/math/functions/decbin.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <refentry id="function.decbin">
  <refnamediv>
   <refname>decbin</refname>
@@ -16,6 +16,30 @@
    <parameter>number</parameter> argument.  The largest number that can be converted is
    4294967295 in decimal resulting to a string of 32 1's.
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>number</parameter></term>
+     <listitem>
+      <para>
+       Decimal value to convert 
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Binary string representation of <parameter>number</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>decbin</function> example</title>
@@ -36,45 +60,15 @@ echo decbin(26);
     </screen>
    </example>
   </para>
-  <para>
-   See also <function>bindec</function>,
-   <function>decoct</function>,
-   <function>dechex</function> and
-   <function>base_convert</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>bindec</function></member>
+    <member><function>decoct</function></member>
+    <member><function>dechex</function></member>
+    <member><function>base_convert</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/dechex.xml b/reference/math/functions/dechex.xml
index d05ef91e87..7e297a081f 100644
--- a/reference/math/functions/dechex.xml
+++ b/reference/math/functions/dechex.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry id="function.dechex">
  <refnamediv>
   <refname>dechex</refname>
@@ -16,6 +16,30 @@
    given <parameter>number</parameter> argument. The largest number that can
    be converted is 4294967295 in decimal resulting to "ffffffff".
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>number</parameter></term>
+     <listitem>
+      <para>
+       Decimal value to convert
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Hexadecimal string representation of <parameter>number</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>dechex</function> example</title>
@@ -36,45 +60,15 @@ a
     </screen>
    </example>
   </para>
-  <para>
-   See also <function>hexdec</function>,
-   <function>decbin</function>,
-   <function>decoct</function> and
-   <function>base_convert</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>hexdec</function></member>
+    <member><function>decbin</function></member>
+    <member><function>decoct</function></member>
+    <member><function>base_convert</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/decoct.xml b/reference/math/functions/decoct.xml
index 128624dbcf..341fca856c 100644
--- a/reference/math/functions/decoct.xml
+++ b/reference/math/functions/decoct.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry id="function.decoct">
  <refnamediv>
   <refname>decoct</refname>
@@ -16,6 +16,30 @@
    <parameter>number</parameter> argument.  The largest number that can be converted is
    4294967295 in decimal resulting to "37777777777". 
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter></parameter></term>
+     <listitem>
+      <para>
+       Decimal value to convert
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Octal string representation of <parameter>number</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>decoct</function> example</title>
@@ -36,45 +60,15 @@ echo decoct(264);
     </screen>
    </example>
   </para>
-  <para>
-   See also <function>octdec</function>,
-   <function>decbin</function>,
-   <function>dechex</function> and
-   <function>base_convert</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>octdec</function></member>
+    <member><function>decbin</function></member>
+    <member><function>dechex</function></member>
+    <member><function>base_convert</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/deg2rad.xml b/reference/math/functions/deg2rad.xml
index 957ab773da..41b82d1867 100644
--- a/reference/math/functions/deg2rad.xml
+++ b/reference/math/functions/deg2rad.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.deg2rad">
  <refnamediv>
   <refname>deg2rad</refname>
@@ -17,6 +17,30 @@
    This function converts <parameter>number</parameter> from degrees
    to the radian equivalent.
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>number</parameter></term>
+     <listitem>
+      <para>
+       Angular value in degrees 
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The radian equivalent of <parameter>number</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>deg2rad</function> example</title>
@@ -32,42 +56,12 @@ var_dump(deg2rad(45) === M_PI_4); // bool(true)
     </programlisting>
    </example>
   </para>
-  <para>
-   See also <function>rad2deg</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>rad2deg</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/exp.xml b/reference/math/functions/exp.xml
index 8796b03ee8..2bcd20f14f 100644
--- a/reference/math/functions/exp.xml
+++ b/reference/math/functions/exp.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
 <refentry id="function.exp">
  <refnamediv>
   <refname>exp</refname>
@@ -20,6 +20,30 @@
     2.718282.
    </para>
   </note>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>arg</parameter></term>
+     <listitem>
+      <para>
+       The argument to process
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   'e' raised to the power of <parameter>arg</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>exp</function> example</title>
@@ -40,44 +64,13 @@ echo exp(5.7);
     </screen>
    </example>
   </para>
-  <para>
-   See also 
-   <function>log</function> and
-   <function>pow</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>log</function></member>
+    <member><function>pow</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/expm1.xml b/reference/math/functions/expm1.xml
index 589a2b7a8e..d1a86e2e9d 100644
--- a/reference/math/functions/expm1.xml
+++ b/reference/math/functions/expm1.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <refentry id='function.expm1'>
  <refnamediv>
   <refname>expm1</refname>
@@ -12,31 +12,27 @@
   &reftitle.description;
   <methodsynopsis>
    <type>float</type><methodname>expm1</methodname>
-   <methodparam><type>float</type><parameter>number</parameter></methodparam>
+   <methodparam><type>float</type><parameter>arg</parameter></methodparam>
   </methodsynopsis>
   &warn.experimental.func;
   <para>
    <function>expm1</function> returns the equivalent to
-   'exp(<parameter>number</parameter>) -  1' computed in a way that is
-   accurate even if the value of <parameter>number</parameter> is near zero,
-   a case where 'exp (<parameter>number</parameter>) - 1' would be
+   'exp(<parameter>arg</parameter>) -  1' computed in a way that is
+   accurate even if the value of <parameter>arg</parameter> is near zero,
+   a case where 'exp (<parameter>arg</parameter>) - 1' would be
    inaccurate due to subtraction of two numbers that are nearly equal.
   </para>
   &note.no-windows;
-  <para>
-   See also <function>log1p</function> and
-   <function>exp</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-
+       The argument to process
       </para>
      </listitem>
     </varlistentry>
@@ -46,20 +42,15 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   'e' to the power of <parameter>arg</parameter> minus one
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>log1p</function></member>
+    <member><function>exp</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/floor.xml b/reference/math/functions/floor.xml
index 807a92c736..7e0753fcf7 100644
--- a/reference/math/functions/floor.xml
+++ b/reference/math/functions/floor.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry id="function.floor">
  <refnamediv>
   <refname>floor</refname>
@@ -14,10 +14,34 @@
   <simpara>
    Returns the next lowest integer value by rounding down
    <parameter>value</parameter> if necessary. 
+  </simpara>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>number</parameter></term>
+     <listitem>
+      <para>
+       The numeric value to round
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <parameter>arg</parameter> rounded to the next lowest integer.
    The return value of <function>floor</function> is still of type
    <type>float</type> because the value range of <type>float</type> is 
    usually bigger than that of <type>integer</type>.
-  </simpara>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>floor</function> example</title>
@@ -32,43 +56,13 @@ echo floor(-3.14); // -4
     </programlisting>
    </example>
   </para>
-  <simpara>
-   See also <function>ceil</function> and
-   <function>round</function>.
-  </simpara>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>ceil</function></member>
+    <member><function>round</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/fmod.xml b/reference/math/functions/fmod.xml
index c394b19468..dbacd80c9a 100644
--- a/reference/math/functions/fmod.xml
+++ b/reference/math/functions/fmod.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <refentry id="function.fmod">
  <refnamediv>
   <refname>fmod</refname>
@@ -22,6 +22,39 @@
    <parameter>x</parameter> and a magnitude less than the magnitude of
    <parameter>y</parameter>.
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>x</parameter></term>
+     <listitem>
+      <para>
+       The dividend
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>y</parameter></term>
+     <listitem>
+      <para>
+       The divisor
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The floating point remainder of 
+   <parameter>x</parameter>/<parameter>y</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title>Using <function>fmod</function></title>
@@ -38,41 +71,6 @@ $r = fmod($x, $y);
    </example>
   </para>
  </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="seealso">
-  &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function> </function></member>
-   </simplelist>
-  </para>
- </refsect1>
 </refentry>
 
 <!-- Keep this comment at the end of the file
diff --git a/reference/math/functions/getrandmax.xml b/reference/math/functions/getrandmax.xml
index 69f81062ef..7b7909200f 100644
--- a/reference/math/functions/getrandmax.xml
+++ b/reference/math/functions/getrandmax.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.getrandmax">
  <refnamediv>
   <refname>getrandmax</refname>
@@ -15,43 +15,20 @@
    Returns the maximum value that can be returned by a call to
    <function>rand</function>.
   </simpara>
-  <simpara>
-   See also <function>rand</function>, <function>srand</function>
-   and <function>mt_getrandmax</function>.
-  </simpara>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   The largest possible random value returned by <function>rand</function>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>rand</function></member>
+    <member><function>srand</function></member>
+    <member><function>mt_getrandmax</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/hexdec.xml b/reference/math/functions/hexdec.xml
index 03bfed6c27..8ba6c8ca19 100644
--- a/reference/math/functions/hexdec.xml
+++ b/reference/math/functions/hexdec.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
 <refentry id="function.hexdec">
  <refnamediv>
   <refname>hexdec</refname>
@@ -15,14 +15,62 @@
    Returns the decimal equivalent of the hexadecimal number
    represented by the <parameter>hex_string</parameter> argument.
    <function>hexdec</function> converts a hexadecimal string to a
-   decimal number. The largest number that can be converted is
-   7fffffff or 2147483647 in decimal.
-   As of PHP 4.1.0, this function can also convert larger numbers. It returns
-   <type>float</type> in that case.
+   decimal number. 
   </para>
   <para>
    <function>hexdec</function> will ignore any non-hexadecimal 
    characters it encounters.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>hex_string</parameter></term>
+     <listitem>
+      <para>
+       The hexadezimal string to convert
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The decimal representation of <parameter>hex_string</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>Since 4.1.0</entry>
+       <entry>
+        The function can now convert values that are to big for
+        the platforms <type>integer</type> type, it will return
+        the value as <type>float</type> instead in that case.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
    <example>
     <title><function>hexdec</function> example</title>
     <programlisting role="php">
@@ -39,50 +87,19 @@ var_dump(hexdec("a0")); // print "int(160)"
     </programlisting>
    </example>
   </para>
-  <para>
-   See also <function>dechex</function>,
-   <function>bindec</function>,
-   <function>octdec</function> and
-   <function>base_convert</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>dechex</function></member>
+    <member><function>bindec</function></member>
+    <member><function>octdec</function></member>
+    <member><function>base_convert</function></member>
    </simplelist>
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/math/functions/hypot.xml b/reference/math/functions/hypot.xml
index 4400dc82ad..a3c6cd7edb 100644
--- a/reference/math/functions/hypot.xml
+++ b/reference/math/functions/hypot.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <refentry id='function.hypot'>
  <refnamediv>
   <refname>hypot</refname>
@@ -27,10 +27,18 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>x</parameter></term>
      <listitem>
       <para>
-
+       Length of first side
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>y</parameter></term>
+     <listitem>
+      <para>
+       Length of second side
       </para>
      </listitem>
     </varlistentry>
@@ -40,21 +48,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="seealso">
-  &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function> </function></member>
-   </simplelist>
+   Calculated length of the hyptenuse
   </para>
  </refsect1>
 </refentry>
diff --git a/reference/math/functions/is-finite.xml b/reference/math/functions/is-finite.xml
index 639e26b911..014b632cec 100644
--- a/reference/math/functions/is-finite.xml
+++ b/reference/math/functions/is-finite.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id='function.is-finite'>
  <refnamediv>
   <refname>is_finite</refname>
@@ -12,12 +12,8 @@
     <methodparam><type>float</type><parameter>val</parameter></methodparam>
    </methodsynopsis>
   <para>
-   Returns &true; if <parameter>val</parameter> is a legal finite 
-   number within the allowed range for a PHP float on this platform.
-  </para>
-  <para>
-   See also <function>is_infinite</function> and
-   <function>is_nan</function>.
+   Checks whether <parameter>val</parameter> is a lecal finite
+   on this platform.
   </para>
  </refsect1>
  <refsect1 role="parameters">
@@ -25,10 +21,10 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>val</parameter></term>
      <listitem>
       <para>
-
+       The value to check
       </para>
      </listitem>
     </varlistentry>
@@ -38,20 +34,17 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   &true; if <parameter>val</parameter> is a legal finite
+   number within the allowed range for a PHP float on this platform,
+   else &false;.
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>is_infinite</function></member>
+    <member><function>is_nan</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/is-infinite.xml b/reference/math/functions/is-infinite.xml
index 8f11442e6f..5a0293db10 100644
--- a/reference/math/functions/is-infinite.xml
+++ b/reference/math/functions/is-infinite.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id='function.is-infinite'>
  <refnamediv>
   <refname>is_infinite</refname>
@@ -16,20 +16,16 @@
    negative), like the result of <literal>log(0)</literal> or any value too 
    big to fit into a float on this platform.
   </para>
-  <para>
-   See also <function>is_finite</function> and
-   <function>is_nan</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>val</parameter></term>
      <listitem>
       <para>
-
+       The value to check
       </para>
      </listitem>
     </varlistentry>
@@ -39,20 +35,15 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   &true; if <parameter>val</parameter> is infinite, else &false;.
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>is_finite</function></member>
+    <member><function>is_nan</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/is-nan.xml b/reference/math/functions/is-nan.xml
index 1cefd370bd..f434c5fff9 100644
--- a/reference/math/functions/is-nan.xml
+++ b/reference/math/functions/is-nan.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id='function.is-nan'>
  <refnamediv>
   <refname>is_nan</refname>
@@ -12,23 +12,19 @@
     <methodparam><type>float</type><parameter>val</parameter></methodparam>
    </methodsynopsis>
   <para>
-   Returns &true; if <parameter>val</parameter> is 'not a number', 
+   Checks whether <parameter>val</parameter> is 'not a number', 
    like the result of <literal>acos(1.01)</literal>.
   </para>
-  <para>
-   See also <function>is_finite</function> and
-   <function>is_infinite</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>val</parameter></term>
      <listitem>
       <para>
-
+       The value to check
       </para>
      </listitem>
     </varlistentry>
@@ -38,20 +34,16 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   Returns &true; if <parameter>val</parameter> is 'not a number',
+   else &false;.
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>is_finite</function></member>
+    <member><function>is_infinite</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/lcg-value.xml b/reference/math/functions/lcg-value.xml
index 14b4ba83c1..b671bdd9de 100644
--- a/reference/math/functions/lcg-value.xml
+++ b/reference/math/functions/lcg-value.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <refentry id="function.lcg-value">
  <refnamediv>
   <refname>lcg_value</refname>
@@ -18,38 +18,18 @@
    to the product of both primes.
   </para>
  </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   A pseudo random float value in the range of (0, 1)
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>rand</function></member>
+    <member><function>mt_rand</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/log.xml b/reference/math/functions/log.xml
index a5378327b4..1daceef58a 100644
--- a/reference/math/functions/log.xml
+++ b/reference/math/functions/log.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
 <refentry id="function.log">
  <refnamediv>
   <refname>log</refname>
@@ -18,31 +18,25 @@
    <parameter>arg</parameter>, otherwise <function>log</function> 
    returns the natural logarithm of <parameter>arg</parameter>.
   </para>
-  <note>
-   <para>
-    The <parameter>base</parameter> parameter became available
-    with PHP 4.3.0.
-   </para>
-   <para>
-    As always you can calculate the logarithm in base <literal>b</literal>
-    of a number <literal>n</literal>, but using the mathematical identity:
-    log<subscript>b</subscript>(n) = log(n)/log(b), where log is the
-    neperian (or natural) logarithm.
-   </para>
-  </note>
-  <para>
-   See also <function>exp</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-
+       The value to calculate the logarithm for
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>base</parameter></term>
+     <listitem>
+      <para>
+       The optinal logarithmic base to use 
+       (defaults to 'e' and so to the natural logarithm).
       </para>
      </listitem>
     </varlistentry>
@@ -52,20 +46,45 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
+   The logarithm of <parameter>arg</parameter> to 
+   <parameter>base</parameter>, if given, or the
+   natural logarithm.  
   </para>
  </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
+<refsect1 role="changelog">
+  &reftitle.changelog;
   <para>
-
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>Since 4.3.0</entry>
+       <entry>
+        The optinal parameter <parameter>base</parameter> became available.
+        For older versions you can calculate the logarithm in base <literal>b</literal>
+        of a number <literal>n</literal>, but using the mathematical identity:
+        log<subscript>b</subscript>(n) = log(n)/log(b), where log is the
+        neperian (or natural) logarithm.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>log10</function></member>
+    <member><function>exp</function></member>
+    <member><function>pow</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/log10.xml b/reference/math/functions/log10.xml
index f6efcdf6c0..f48a3ac95d 100644
--- a/reference/math/functions/log10.xml
+++ b/reference/math/functions/log10.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.log10">
  <refnamediv>
   <refname>log10</refname>
@@ -24,10 +24,10 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-
+       The argument to process
       </para>
      </listitem>
     </varlistentry>
@@ -37,20 +37,14 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   The base-10 logaritm of <parameter>arg</parameter>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>log</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/log1p.xml b/reference/math/functions/log1p.xml
index 17557d0576..e90d018c1a 100644
--- a/reference/math/functions/log1p.xml
+++ b/reference/math/functions/log1p.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry id='function.log1p'>
  <refnamediv>
   <refname>log1p</refname>
@@ -21,20 +21,16 @@
    when the value of <parameter>number</parameter> is close to zero.
   </para>
   &note.no-windows;
-  <para>
-   See also <function>expm1</function> and
-   <function>log</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>number</parameter></term>
      <listitem>
       <para>
-
+       The argument to process
       </para>
      </listitem>
     </varlistentry>
@@ -44,20 +40,16 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   log(1 + <parameter>number</parameter>)
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>expm1</function></member>
+    <member><function>log</function></member>
+    <member><function>log10</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/mt-getrandmax.xml b/reference/math/functions/mt-getrandmax.xml
index 64da484ea2..e842cc4c9d 100644
--- a/reference/math/functions/mt-getrandmax.xml
+++ b/reference/math/functions/mt-getrandmax.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.mt-getrandmax">
  <refnamediv>
   <refname>mt_getrandmax</refname>
@@ -15,45 +15,20 @@
    Returns the maximum value that can be returned by a call to
    <function>mt_rand</function>.
   </simpara>
-  <simpara>
-   See also:
-   <function>mt_rand</function>,
-   <function>mt_srand</function>, and
-   <function>getrandmax</function>.
-  </simpara>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   Returns the maximum random value returned by <function>mt_rand</function>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>mt_rand</function></member>
+    <member><function>mt_srand</function></member>
+    <member><function>getrandmax</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/mt-rand.xml b/reference/math/functions/mt-rand.xml
index 9589d8dd46..0bf03e7270 100644
--- a/reference/math/functions/mt-rand.xml
+++ b/reference/math/functions/mt-rand.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.12 $ -->
+<!-- $Revision: 1.13 $ -->
 <refentry id="function.mt-rand">
  <refnamediv>
   <refname>mt_rand</refname>
@@ -30,6 +30,68 @@
    between 5 and 15 (inclusive), for example, use <literal>mt_rand
    (5, 15)</literal>.
   </simpara>
+  &note.randomseed;
+
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>min</parameter></term>
+     <listitem>
+      <para>
+       Optional lowest value to be returned (default: 0)
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>man</parameter></term>
+     <listitem>
+      <para>
+       Optional highest value to be returned (default: RAND_MAX)
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   A random integer value between <parameter>min</parameter> (or 0)
+   and <parameter>max</parameter> (or RAND_MAX, inclusive)
+  </para>
+ </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>Since 3.0.7</entry>
+       <entry>
+        In versions before 3.0.7 the meaning of
+        <parameter>max</parameter> was <parameter>range</parameter>. To
+        get the same results in these versions the short example should
+        be <literal>rand (5, 11)</literal> to get a random number
+        between 5 and 15.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>mt_rand</function> example</title>
@@ -53,56 +115,14 @@ echo mt_rand(5, 15);
     </screen>
    </example>
   </para>
-  &note.randomseed;
-
-  <note>
-   <para>
-    In versions before 3.0.7 the meaning of
-    <parameter>max</parameter> was <parameter>range</parameter>. To
-    get the same results in these versions the short example should
-    be <literal>mt_rand (5, 11)</literal> to get a random number
-    between 5 and 15.
-   </para>
-  </note>
-  <simpara>
-   See also:
-   <function>mt_srand</function>,
-   <function>mt_getrandmax</function>, and
-   <function>rand</function>.
-  </simpara>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>mt_srand</function></member>
+    <member><function>mt_getrandmax</function></member>
+    <member><function>rand</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/mt-srand.xml b/reference/math/functions/mt-srand.xml
index cd8bfee77a..81dbdf0008 100644
--- a/reference/math/functions/mt-srand.xml
+++ b/reference/math/functions/mt-srand.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <refentry id="function.mt-srand">
  <refnamediv>
   <refname>mt_srand</refname>
@@ -13,10 +13,54 @@
    </methodsynopsis>
   <para>
    Seeds the random number generator with
-   <parameter>seed</parameter>.
-   Since PHP 4.2.0, the <parameter>seed</parameter>
-   becomes optional and defaults to a random value if omitted.
+   <parameter>seed</parameter> or with a random value
+   if no <parameter>seed</parameter> is given.
   </para>
+
+  &note.randomseed;
+
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>seed</parameter></term>
+     <listitem>
+      <para>
+       An optional seed value
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>Since 4.2.0</entry>
+       <entry>
+        The <parameter>seed</parameter> becomes optional 
+        and defaults to a random value if omitted.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>mt_srand</function> example</title>
@@ -36,48 +80,14 @@ $randval = mt_rand();
     </programlisting>
    </example>
   </para>
-
-  &note.randomseed;
-
-  <simpara>
-   See also:
-   <function>mt_rand</function>,
-   <function>mt_getrandmax</function>, and
-   <function>srand</function>.
-  </simpara>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>mt_rand</function></member>
+    <member><function>mt_getrandmax</function></member>
+    <member><function>srand</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/octdec.xml b/reference/math/functions/octdec.xml
index 978a2127a7..ab2e754ca8 100644
--- a/reference/math/functions/octdec.xml
+++ b/reference/math/functions/octdec.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <refentry id="function.octdec">
  <refnamediv>
   <refname>octdec</refname>
@@ -14,11 +14,56 @@
   <para>
    Returns the decimal equivalent of the octal number
    represented by the <parameter>octal_string</parameter> argument.
-   The largest number that can be converted is 17777777777 or 2147483647 in
-   decimal.
-   As of PHP 4.1.0, this function can also convert larger numbers. It returns
-   <type>float</type> in that case.
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>octal_string</parameter></term>
+     <listitem>
+      <para>
+       The octal string to convert
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The decimal representation of <parameter>octal_string</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>Since 4.1.0</entry>
+       <entry>
+        The function can now convert numbers that are too large to
+        fit into the platforms <type>integer</type> type, larger values
+        are returned as <type>float</type> in that case.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>octdec</function> example</title>
@@ -39,46 +84,15 @@ echo octdec(decoct(45));
     </screen>
    </example>
   </para>
-  <para>
-   See also:
-   <function>decoct</function>,
-   <function>bindec</function>,
-   <function>hexdec</function>, and
-   <function>base_convert</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>decoct</function></member>
+    <member><function>bindec</function></member>
+    <member><function>hexdec</function></member>
+    <member><function>base_convert</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/pi.xml b/reference/math/functions/pi.xml
index cf22615e9a..2928648eda 100644
--- a/reference/math/functions/pi.xml
+++ b/reference/math/functions/pi.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <refentry id="function.pi">
  <refnamediv>
   <refname>pi</refname>
@@ -19,6 +19,15 @@
    Also, you can use the <constant>M_PI</constant> constant which yields
    identical results to <function>pi</function>.
   </simpara>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The value of pi as float.
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>pi</function> example</title>
@@ -33,41 +42,6 @@ echo M_PI; // 3.1415926535898
    </example>
   </para>
  </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="seealso">
-  &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function> </function></member>
-   </simplelist>
-  </para>
- </refsect1>
 </refentry>
 
 <!-- Keep this comment at the end of the file
diff --git a/reference/math/functions/pow.xml b/reference/math/functions/pow.xml
index eaeb8166ee..174b112f2d 100644
--- a/reference/math/functions/pow.xml
+++ b/reference/math/functions/pow.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <refentry id="function.pow">
  <refnamediv>
   <refname>pow</refname>
@@ -14,22 +14,89 @@
    </methodsynopsis>
   <para>
    Returns <parameter>base</parameter> raised to the power of
-   <parameter>exp</parameter>. If possible, this function will
-   return an <type>integer</type>.
-  </para>
-  <para>
-   If the power cannot be computed, a warning will be issued,
-   and <function>pow</function> will return &false;. Since PHP 4.2.0
-   <function>pow</function> doesn't issue any warning.
+   <parameter>exp</parameter>. 
   </para>
   <note>
    <para>
     PHP cannot handle negative <parameter>exp</parameter>s.
    </para>
   </note>
-  <example>
-   <title>Some examples of <function>pow</function></title>
-   <programlisting role="php">
+  <warning>
+   <para>
+    In PHP 4.0.6 and earlier <function>pow</function> always returned
+    a <type>float</type>, and did not issue warnings.
+   </para>
+  </warning>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>base</parameter></term>
+     <listitem>
+      <para>
+       The base to use
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>exp</parameter></term>
+     <listitem>
+      <para>
+       The exponent
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <parameter>base</parameter> raised to the power of <parameter>exp</parameter>.
+   If the result can be represented as integer it will be returned as type
+   <type>integer</type>, else it will be returned as type <type>float</type>.
+   If the power cannot be computed &false; will be returned instead.
+  </para>
+ </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>Since 4.0.6</entry>
+       <entry>
+        The function will now return <type>integer</type> results if possible,
+        before this it always returned a <type>float</type> result.
+       </entry>
+      </row>
+      <row>
+       <entry>Since 4.2.0</entry>
+       <entry>
+        PHP stops to emit a warning if the value can't be computed,
+        it will now silently return &false; only.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Some examples of <function>pow</function></title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 
@@ -41,54 +108,18 @@ echo pow(-1, 5.5); // error
 
 ?>
 ]]>
-   </programlisting>
-  </example>
-  <warning>
-   <para>
-    In PHP 4.0.6 and earlier <function>pow</function> always returned
-    a <type>float</type>, and did not issue warnings.
-   </para>
-  </warning>
-  <para>
-   See also:
-   <function>exp</function>,
-   <function>sqrt</function>,
-   <function>bcpow</function>, and
-   <function>gmp_pow</function>,
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+    </programlisting>
+   </example>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>exp</function></member>
+    <member><function>sqrt</function></member>
+    <member><function>bcpow</function></member>
+    <member><function>gmp_pow</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/rad2deg.xml b/reference/math/functions/rad2deg.xml
index a8a07bafcb..e8fbd2523d 100644
--- a/reference/math/functions/rad2deg.xml
+++ b/reference/math/functions/rad2deg.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.rad2deg">
  <refnamediv>
   <refname>rad2deg</refname>
@@ -17,6 +17,30 @@
    This function converts <parameter>number</parameter> from radian
    to degrees.
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>number</parameter></term>
+     <listitem>
+      <para>
+       A radian value
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The equivalent of <parameter>number</parameter> in degrees
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>rad2deg</function> example</title>
@@ -31,42 +55,12 @@ echo rad2deg(M_PI_4); // 45
     </programlisting>
    </example>
   </para>
-  <para>
-   See also <function>deg2rad</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>deg2rad</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/rand.xml b/reference/math/functions/rand.xml
index 579a2e2eb1..d250692a86 100644
--- a/reference/math/functions/rand.xml
+++ b/reference/math/functions/rand.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.17 $ -->
+<!-- $Revision: 1.18 $ -->
 <refentry id="function.rand">
  <refnamediv>
   <refname>rand</refname>
@@ -20,6 +20,78 @@
    between 5 and 15 (inclusive), for example, use <literal>rand (5,
    15)</literal>.
   </simpara>
+  <note>
+   <simpara>
+    On some platforms (such as Windows) <constant>RAND_MAX</constant>
+    is only 32768.  If you require a range larger than 32768, specifying
+    <parameter>min</parameter> and <parameter>max</parameter> will allow
+    you to create a range larger than RAND_MAX, or consider using
+    <function>mt_rand</function> instead.
+   </simpara>
+  </note>
+
+  &note.randomseed;
+
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>min</parameter></term>
+     <listitem>
+      <para>
+       The lowest value to return (default: 0)
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>max</parameter></term>
+     <listitem>
+      <para>
+       The highest value to return (default: RAND_MAX)
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   A pseudo random value between <parameter>min</parameter>
+   (or 0) and <parameter>max</parameter> (or RAND_MAX, inclusive).
+  </para>
+ </refsect1>
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>Since 3.0.7</entry>
+       <entry>
+        In versions before 3.0.7 the meaning of
+        <parameter>max</parameter> was <parameter>range</parameter>. To
+        get the same results in these versions the short example should
+        be <literal>rand (5, 11)</literal> to get a random number
+        between 5 and 15.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>rand</function> example</title>
@@ -43,66 +115,14 @@ echo rand(5, 15);
     </screen>
    </example>
   </para>
-  <note>
-   <simpara>
-    On some platforms (such as Windows) <constant>RAND_MAX</constant>
-    is only 32768.  If you require a range larger than 32768, specifying
-    <parameter>min</parameter> and <parameter>max</parameter> will allow
-    you to create a range larger than RAND_MAX, or consider using
-    <function>mt_rand</function> instead.
-   </simpara>
-  </note>
-
-  &note.randomseed;
-
-  <note>
-   <para>
-    In versions before 3.0.7 the meaning of
-    <parameter>max</parameter> was <parameter>range</parameter>. To
-    get the same results in these versions the short example should
-    be <literal>rand (5, 11)</literal> to get a random number
-    between 5 and 15.
-   </para>
-  </note>
-  <simpara>
-   See also:
-   <function>srand</function>,
-   <function>getrandmax</function>, and
-   <function>mt_rand</function>.
-  </simpara>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>srand</function></member>
+    <member><function>getrandmax</function></member>
+    <member><function>mt_rand</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/round.xml b/reference/math/functions/round.xml
index ae401e8d4f..1c471d15a8 100644
--- a/reference/math/functions/round.xml
+++ b/reference/math/functions/round.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
 <refentry id="function.round">
  <refnamediv>
   <refname>round</refname>
@@ -18,25 +18,6 @@
    (number of digits after the decimal point).
    <parameter>precision</parameter> can also be negative or zero (default).
   </para>
-  <para>
-   <example>
-    <title><function>round</function> examples</title>
-    <programlisting role="php">
-<![CDATA[
-<?php
-echo round(3.4);         // 3
-echo round(3.5);         // 4
-echo round(3.6);         // 4
-echo round(3.6, 0);      // 4
-echo round(1.95583, 2);  // 1.96
-echo round(1241757, -3); // 1242000
-echo round(5.045, 2);    // 5.05
-echo round(5.055, 2);    // 5.06
-?>
-]]>
-    </programlisting>
-   </example>
-  </para>
   <!-- It's not true
   <para>
    <caution>
@@ -70,22 +51,24 @@ echo round(5.055, 2);    // 5.06
     </simpara>
    </note>
   </para>
-  <simpara>
-   See also:
-   <function>ceil</function>,
-   <function>floor</function>, and
-   <function>number_format</function>.
-  </simpara>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>val</parameter></term>
      <listitem>
       <para>
-
+       The value to round
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>precision</parameter></term>
+     <listitem>
+      <para>
+       The optional number of decimal digits to round to, defaults to 0
       </para>
      </listitem>
     </varlistentry>
@@ -95,20 +78,38 @@ echo round(5.055, 2);    // 5.06
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
+   The rounded value
   </para>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
-
+   <example>
+    <title><function>round</function> examples</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+echo round(3.4);         // 3
+echo round(3.5);         // 4
+echo round(3.6);         // 4
+echo round(3.6, 0);      // 4
+echo round(1.95583, 2);  // 1.96
+echo round(1241757, -3); // 1242000
+echo round(5.045, 2);    // 5.05
+echo round(5.055, 2);    // 5.06
+?>
+]]>
+    </programlisting>
+   </example>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>ceil</function></member>
+    <member><function>floor</function></member>
+    <member><function>number_format</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/sin.xml b/reference/math/functions/sin.xml
index 2d5ba6c59b..b4ec2a7577 100644
--- a/reference/math/functions/sin.xml
+++ b/reference/math/functions/sin.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <refentry id="function.sin">
  <refnamediv>
   <refname>sin</refname>
@@ -15,6 +15,30 @@
    <function>sin</function> returns the sine of the <parameter>arg</parameter>
    parameter.  The <parameter>arg</parameter> parameter is in radians.
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>arg</parameter></term>
+     <listitem>
+      <para>
+       A value in radians
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The sine of <parameter>arg</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>sin</function> example</title>
@@ -31,46 +55,16 @@ echo sin(60);           // -0.304810621 ...
     </programlisting>
    </example>
   </para>
-  <para>
-   See also:
-   <function>asin</function>,
-   <function>cos</function>,
-   <function>tan</function>, and
-   <function>deg2rad</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>asin</function></member>
+    <member><function>sinh</function></member>
+    <member><function>cos</function></member>
+    <member><function>tan</function></member>
+    <member><function>deg2rad</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/sinh.xml b/reference/math/functions/sinh.xml
index 909ef3922b..56177c5ce6 100644
--- a/reference/math/functions/sinh.xml
+++ b/reference/math/functions/sinh.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.sinh">
  <refnamediv>
   <refname>sinh</refname>
@@ -15,23 +15,16 @@
    Returns the hyperbolic sine of <parameter>arg</parameter>,
    defined as <literal>(exp(arg) - exp(-arg))/2</literal>.
   </para>
-  <para>
-   See also:
-   <function>sin</function>,
-   <function>asinh</function>,
-   <function>cos</function>, and
-   <function>tan</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-
+       The argument to process
       </para>
      </listitem>
     </varlistentry>
@@ -41,20 +34,17 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   The hyperbolic sine of <parameter>arg</parameter>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>sin</function></member>
+    <member><function>asinh</function></member>
+    <member><function>cosh</function></member>
+    <member><function>tanh</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/sqrt.xml b/reference/math/functions/sqrt.xml
index e366950e2d..e7d2979997 100644
--- a/reference/math/functions/sqrt.xml
+++ b/reference/math/functions/sqrt.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <refentry id="function.sqrt">
  <refnamediv>
   <refname>sqrt</refname>
@@ -14,6 +14,30 @@
   <para>
    Returns the square root of <parameter>arg</parameter>.
   </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>arg</parameter></term>
+     <listitem>
+      <para>
+       The argument to process
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The square root of <parameter>arg</parameter>
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title><function>sqrt</function> example</title>
@@ -28,42 +52,12 @@ echo sqrt(10); // 3.16227766 ...
     </programlisting>
    </example>
   </para>
-  <para>
-   See also <function>pow</function>.
-  </para>
- </refsect1>
- <refsect1 role="parameters">
-  &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter> </parameter></term>
-     <listitem>
-      <para>
-
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
- </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
-  <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
-  </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>pow</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/srand.xml b/reference/math/functions/srand.xml
index 55de7bbb7f..68f322ed93 100644
--- a/reference/math/functions/srand.xml
+++ b/reference/math/functions/srand.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <refentry id="function.srand">
  <refnamediv>
   <refname>srand</refname>
@@ -12,71 +12,59 @@
     <methodparam choice="opt"><type>int</type><parameter>seed</parameter></methodparam>
    </methodsynopsis>
   <para>
-   Seeds the random number generator with <parameter>seed</parameter>.
-   Since PHP 4.2.0, the <parameter>seed</parameter>
-   becomes optional and defaults to a random value if omitted.
-  </para>
-  <para>
-   <example>
-    <title><function>srand</function> example</title>
-    <programlisting role="php">
-<![CDATA[
-<?php
-// seed with microseconds
-function make_seed()
-{
-  list($usec, $sec) = explode(' ', microtime());
-  return (float) $sec + ((float) $usec * 100000);
-}
-srand(make_seed());
-$randval = rand();
-?>
-]]>
-    </programlisting>
-   </example>
+   Seeds the random number generator with <parameter>seed</parameter>
+   or with a random value if no <parameter>seed</parameter> is given.
   </para>
 
   &note.randomseed;
 
-  <simpara>
-   See also:
-   <function>rand</function>,
-   <function>getrandmax</function>, and
-   <function>mt_srand</function>.
-  </simpara>    
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>seed</parameter></term>
      <listitem>
       <para>
-
+       Optional seed value
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
- <refsect1 role="returnvalues">
-  &reftitle.returnvalues;
+ <refsect1 role="changelog">
+  &reftitle.changelog;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>Since 4.2.0</entry>
+       <entry>
+        The <parameter>seed</parameter> becomes optional
+        and defaults to a random value if omitted.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>rand</function></member>
+    <member><function>getrandmax</function></member>
+    <member><function>mt_srand</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/tan.xml b/reference/math/functions/tan.xml
index d0e22de7ec..bc483aed9c 100644
--- a/reference/math/functions/tan.xml
+++ b/reference/math/functions/tan.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
 <refentry id="function.tan">
  <refnamediv>
   <refname>tan</refname>
@@ -29,23 +29,16 @@ echo tan(M_PI_4); // 1
     </programlisting>
    </example>
   </para>
-  <para>
-   See also:
-   <function>atan</function>,
-   <function>sin</function>,
-   <function>cos</function>, and
-   <function>deg2rad</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-
+       The argument to process in radians 
       </para>
      </listitem>
     </varlistentry>
@@ -55,20 +48,41 @@ echo tan(M_PI_4); // 1
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
+   The tangent of <parameter>arg</parameter>
   </para>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
-
+   <example>
+    <title><function>srand</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// seed with microseconds
+function make_seed()
+{
+  list($usec, $sec) = explode(' ', microtime());
+  return (float) $sec + ((float) $usec * 100000);
+}
+srand(make_seed());
+$randval = rand();
+?>
+]]>
+    </programlisting>
+   </example>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>atan</function></member>
+    <member><function>atan2</function></member>
+    <member><function>sin</function></member>
+    <member><function>cos</function></member>
+    <member><function>tanh</function></member>
+    <member><function>deg2rad</function></member>
    </simplelist>
   </para>
  </refsect1>
diff --git a/reference/math/functions/tanh.xml b/reference/math/functions/tanh.xml
index 46b48e440e..33f88c419d 100644
--- a/reference/math/functions/tanh.xml
+++ b/reference/math/functions/tanh.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <refentry id="function.tanh">
  <refnamediv>
   <refname>tanh</refname>
@@ -15,23 +15,16 @@
    Returns the hyperbolic tangent of <parameter>arg</parameter>,
    defined as <literal>sinh(arg)/cosh(arg)</literal>.
   </para>
-  <para>
-   See also:
-   <function>tan</function>,
-   <function>atanh</function>,
-   <function>sin</function>, and
-   <function>cos</function>.
-  </para>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter> </parameter></term>
+     <term><parameter>arg</parameter></term>
      <listitem>
       <para>
-
+       The argument to process
       </para>
      </listitem>
     </varlistentry>
@@ -41,20 +34,17 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-
-  </para>
- </refsect1>
- <refsect1 role="examples">
-  &reftitle.examples;
-  <para>
-
+   The hyperbolic tangent of <parameter>arg</parameter>
   </para>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function> </function></member>
+    <member><function>tan</function></member>
+    <member><function>atanh</function></member>
+    <member><function>sinh</function></member>
+    <member><function>cosh</function></member>
    </simplelist>
   </para>
  </refsect1>