From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Thu, 26 Sep 2024 12:53:58 +0000 (+0200) Subject: [3.12] gh-123560: Correct docs for "empty" format type for floats (GH-123561) (#124597) X-Git-Tag: v3.12.7~36 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=42432e5254d16287f50e133878eb18ca024e0a46;p=thirdparty%2FPython%2Fcpython.git [3.12] gh-123560: Correct docs for "empty" format type for floats (GH-123561) (#124597) gh-123560: Correct docs for "empty" format type for floats (GH-123561) (cherry picked from commit 274d9ab619b8150a613275835234ea9ef935f21f) Co-authored-by: Sergey B Kirpichev --- diff --git a/Doc/library/string.rst b/Doc/library/string.rst index 1f316307965c..57a1f9205230 100644 --- a/Doc/library/string.rst +++ b/Doc/library/string.rst @@ -574,11 +574,13 @@ The available presentation types for :class:`float` and | ``'%'`` | Percentage. Multiplies the number by 100 and displays | | | in fixed (``'f'``) format, followed by a percent sign. | +---------+----------------------------------------------------------+ - | None | For :class:`float` this is the same as ``'g'``, except | + | None | For :class:`float` this is like the ``'g'`` type, except | | | that when fixed-point notation is used to format the | | | result, it always includes at least one digit past the | - | | decimal point. The precision used is as large as needed | - | | to represent the given value faithfully. | + | | decimal point, and switches to the scientific notation | + | | when ``exp >= p - 1``. When the precision is not | + | | specified, the latter will be as large as needed to | + | | represent the given value faithfully. | | | | | | For :class:`~decimal.Decimal`, this is the same as | | | either ``'g'`` or ``'G'`` depending on the value of |