Skip to content

[3.10] gh-90744: Fix erroneous doc links in the sys module (GH-101319) #102322

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hugovk merged 2 commits into from
Mar 2, 2023
Merged

[3.10] gh-90744: Fix erroneous doc links in the sys module (GH-101319) #102322

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e6bf616
gh-85988: Change documentation for sys.float_info.rounds (GH-99675)
tbwolfe Nov 27, 2022
a0fb9b3
GH-90744: Fix erroneous doc links in the sys module (#101319)
furkanonder Feb 28, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
GH-90744: Fix erroneous doc links in the sys module (#101319) 
Co-authored-by: Hugo van Kemenade <hugovk@users.noreply.github.com>
  • Loading branch information
@furkanonder @hugovk
furkanonder and hugovk committed Feb 28, 2023
commit a0fb9b38618b15bb40d0c1a5d2d35c4321252d73
98 changes: 49 additions & 49 deletions Doc/library/sys.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -522,55 +522,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
Expand Down