From: Skip Montanaro <skip@pobox.com>
Date: Sat, 26 Apr 2003 02:59:46 +0000 (+0000)
Subject: backport of note arising from bug 711019.
X-Git-Tag: v2.2.3c1~53
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=02157566f3d8d253a00fb2c1f4b86dcca749a033;p=thirdparty%2FPython%2Fcpython.git

backport of note arising from bug 711019.
---

diff --git a/Doc/lib/libmath.tex b/Doc/lib/libmath.tex
index 0f286d426d7f..d5294d8ab739 100644
--- a/Doc/lib/libmath.tex
+++ b/Doc/lib/libmath.tex
@@ -17,7 +17,7 @@ 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:
+The following functions are provided by this module:
 
 \begin{funcdesc}{acos}{x}
 Return the arc cosine of \var{x}.
@@ -135,6 +135,16 @@ The mathematical constant \emph{pi}.
 The mathematical constant \emph{e}.
 \end{datadesc}
 
+\begin{notice}
+  Specific exceptions raised in assorted error cases (and even whether some
+  arguments are considered to be exceptional at all) are not defined in any
+  useful cross-platform or cross-release way.  For example, whether
+  \code{math.log(0)} returns \code{-Inf} or raises \exception{ValueError} or
+  \exception{OverflowError} is both platform- and release-dependent, and in
+  cases where \code{math.log(0)} raises an \exception{OverflowError},
+  \code{math.log(0L)} often raises a \exception{ValueError}.
+\end{notice}
+
 \begin{seealso}
   \seemodule{cmath}{Complex number versions of many of these functions.}
 \end{seealso}