From: Sergey B Kirpichev Date: Thu, 26 Sep 2024 12:40:18 +0000 (+0300) Subject: gh-123560: Correct docs for "empty" format type for floats (#123561) X-Git-Tag: v3.14.0a1~316 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=274d9ab619b8150a613275835234ea9ef935f21f;p=thirdparty%2FPython%2Fcpython.git gh-123560: Correct docs for "empty" format type for floats (#123561) --- 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 |