Update STDLIB documentation

Language cleaned up by the technical writers xsipewe and tmanevik
from Combitech. Proofreading and corrections by Björn Gustavsson
and Hans Bolinder.

1 files changed, 42 insertions, 34 deletions

diff --git a/lib/stdlib/doc/src/math.xml b/lib/stdlib/doc/src/math.xml
index 38084638f6..1358ce5cbf 100644
--- a/lib/stdlib/doc/src/math.xml
+++ b/lib/stdlib/doc/src/math.xml
@@ -30,78 +30,86 @@
     <docno>1</docno>
     <approved>Bjarne D&auml;cker</approved>
     <checked></checked>
-    <date>97-01-15</date>
+    <date>1997-01-15</date>
     <rev>B</rev>
-    <file>math.sgml</file>
+    <file>math.xml</file>
   </header>
   <module>math</module>
-  <modulesummary>Mathematical Functions</modulesummary>
+  <modulesummary>Mathematical functions.</modulesummary>
   <description>
     <p>This module provides an interface to a number of mathematical
       functions.</p>
+
     <note>
-      <p>Not all functions are implemented on all platforms. In particular,
-        the <c>erf/1</c> and <c>erfc/1</c> functions are not implemented on Windows.</p>
+      <p>Not all functions are provided on all platforms. In particular,
+        the <seealso marker="#erf/1"><c>erf/1</c></seealso> and
+        <seealso marker="#erfc/1"><c>erfc/1</c></seealso> functions
+        are not provided on Windows.</p>
     </note>
   </description>
+
   <funcs>
     <func>
-      <name name="pi" arity="0"/>
-      <fsummary>A useful number</fsummary>
-      <desc>
-        <p>A useful number.</p>
-      </desc>
-    </func>
-    <func>
-      <name name="sin" arity="1"/>
-      <name name="cos" arity="1"/>
-      <name name="tan" arity="1"/>
-      <name name="asin" arity="1"/>
       <name name="acos" arity="1"/>
+      <name name="acosh" arity="1"/>
+      <name name="asin" arity="1"/>
+      <name name="asinh" arity="1"/>
       <name name="atan" arity="1"/>
       <name name="atan2" arity="2"/>
-      <name name="sinh" arity="1"/>
-      <name name="cosh" arity="1"/>
-      <name name="tanh" arity="1"/>
-      <name name="asinh" arity="1"/>
-      <name name="acosh" arity="1"/>
       <name name="atanh" arity="1"/>
+      <name name="cos" arity="1"/>
+      <name name="cosh" arity="1"/>
       <name name="exp" arity="1"/>
       <name name="log" arity="1"/>
-      <name name="log2" arity="1"/>
       <name name="log10" arity="1"/>
+      <name name="log2" arity="1"/>
       <name name="pow" arity="2"/>
+      <name name="sin" arity="1"/>
+      <name name="sinh" arity="1"/>
       <name name="sqrt" arity="1"/>
-      <fsummary>Diverse math functions</fsummary>
-      <type variable="X" name_i="7"/>
-      <type variable="Y" name_i="7"/>
+      <name name="tan" arity="1"/>
+      <name name="tanh" arity="1"/>
+      <fsummary>Diverse math functions.</fsummary>
+      <type variable="X" name_i="6"/>
+      <type variable="Y" name_i="6"/>
       <desc>
-        <p>A collection of math functions which return floats. Arguments
-          are numbers. </p>
+        <p>A collection of mathematical functions that return floats. Arguments
+          are numbers.</p>
       </desc>
     </func>
+
     <func>
       <name name="erf" arity="1"/>
       <fsummary>Error function.</fsummary>
       <desc>
-        <p>Returns the error function of <c><anno>X</anno></c>, where</p>
+        <p>Returns the error function of <c><anno>X</anno></c>, where:</p>
         <pre>
-erf(X) = 2/sqrt(pi)*integral from 0 to X of exp(-t*t) dt.        </pre>
+erf(X) = 2/sqrt(pi)*integral from 0 to X of exp(-t*t) dt.</pre>
       </desc>
     </func>
+
     <func>
       <name name="erfc" arity="1"/>
-      <fsummary>Another error function</fsummary>
+      <fsummary>Another error function.</fsummary>
       <desc>
-        <p><c>erfc(X)</c> returns  <c>1.0 - erf(X)</c>, computed  by
-          methods that avoid cancellation for large <c><anno>X</anno></c>. </p>
+        <p><c>erfc(X)</c> returns <c>1.0</c> - <c>erf(X)</c>, computed by
+          methods that avoid cancellation for large <c><anno>X</anno></c>.</p>
       </desc>
     </func>
+
+    <func>
+      <name name="pi" arity="0"/>
+      <fsummary>A useful number.</fsummary>
+      <desc>
+        <p>A useful number.</p>
+      </desc>
+    </func>
+
   </funcs>
 
   <section>
-    <title>Bugs</title>
-    <p>As these are the C library, the bugs are the same.</p>
+    <title>Limitations</title>
+    <p>As these are the C library, the same limitations apply.</p>
   </section>
 </erlref>