From 5b89d410adc593a96450f6c637589ffb8d7c31b5 Mon Sep 17 00:00:00 2001
From: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
Date: Sat, 24 Dec 2022 14:09:31 -0600
Subject: [PATCH] gh-100428: Make float documentation more accurate (GH-100437)
Previously, the grammar did not accept `float("10")`.
Also implement mdickinson's suggestion of removing the indirection.
(cherry picked from commit 2e1a9ce9890aba748a518a39d01d1ea6d623d0d9)
Co-authored-by: Shantanu <12621235+hauntsaninja@users.noreply.github.com>
---
Doc/library/functions.rst | 21 ++++++++++++---------
1 file changed, 12 insertions(+), 9 deletions(-)
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 110e7e5d7fb9a7..304716194d2241 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -649,20 +649,23 @@ are always available. They are listed here in alphabetical order.
sign may be ``'+'`` or ``'-'``; a ``'+'`` sign has no effect on the value
produced. The argument may also be a string representing a NaN
(not-a-number), or positive or negative infinity. More precisely, the
- input must conform to the following grammar after leading and trailing
- whitespace characters are removed:
+ input must conform to the ``floatvalue`` production rule in the following
+ grammar, after leading and trailing whitespace characters are removed:
.. productionlist:: float
sign: "+" | "-"
infinity: "Infinity" | "inf"
nan: "nan"
- numeric_value: `floatnumber` | `infinity` | `nan`
- numeric_string: [`sign`] `numeric_value`
-
- Here ``floatnumber`` is the form of a Python floating-point literal,
- described in :ref:`floating`. Case is not significant, so, for example,
- "inf", "Inf", "INFINITY", and "iNfINity" are all acceptable spellings for
- positive infinity.
+ digitpart: `digit` (["_"] `digit`)*
+ number: [`digitpart`] "." `digitpart` | `digitpart` ["."]
+ exponent: ("e" | "E") ["+" | "-"] `digitpart`
+ floatnumber: number [`exponent`]
+ floatvalue: [`sign`] (`floatnumber` | `infinity` | `nan`)
+
+ Here ``digit`` is a Unicode decimal digit (character in the Unicode general
+ category ``Nd``). Case is not significant, so, for example, "inf", "Inf",
+ "INFINITY", and "iNfINity" are all acceptable spellings for positive
+ infinity.
Otherwise, if the argument is an integer or a floating point number, a
floating point number with the same value (within Python's floating point
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy