]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
docs: clearly document that ":GH-X" string formatting results in "0X..." (GH-25941)
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Thu, 6 May 2021 19:52:50 +0000 (12:52 -0700)
committerGitHub <noreply@github.com>
Thu, 6 May 2021 19:52:50 +0000 (12:52 -0700)
* clearly document that ":GH-X" string formatting results in "0X..."

* put back the "serial comma"
(cherry picked from commit 92ceb1c8402422412fcbb98ca19448677c667c3c)

Co-authored-by: Tal Einat <532281+taleinat@users.noreply.github.com>
Doc/library/string.rst

index e55884d28d63361f6862fb4bf77eeb9164a26ad4..d1bdf4347de19231c56f0300f2274c23a48a8a8b 100644 (file)
@@ -386,8 +386,8 @@ The ``'#'`` option causes the "alternate form" to be used for the
 conversion.  The alternate form is defined differently for different
 types.  This option is only valid for integer, float and complex
 types. For integers, when binary, octal, or hexadecimal output
-is used, this option adds the prefix respective ``'0b'``, ``'0o'``, or
-``'0x'`` to the output value. For float and complex the
+is used, this option adds the respective prefix ``'0b'``, ``'0o'``,
+``'0x'``, or ``'0X'`` to the output value. For float and complex the
 alternate form causes the result of the conversion to always contain a
 decimal-point character, even if no digits follow it. Normally, a
 decimal-point character appears in the result of these conversions
@@ -463,6 +463,8 @@ The available integer presentation types are:
    +---------+----------------------------------------------------------+
    | ``'X'`` | Hex format. Outputs the number in base 16, using         |
    |         | upper-case letters for the digits above 9.               |
+   |         | In case ``'#'`` is specified, the prefix ``'0x'`` will   |
+   |         | be upper-cased to ``'0X'`` as well.                      |
    +---------+----------------------------------------------------------+
    | ``'n'`` | Number. This is the same as ``'d'``, except that it uses |
    |         | the current locale setting to insert the appropriate     |