[Python-checkins] GH-90744: Fix erroneous doc links in the sys module (#101319)
hugovk
webhook-mailer at python.org
Tue Feb 28 06:43:19 EST 2023
https://github.com/python/cpython/commit/85b1fc1fc5a2e49d521382eaf5e7793175d00371
commit: 85b1fc1fc5a2e49d521382eaf5e7793175d00371
branch: main
author: Furkan Onder <furkanonder at protonmail.com>
committer: hugovk <hugovk at users.noreply.github.com>
date: 2023-02-28T13:43:00+02:00
summary:
GH-90744: Fix erroneous doc links in the sys module (#101319)
Co-authored-by: Hugo van Kemenade <hugovk at users.noreply.github.com>
files:
M Doc/library/sys.rst
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 605e2c9a6710..23c5bbed0c6f 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -568,55 +568,55 @@ always available.
.. tabularcolumns:: |l|l|L|
- +---------------------+----------------+--------------------------------------------------+
- | attribute | float.h macro | explanation |
- +=====================+================+==================================================+
- | :const:`epsilon` | DBL_EPSILON | difference between 1.0 and the least value |
- | | | greater than 1.0 that is representable as a float|
- | | | |
- | | | See also :func:`math.ulp`. |
- +---------------------+----------------+--------------------------------------------------+
- | :const:`dig` | DBL_DIG | maximum number of decimal digits that can be |
- | | | faithfully represented in a float; see below |
- +---------------------+----------------+--------------------------------------------------+
- | :const:`mant_dig` | DBL_MANT_DIG | float precision: the number of base-``radix`` |
- | | | digits in the significand of a float |
- +---------------------+----------------+--------------------------------------------------+
- | :const:`max` | DBL_MAX | maximum representable positive finite float |
- +---------------------+----------------+--------------------------------------------------+
- | :const:`max_exp` | DBL_MAX_EXP | maximum integer *e* such that ``radix**(e-1)`` is|
- | | | a representable finite float |
- +---------------------+----------------+--------------------------------------------------+
- | :const:`max_10_exp` | DBL_MAX_10_EXP | maximum integer *e* such that ``10**e`` is in the|
- | | | range of representable finite floats |
- +---------------------+----------------+--------------------------------------------------+
- | :const:`min` | DBL_MIN | minimum representable positive *normalized* float|
- | | | |
- | | | Use :func:`math.ulp(0.0) <math.ulp>` to get the |
- | | | smallest positive *denormalized* representable |
- | | | float. |
- +---------------------+----------------+--------------------------------------------------+
- | :const:`min_exp` | DBL_MIN_EXP | minimum integer *e* such that ``radix**(e-1)`` is|
- | | | a normalized float |
- +---------------------+----------------+--------------------------------------------------+
- | :const:`min_10_exp` | DBL_MIN_10_EXP | minimum integer *e* such that ``10**e`` is a |
- | | | normalized float |
- +---------------------+----------------+--------------------------------------------------+
- | :const:`radix` | FLT_RADIX | radix of exponent representation |
- +---------------------+----------------+--------------------------------------------------+
- | :const:`rounds` | FLT_ROUNDS | integer representing the rounding mode for |
- | | | floating-point arithmetic. This reflects the |
- | | | value of the system FLT_ROUNDS macro at |
- | | | interpreter startup time: |
- | | | ``-1`` indeterminable, |
- | | | ``0`` toward zero, |
- | | | ``1`` to nearest, |
- | | | ``2`` toward positive infinity, |
- | | | ``3`` toward negative infinity |
- | | | |
- | | | All other values for FLT_ROUNDS characterize |
- | | | implementation-defined rounding behavior. |
- +---------------------+----------------+--------------------------------------------------+
+ +---------------------+---------------------+--------------------------------------------------+
+ | attribute | float.h macro | explanation |
+ +=====================+=====================+==================================================+
+ | ``epsilon`` | ``DBL_EPSILON`` | difference between 1.0 and the least value |
+ | | | greater than 1.0 that is representable as a float|
+ | | | |
+ | | | See also :func:`math.ulp`. |
+ +---------------------+---------------------+--------------------------------------------------+
+ | ``dig`` | ``DBL_DIG`` | maximum number of decimal digits that can be |
+ | | | faithfully represented in a float; see below |
+ +---------------------+---------------------+--------------------------------------------------+
+ | ``mant_dig`` | ``DBL_MANT_DIG`` | float precision: the number of base-``radix`` |
+ | | | digits in the significand of a float |
+ +---------------------+---------------------+--------------------------------------------------+
+ | ``max`` | ``DBL_MAX`` | maximum representable positive finite float |
+ +---------------------+---------------------+--------------------------------------------------+
+ | ``max_exp`` | ``DBL_MAX_EXP`` | maximum integer *e* such that ``radix**(e-1)`` is|
+ | | | a representable finite float |
+ +---------------------+---------------------+--------------------------------------------------+
+ | ``max_10_exp`` | ``DBL_MAX_10_EXP`` | maximum integer *e* such that ``10**e`` is in the|
+ | | | range of representable finite floats |
+ +---------------------+---------------------+--------------------------------------------------+
+ | ``min`` | ``DBL_MIN`` | minimum representable positive *normalized* float|
+ | | | |
+ | | | Use :func:`math.ulp(0.0) <math.ulp>` to get the |
+ | | | smallest positive *denormalized* representable |
+ | | | float. |
+ +---------------------+---------------------+--------------------------------------------------+
+ | ``min_exp`` | ``DBL_MIN_EXP`` | minimum integer *e* such that ``radix**(e-1)`` is|
+ | | | a normalized float |
+ +---------------------+---------------------+--------------------------------------------------+
+ | ``min_10_exp`` | ``DBL_MIN_10_EXP`` | minimum integer *e* such that ``10**e`` is a |
+ | | | normalized float |
+ +---------------------+---------------------+--------------------------------------------------+
+ | ``radix`` | ``FLT_RADIX`` | radix of exponent representation |
+ +---------------------+---------------------+--------------------------------------------------+
+ | ``rounds`` | ``FLT_ROUNDS`` | integer representing the rounding mode for |
+ | | | floating-point arithmetic. This reflects the |
+ | | | value of the system ``FLT_ROUNDS`` macro at |
+ | | | interpreter startup time: |
+ | | | ``-1`` indeterminable, |
+ | | | ``0`` toward zero, |
+ | | | ``1`` to nearest, |
+ | | | ``2`` toward positive infinity, |
+ | | | ``3`` toward negative infinity |
+ | | | |
+ | | | All other values for ``FLT_ROUNDS`` characterize |
+ | | | implementation-defined rounding behavior. |
+ +---------------------+---------------------+--------------------------------------------------+
The attribute :attr:`sys.float_info.dig` needs further explanation. If
``s`` is any string representing a decimal number with at most
More information about the Python-checkins
mailing list