summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libmath.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/lib/libmath.tex')
-rw-r--r--Doc/lib/libmath.tex14
1 files changed, 13 insertions, 1 deletions
diff --git a/Doc/lib/libmath.tex b/Doc/lib/libmath.tex
index 0a45fb3..af1ac10 100644
--- a/Doc/lib/libmath.tex
+++ b/Doc/lib/libmath.tex
@@ -5,7 +5,19 @@
\modulesynopsis{Mathematical functions (\function{sin()} etc.).}
This module is always available. It provides access to the
-mathematical functions defined by the C standard. They are:
+mathematical functions defined by the C standard.
+
+These functions cannot be used with complex numbers; use the functions
+of the same name from the \refmodule{cmath} module if you require
+support for complex numbers. The distinction between functions which
+support complex numbers and those which don't is made since most users
+do not want to learn quite as much mathematics as required to
+understand complex numbers. Receiving an exception instead of a
+complex result allows earlier detection of the unexpected complex
+number used as a parameter, so that the programmer can determine how
+and why it was generated in the first place.
+
+The following functions provided by this module:
\begin{funcdesc}{acos}{x}
Return the arc cosine of \var{x}.