Merged revisions 59245-59254 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk
........
r59245 | georg.brandl | 2007-11-30 23:04:45 +0100 (Fri, 30 Nov 2007) | 2 lines
Move lchmod() docs to correct place, and add versionadded tags.
........
r59249 | christian.heimes | 2007-11-30 23:36:10 +0100 (Fri, 30 Nov 2007) | 2 lines
Backport of -r59242:59246 from py3k
Fixed problem with regrtest caused by the additional of objects to _abcoll.
........
r59253 | christian.heimes | 2007-12-01 02:03:20 +0100 (Sat, 01 Dec 2007) | 1 line
Although pyconfig.h claims that WIN32 is obsolete it is still required for the locale module. locale.getdefaultlocale() fails silently w/o the WIN32 macro.
........
r59254 | christian.heimes | 2007-12-01 12:20:10 +0100 (Sat, 01 Dec 2007) | 3 lines
Feature #1534
Added PyFloat_GetMax(), PyFloat_GetMin() and PyFloat_GetInfo() to the float API.
Added a dictionary sys.float_info with information about the internal floating point type to the sys module.
........
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 94e4eb9..33de4f6 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -184,6 +184,48 @@
error occurs.
+.. data:: float_info
+
+ A dict holding information about the float type. It contains low level
+ information about the precision and internal representation. Please study
+ your system's :file:`float.h` for more information.
+
+ +---------------------+--------------------------------------------------+
+ | key | explanation |
+ +=====================+==================================================+
+ | :const:`epsilon` | Difference between 1 and the next representable |
+ | | floating point number |
+ +---------------------+--------------------------------------------------+
+ | :const:`dig` | digits (see :file:`float.h`) |
+ +---------------------+--------------------------------------------------+
+ | :const:`mant_dig` | mantissa digits (see :file:`float.h`) |
+ +---------------------+--------------------------------------------------+
+ | :const:`max` | maximum representable finite float |
+ +---------------------+--------------------------------------------------+
+ | :const:`max_exp` | maximum int e such that radix**(e-1) is in the |
+ | | range of finite representable floats |
+ +---------------------+--------------------------------------------------+
+ | :const:`max_10_exp` | maximum int e such that 10**e is in the |
+ | | range of finite representable floats |
+ +---------------------+--------------------------------------------------+
+ | :const:`min` | Minimum positive normalizer float |
+ +---------------------+--------------------------------------------------+
+ | :const:`min_exp` | minimum int e such that radix**(e-1) is a |
+ | | normalized float |
+ +---------------------+--------------------------------------------------+
+ | :const:`min_10_exp` | minimum int e such that 10**e is a normalized |
+ | | float |
+ +---------------------+--------------------------------------------------+
+ | :const:`radix` | radix of exponent |
+ +---------------------+--------------------------------------------------+
+ | :const:`rounds` | addition rounds (see :file:`float.h`) |
+ +---------------------+--------------------------------------------------+
+
+ .. note::
+
+ The information in the table is simplified.
+
+
.. function:: getcheckinterval()
Return the interpreter's "check interval"; see :func:`setcheckinterval`.