[PHP-DOC] cvs: phpdoc /en/functions math.xml From: Egon Schmid (eschmid <email protected>)
Date: 07/23/00

eschmid Sun Jul 23 12:07:54 2000 EDT

  Modified files:
    /phpdoc/en/functions math.xml
  Log:
  Some enhancements.
  
Index: phpdoc/en/functions/math.xml
diff -u phpdoc/en/functions/math.xml:1.7 phpdoc/en/functions/math.xml:1.8
--- phpdoc/en/functions/math.xml:1.7 Tue Jun 27 10:00:29 2000
+++ phpdoc/en/functions/math.xml Sun Jul 23 12:07:54 2000
@@ -103,8 +103,8 @@
 
   <refentry id="function.abs">
    <refnamediv>
- <refname>Abs</refname>
- <refpurpose>absolute value</refpurpose>
+ <refname>abs</refname>
+ <refpurpose>Absolute value</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -116,16 +116,15 @@
     </funcsynopsis>
     <para>
      Returns the absolute value of number. If the argument number is
- float, return type is also float, otherwise it is int.</para>
-
+ float, return type is also float, otherwise it is int.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.acos">
    <refnamediv>
- <refname>Acos</refname>
- <refpurpose>arc cosine</refpurpose>
+ <refname>acos</refname>
+ <refpurpose>Arc cosine</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -136,19 +135,18 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Returns the arc cosine of arg in radians.</para>
-
+ Returns the arc cosine of arg in radians.
+ </para>
     <para>
- See also <function>asin</function> and <function>atan</function>.</para>
-
+ See also <function>asin</function> and <function>atan</function>.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.asin">
    <refnamediv>
- <refname>Asin</refname>
- <refpurpose>arc sine</refpurpose>
+ <refname>asin</refname>
+ <refpurpose>Arc sine</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -159,19 +157,18 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Returns the arc sine of arg in radians.</para>
-
+ Returns the arc sine of arg in radians.
+ </para>
     <para>
- See also <function>acos</function> and <function>atan</function>.</para>
-
+ See also <function>acos</function> and <function>atan</function>.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.atan">
    <refnamediv>
- <refname>Atan</refname>
- <refpurpose>arc tangent</refpurpose>
+ <refname>atan</refname>
+ <refpurpose>Arc tangent</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -182,18 +179,17 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Returns the arc tangent of arg in radians.</para>
-
+ Returns the arc tangent of arg in radians.
+ </para>
     <para>
- See also <function>asin</function> and <function>acos</function>.</para>
-
+ See also <function>asin</function> and <function>acos</function>.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.atan2">
    <refnamediv>
- <refname>Atan2</refname>
+ <refname>atan2</refname>
     <refpurpose>arc tangent of two variables</refpurpose>
    </refnamediv>
    <refsect1>
@@ -206,21 +202,27 @@
      </funcprototype>
     </funcsynopsis>
     <simpara>
- This function calculates the arc tangent of the two variables x and y. It is similar to calculating the
- arc tangent of y / x, except that the signs of both arguments are used to determine the quadrant of the result.</simpara>
- <simpara>
- The function returns the result in radians, which is between -PI and PI (inclusive).</simpara>
+ This function calculates the arc tangent of the two variables
+ <parameter>x</parameter> and <parameter>y</parameter>. It is
+ similar to calculating the arc tangent of
+ <parameter>y</parameter> / <parameter>x</parameter>, except that
+ the signs of both arguments are used to determine the quadrant of
+ the result.
+ </simpara>
+ <simpara>
+ 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>
-
+ See also <function>acos</function> and <function>atan</function>.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.base-convert">
    <refnamediv>
     <refname>base_convert</refname>
- <refpurpose>convert a number between arbitrary bases</refpurpose>
+ <refpurpose>Convert a number between arbitrary bases</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -242,19 +244,20 @@
      base higher than 10 will be represented with the letters a-z,
      with a meaning 10, b meaning 11 and z meaning 36.
      <example>
- <title>base_convert()</title>
+ <title><function>Base_convert</function></title>
       <programlisting role="php">
-$binary = base_convert($hexadecimal, 16, 2);
+$binary = base_convert ($hexadecimal, 16, 2);
 </programlisting>
- </example></para>
+ </example>
+ </para>
    </refsect1>
   </refentry>
 
 
   <refentry id="function.bindec">
    <refnamediv>
- <refname>BinDec</refname>
- <refpurpose>binary to decimal</refpurpose>
+ <refname>bindec</refname>
+ <refpurpose>Binary to decimal</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -266,25 +269,24 @@
     </funcsynopsis>
     <para>
      Returns the decimal equivalent of the binary number represented by
- the binary_string argument.</para>
-
+ the binary_string argument.
+ </para>
     <para>
- OctDec converts a binary number to a decimal number. The largest
+ Octdec converts a binary number to a decimal number. The largest
      number that can be converted is 31 bits of 1's or 2147483647 in
- decimal.</para>
-
+ decimal.
+ </para>
     <para>
      See also the <function>decbin</function>
- function.</para>
-
+ function.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.ceil">
    <refnamediv>
- <refname>Ceil</refname>
- <refpurpose>round fractions up</refpurpose>
+ <refname>ceil</refname>
+ <refpurpose>Round fractions up</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -297,24 +299,24 @@
     <simpara>
      Returns the next highest integer value from
      <parameter>number</parameter>. Using <function>ceil</function>
- on integers is absolutely a waste of time.</simpara>
-
+ on integers is absolutely a waste of time.
+ </simpara>
     <simpara>
      NOTE: PHP/FI 2's <function>ceil</function> returned a
      float. Use: <literal>$new = (double)ceil($number);</literal> to
- get the old behaviour.</simpara>
-
+ get the old behaviour.
+ </simpara>
     <simpara>
- See also <function>floor</function> and <function>round</function>.</simpara>
-
+ See also <function>floor</function> and
+ <function>round</function>.
+ </simpara>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.cos">
    <refnamediv>
- <refname>Cos</refname>
- <refpurpose>cosine</refpurpose>
+ <refname>cos</refname>
+ <refpurpose>Cosine</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -325,19 +327,18 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Returns the cosine of arg in radians.</para>
-
+ Returns the cosine of arg in radians.
+ </para>
     <para>
- See also <function>sin</function> and <function>tan</function>.</para>
-
+ See also <function>sin</function> and <function>tan</function>.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.decbin">
    <refnamediv>
- <refname>DecBin</refname>
- <refpurpose>decimal to binary</refpurpose>
+ <refname>decbin</refname>
+ <refpurpose>Decimal to binary</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -350,20 +351,18 @@
     <para>
      Returns a string containing a binary representation of the given
      number argument. The largest number that can be converted is
- 2147483647 in decimal resulting to a string of 31 1's.</para>
-
+ 2147483647 in decimal resulting to a string of 31 1's.
+ </para>
     <para>
- See also the <function>bindec</function>
- function.</para>
-
+ See also the <function>bindec</function> function.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.dechex">
    <refnamediv>
- <refname>DecHex</refname>
- <refpurpose>decimal to hexadecimal</refpurpose>
+ <refname>dechex</refname>
+ <refpurpose>Decimal to hexadecimal</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -376,20 +375,18 @@
     <para>
      Returns a string containing a hexadecimal representation of the
      given number argument. The largest number that can
- be converted is 2147483647 in decimal resulting to "7fffffff".</para>
-
+ be converted is 2147483647 in decimal resulting to "7fffffff".
+ </para>
     <para>
- See also the <function>hexdec</function>
- function.</para>
-
+ See also the <function>hexdec</function> function.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.decoct">
    <refnamediv>
- <refname>DecOct</refname>
- <refpurpose>decimal to octal</refpurpose>
+ <refname>decoct</refname>
+ <refpurpose>Decimal to octal</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -402,40 +399,43 @@
     <para>
      Returns a string containing an octal representation of the given
      number argument. The largest number that can be converted is
- 2147483647 in decimal resulting to "17777777777". See also <function>octdec</function>.</para>
-
+ 2147483647 in decimal resulting to "17777777777".
+ </para>
+ <para>
+ See also <function>octdec</function>.
+ </para>
    </refsect1>
   </refentry>
 
-
- <refentry id="function.deg2rad">
- <refnamediv>
- <refname>deg2rad</refname>
- <refpurpose>Converts the number in degrees to the radian equivalent</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>double <function>deg2rad</function></funcdef>
- <paramdef>double <parameter>number</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- This function converts <parameter>number</parameter> from degrees to
- the radian equivalent.
- </para>
- <para>
- See also <function>rad2deg</function>.
- </para>
- </refsect1>
- </refentry>
-
+ <refentry id="function.deg2rad">
+ <refnamediv>
+ <refname>deg2rad</refname>
+ <refpurpose>
+ Converts the number in degrees to the radian equivalent
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>double <function>deg2rad</function></funcdef>
+ <paramdef>double <parameter>number</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ This function converts <parameter>number</parameter> from degrees
+ to the radian equivalent.
+ </para>
+ <para>
+ See also <function>rad2deg</function>.
+ </para>
+ </refsect1>
+ </refentry>
 
   <refentry id="function.exp">
    <refnamediv>
- <refname>Exp</refname>
- <refpurpose>e to the power of...</refpurpose>
+ <refname>exp</refname>
+ <refpurpose>e to the power of ...</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -446,19 +446,18 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Returns e raised to the power of <parameter>arg</parameter>.</para>
-
+ Returns e raised to the power of <parameter>arg</parameter>.
+ </para>
     <para>
- See also <function>pow</function>.</para>
-
+ See also <function>pow</function>.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.floor">
    <refnamediv>
- <refname>Floor</refname>
- <refpurpose>round fractions down</refpurpose>
+ <refname>floor</refname>
+ <refpurpose>Round fractions down</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -471,15 +470,17 @@
     <simpara>
      Returns the next lowest integer value from
      <parameter>number</parameter>. Using <function>floor</function>
- on integers is absolutely a waste of time.</simpara>
-
+ on integers is absolutely a waste of time.
+ </simpara>
     <simpara>
      NOTE: PHP/FI 2's <function>floor</function> returned a
      float. Use: <literal>$new = (double)floor($number);</literal> to
- get the old behaviour.</simpara>
-
+ get the old behaviour.
+ </simpara>
     <simpara>
- See also <function>ceil</function> and <function>round</function>.</simpara>
+ See also <function>ceil</function> and
+ <function>round</function>.
+ </simpara>
    </refsect1>
   </refentry>
 
@@ -487,7 +488,7 @@
   <refentry id="function.getrandmax">
    <refnamediv>
     <refname>getrandmax</refname>
- <refpurpose>show largest possible random value</refpurpose>
+ <refpurpose>Show largest possible random value</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -497,26 +498,22 @@
       <paramdef>void </paramdef>
      </funcprototype>
     </funcsynopsis>
-
     <simpara>
      Returns the maximum value that can be returned by a call to
- <function>rand</function>.</simpara>
-
+ <function>rand</function>.
+ </simpara>
     <simpara>
- See also <function>rand</function>,
- <function>srand</function>
- <function>mt_rand</function>,
- <function>mt_srand</function> and
- <function>mt_getrandmax</function>.</simpara>
-
+ See also <function>rand</function>, <function>srand</function>,
+ <function>mt_rand</function>, <function>mt_srand</function>, and
+ <function>mt_getrandmax</function>.
+ </simpara>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.hexdec">
    <refnamediv>
- <refname>HexDec</refname>
- <refpurpose>hexadecimal to decimal</refpurpose>
+ <refname>hexdec</refname>
+ <refpurpose>Hexadecimal to decimal</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -530,20 +527,18 @@
      Returns the decimal equivalent of the hexadecimal number
      represented by the hex_string argument. HexDec converts a
      hexadecimal string to a decimal number. The largest number that
- can be converted is 7fffffff or 2147483647 in decimal.</para>
-
+ can be converted is 7fffffff or 2147483647 in decimal.
+ </para>
     <para>
- See also the <function>dechex</function>
- function.</para>
-
+ See also the <function>dechex</function> function.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.log">
    <refnamediv>
- <refname>Log</refname>
- <refpurpose>natural logarithm</refpurpose>
+ <refname>log</refname>
+ <refpurpose>Natural logarithm</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -554,16 +549,15 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Returns the natural logarithm of arg.</para>
-
+ Returns the natural logarithm of arg.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.log10">
    <refnamediv>
- <refname>Log10</refname>
- <refpurpose>base-10 logarithm</refpurpose>
+ <refname>log10</refname>
+ <refpurpose>Base-10 logarithm</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -574,16 +568,15 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Returns the base-10 logarithm of arg.</para>
-
+ Returns the base-10 logarithm of <parameter>arg</parameter>.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.max">
    <refnamediv>
     <refname>max</refname>
- <refpurpose>find highest value</refpurpose>
+ <refpurpose>Find highest value</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -597,28 +590,28 @@
     </funcsynopsis>
     <para>
      <function>max</function> returns the numerically highest of the
- parameter values.</para>
-
+ parameter values.
+ </para>
     <para>
      If the first parameter is an array, <function>max</function>
      returns the highest value in that array. If the first parameter
      is an integer, string or double, you need at least two parameters
      and <function>max</function> returns the biggest of these values.
- You can compare an unlimited number of values.</para>
-
+ You can compare an unlimited number of values.
+ </para>
     <para>
      If one or more of the values is a double, all the values will be
      treated as doubles, and a double is returned. If none of the
      values is a double, all of them will be treated as integers, and
- an integer is returned.</para>
-
+ an integer is returned.
+ </para>
    </refsect1>
   </refentry>
 
   <refentry id="function.min">
    <refnamediv>
     <refname>min</refname>
- <refpurpose>find lowest value</refpurpose>
+ <refpurpose>Find lowest value</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -631,37 +624,40 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>min</function> returns the numerically lowest of the
- parameter values.</para>
+ <function>Min</function> returns the numerically lowest of the
+ parameter values.
+ </para>
     <para>
      If the first parameter is an array, <function>min</function>
      returns the lowest value in that array. If the first parameter
      is an integer, string or double, you need at least two parameters
      and <function>min</function> returns the lowest of these values.
- You can compare an unlimited number of values.</para>
+ You can compare an unlimited number of values.
+ </para>
     <para>
      If one or more of the values is a double, all the values will be
      treated as doubles, and a double is returned. If none of the
      values is a double, all of them will be treated as integers, and
- an integer is returned.</para>
+ an integer is returned.
+ </para>
    </refsect1>
   </refentry>
 
   <refentry id="function.mt-rand">
    <refnamediv>
     <refname>mt_rand</refname>
- <refpurpose>generate a better random value</refpurpose>
+ <refpurpose>Generate a better random value</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>mt_rand</function></funcdef>
- <paramdef>
- <parameter><optional>int min</optional></parameter>
+ <paramdef>int
+ <parameter><optional>min</optional></parameter>
       </paramdef>
- <paramdef>
- <parameter><optional>int max</optional></parameter>
+ <paramdef>int
+ <parameter><optional>max</optional></parameter>
       </paramdef>
      </funcprototype>
     </funcsynopsis>
@@ -711,7 +707,7 @@
   <refentry id="function.mt-srand">
    <refnamediv>
     <refname>mt_srand</refname>
- <refpurpose>seed the better random number generator</refpurpose>
+ <refpurpose>Seed the better random number generator</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -720,34 +716,31 @@
       <funcdef>void <function>mt_srand</function></funcdef>
       <paramdef>int <parameter>seed</parameter></paramdef>
      </funcprototype>
- </funcsynopsis>
-
+ </funcsynopsis>
     <para>
      Seeds the random number generator with
      <parameter>seed</parameter>.
-
      <informalexample>
- <programlisting>
+ <programlisting role="php">
 // seed with microseconds since last "whole" second
-mt_srand((double)microtime()*1000000);
+mt_srand ((double) microtime() * 1000000);
 $randval = mt_rand();
       </programlisting>
- </informalexample></para>
-
+ </informalexample>
+ </para>
     <simpara>
      See also <function>mt_rand</function>,
- <function>mt_getrandmax</function>,
- <function>srand</function>,
- <function>rand</function> and
- <function>getrandmax</function>.</simpara>
-
+ <function>mt_getrandmax</function>, <function>srand</function>,
+ <function>rand</function>, and
+ <function>getrandmax</function>.
+ </simpara>
    </refsect1>
   </refentry>
 
   <refentry id="function.mt-getrandmax">
    <refnamediv>
     <refname>mt_getrandmax</refname>
- <refpurpose>show largest possible random value</refpurpose>
+ <refpurpose>Show largest possible random value</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -756,27 +749,24 @@
       <funcdef>int <function>mt_getrandmax</function></funcdef>
       <paramdef>void </paramdef>
      </funcprototype>
- </funcsynopsis>
-
+ </funcsynopsis>
     <simpara>
      Returns the maximum value that can be returned by a call to
- <function>mt_rand</function>.</simpara>
-
+ <function>mt_rand</function>.
+ </simpara>
     <simpara>
      See also <function>mt_rand</function>,
- <function>mt_srand</function>
- <function>rand</function>,
- <function>srand</function> and
- <function>getrandmax</function>.</simpara>
-
+ <function>mt_srand</function> <function>rand</function>,
+ <function>srand</function>, and
+ <function>getrandmax</function>.
+ </simpara>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.number-format">
    <refnamediv>
     <refname>number_format</refname>
- <refpurpose>format a number with grouped thousands</refpurpose>
+ <refpurpose>Format a number with grouped thousands</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -790,12 +780,12 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>number_format</function> returns a formatted version of
+ <function>Number_format</function> returns a formatted version of
      <parameter>number</parameter>. This function accepts either one,
      two or four parameters (not three):
     </para>
     <para>If only one parameter is given,
- <parameter>number</parameter> will be formatted without decimals,
+ <parameter>Number</parameter> will be formatted without decimals,
      but with a comma (",") between every group of thousands.
     </para>
     <para>
@@ -814,11 +804,10 @@
    </refsect1>
   </refentry>
 
-
   <refentry id="function.octdec">
    <refnamediv>
- <refname>OctDec</refname>
- <refpurpose>octal to decimal</refpurpose>
+ <refname>octdec</refname>
+ <refpurpose>Octal to decimal</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -833,18 +822,18 @@
      represented by the octal_string argument.
      OctDec converts an octal string to a decimal number. The largest
      number that can be converted is 17777777777 or 2147483647 in
- decimal.</para>
-
+ decimal.
+ </para>
     <para>
- See also <function>decoct</function>.</para>
-
+ See also <function>decoct</function>.
+ </para>
    </refsect1>
   </refentry>
 
   <refentry id="function.pi">
    <refnamediv>
     <refname>pi</refname>
- <refpurpose>get value of pi</refpurpose>
+ <refpurpose>Get value of pi</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -854,18 +843,16 @@
       <paramdef>void </paramdef>
      </funcprototype>
     </funcsynopsis>
-
     <simpara>
- Returns an approximation of pi.</simpara>
-
+ Returns an approximation of pi.
+ </simpara>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.pow">
    <refnamediv>
     <refname>pow</refname>
- <refpurpose>exponential expression</refpurpose>
+ <refpurpose>Exponential expression</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -877,37 +864,38 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Returns base raised to the power of exp.</para>
-
- <para> See also <function>exp</function>.</para>
-
+ Returns base raised to the power of exp.
+ </para>
+ <para>
+ See also <function>exp</function>.
+ </para>
    </refsect1>
   </refentry>
-
 
- <refentry id="function.rad2deg">
- <refnamediv>
- <refname>rad2deg</refname>
- <refpurpose>Converts the radian number to the equivalent number in degrees</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
+ <refentry id="function.rad2deg">
+ <refnamediv>
+ <refname>rad2deg</refname>
+ <refpurpose>
+ Converts the radian number to the equivalent number in degrees
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
      <funcprototype>
- <funcdef>double <function>rad2deg</function></funcdef>
- <paramdef>double <parameter>number</parameter></paramdef>
+ <funcdef>double <function>rad2deg</function></funcdef>
+ <paramdef>double <parameter>number</parameter></paramdef>
      </funcprototype>
- </funcsynopsis>
- <para>
- This function converts <parameter>number</parameter> from
- radian to degrees.
- </para>
- <para>
- See also <function>deg2rad</function>.
- </para>
- </refsect1>
- </refentry>
-
+ </funcsynopsis>
+ <para>
+ This function converts <parameter>number</parameter> from radian
+ to degrees.
+ </para>
+ <para>
+ See also <function>deg2rad</function>.
+ </para>
+ </refsect1>
+ </refentry>
 
   <refentry id="function.rand">
    <refnamediv>
@@ -951,7 +939,7 @@
     <simpara>
      See also <function>srand</function>,
      <function>getrandmax</function>, <function>mt_rand</function>,
- <function>mt_srand</function> and
+ <function>mt_srand</function>, and
      <function>mt_getrandmax</function>.
     </simpara>
    </refsect1>
@@ -960,7 +948,7 @@
   <refentry id="function.round">
    <refnamediv>
     <refname>round</refname>
- <refpurpose>Rounds a float.</refpurpose>
+ <refpurpose>Rounds a float</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -973,32 +961,30 @@
           </paramdef>
      </funcprototype>
     </funcsynopsis>
-
     <para>
      Returns the rounded value of <parameter>val</parameter> to
- specified precision.
-
+ specified precision.
      <informalexample>
- <programlisting>
-$foo = round( 3.4 ); // $foo == 3.0
-$foo = round( 3.5 ); // $foo == 4.0
-$foo = round( 3.6 ); // $foo == 4.0
+ <programlisting role="php">
+$foo = round (3.4); // $foo == 3.0
+$foo = round (3.5); // $foo == 4.0
+$foo = round (3.6); // $foo == 4.0
 
-$foo = round( 1.95583 , 2 ); // $foo == 1.96
+$foo = round (1.95583, 2); // $foo == 1.96
       </programlisting>
- </informalexample></para>
-
+ </informalexample>
+ </para>
     <simpara>
- See also <function>ceil</function> and <function>floor</function>.</simpara>
-
+ See also <function>ceil</function> and
+ <function>floor</function>.
+ </simpara>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.sin">
    <refnamediv>
- <refname>Sin</refname>
- <refpurpose>sine</refpurpose>
+ <refname>sin</refname>
+ <refpurpose>Sine</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1009,19 +995,18 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Returns the sine of arg in radians.</para>
-
+ Returns the sine of arg in radians.
+ </para>
     <para>
- See also <function>cos</function> and <function>tan</function>.</para>
-
+ See also <function>cos</function> and <function>tan</function>.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.sqrt">
    <refnamediv>
- <refname>Sqrt</refname>
- <refpurpose>square root</refpurpose>
+ <refname>sqrt</refname>
+ <refpurpose>Square root</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1031,18 +1016,16 @@
       <paramdef>float <parameter>arg</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
-
     <para>
- Returns the square root of arg.</para>
-
+ Returns the square root of <parameter>arg</parameter>.
+ </para>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.srand">
    <refnamediv>
     <refname>srand</refname>
- <refpurpose>seed the random number generator</refpurpose>
+ <refpurpose>Seed the random number generator</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1052,34 +1035,30 @@
       <paramdef>int <parameter>seed</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
-
     <para>
      Seeds the random number generator with
      <parameter>seed</parameter>.
-
      <informalexample>
- <programlisting>
+ <programlisting role="php">
 // seed with microseconds since last "whole" second
-srand((double)microtime()*1000000);
+srand ((double) microtime() * 1000000);
 $randval = rand();
       </programlisting>
- </informalexample></para>
-
+ </informalexample>
+ </para>
     <simpara>
      See also <function>rand</function>,
- <function>getrandmax</function>,
- <function>mt_rand</function>,
- <function>mt_srand</function> and
- <function>mt_getrandmax</function>.</simpara>
-
+ <function>getrandmax</function>, <function>mt_rand</function>,
+ <function>mt_srand</function>, and
+ <function>mt_getrandmax</function>.
+ </simpara>
    </refsect1>
   </refentry>
 
-
   <refentry id="function.tan">
    <refnamediv>
- <refname>Tan</refname>
- <refpurpose>tangent</refpurpose>
+ <refname>tan</refname>
+ <refpurpose>Tangent</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1090,14 +1069,13 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- Returns the tangent of arg in radians.</para>
-
+ Returns the tangent of arg in radians.
+ </para>
     <para>
- See also <function>sin</function> and <function>cos</function>.</para>
-
+ See also <function>sin</function> and <function>cos</function>.
+ </para>
    </refsect1>
   </refentry>
-
 
  </reference>