Add notes to __builtin__.float() and string.atof() that the NaN and Inf

results are possible but non-portable.

2 files changed, 20 insertions, 12 deletions

diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex
index 316b294..210fec4 100644
--- a/Doc/lib/libfuncs.tex
+++ b/Doc/lib/libfuncs.tex
@@ -231,13 +231,17 @@ removed.
 \begin{funcdesc}{float}{x}
   Convert a string or a number to floating point.  If the argument is a
   string, it must contain a possibly signed decimal or floating point
-  number, possibly embedded in whitespace, or be \code{'NaN'} (case
-  insensitive); this behaves identical to
-  \code{string.atof(\var{x})}.  If the string is \code{'NaN'}, the
-  IEEE ``Not a Number'' value is returned.  Otherwise, the argument
-  may be a plain or long integer or a floating point number, and a
-  floating point number with the same value (within Python's floating
-  point precision) is returned.
+  number, possibly embedded in whitespace; this behaves identical to
+  \code{string.atof(\var{x})}.  Otherwise, the argument may be a plain
+  or long integer or a floating point number, and a floating point
+  number with the same value (within Python's floating point
+  precision) is returned.
+
+  \strong{Note:} When passing in a string, values for NaN\index{NaN}
+  and Infinity\index{Infinity} may be returned, depending on the
+  underlying C library.  The specific set of strings accepted which
+  cause these values to be returned depends entirely on the C library
+  and is known to vary.
 \end{funcdesc}
 
 \begin{funcdesc}{getattr}{object, name}
diff --git a/Doc/lib/libstring.tex b/Doc/lib/libstring.tex
index 56dcf6d..a83d821 100644
--- a/Doc/lib/libstring.tex
+++ b/Doc/lib/libstring.tex
@@ -59,11 +59,15 @@ The functions defined in this module are:
 \begin{funcdesc}{atof}{s}
   Convert a string to a floating point number.  The string must have
   the standard syntax for a floating point literal in Python,
-  optionally preceded by a sign (\samp{+} or \samp{-}), or be
-  \code{'NaN'} (case insensitive) to indicate the IEEE ``Not a
-  Number'' value.  Note that this behaves identical to the built-in
-  function \function{float()}\bifuncindex{float} when passed a
-  string.
+  optionally preceded by a sign (\samp{+} or \samp{-}).  Note that
+  this behaves identical to the built-in function
+  \function{float()}\bifuncindex{float} when passed a string.
+
+  \strong{Note:} When passing in a string, values for NaN\index{NaN}
+  and Infinity\index{Infinity} may be returned, depending on the
+  underlying C library.  The specific set of strings accepted which
+  cause these values to be returned depends entirely on the C library
+  and is known to vary.
 \end{funcdesc}
 
 \begin{funcdesc}{atoi}{s\optional{, base}}