bpo-26506: hex() documentation: mention "%x" % int (Original patch by Manvi B)

Doc/library/functions.rst

@@ -81,9 +81,25 @@ are always available.  They are listed here in alphabetical order.
 
 .. function:: bin(x)
 
-   Convert an integer number to a binary string. The result is a valid Python
-   expression.  If *x* is not a Python :class:`int` object, it has to define an
-   :meth:`__index__` method that returns an integer.
+   Convert an integer number to a binary string prefixed with "0b". The result is
+   a valid Python expression. If *x* is not a Python :class:`int` object, it has
+   to define an :meth:`__index__` method that returns an integer.
+
+   Some examples:
+
+      >>> bin(12)
+      '0b1100'
+      >>> bin(-10)
+      '-0b1010'
+
+   If prefix "0b" is desired or not, you can use either of the following ways.
+
+      >>> format(14, '#b'), format(14, 'b')
+      ('0b1110', '1110')
+      >>> f'{14:#b}', f'{14:b}'
+      ('0b1110', '1110')
+
+   See also :func:`format` for more information.
 
 
 .. class:: bool([x])
@@ -635,19 +651,29 @@ are always available.  They are listed here in alphabetical order.
 
 .. function:: hex(x)
 
-   Convert an integer number to a lowercase hexadecimal string
-   prefixed with "0x", for example:
+   Convert an integer number to a lowercase hexadecimal string prefixed with "0x".
+   If x is not a Python :class:`int` object, it has to define an __index__() method
+   that returns an integer. Some examples:
 
       >>> hex(255)
       '0xff'
       >>> hex(-42)
       '-0x2a'
 
-   If x is not a Python :class:`int` object, it has to define an __index__()
-   method that returns an integer.
+   If you want to convert an integer number to uppercase or lowercase hexadecimal
+   string either with prefix or not, you can use either of the following ways.
+
 
-   See also :func:`int` for converting a hexadecimal string to an
-   integer using a base of 16.
+      >>> '%#x' % 255, '%x' % 255, '%X' % 255
+      ('0xff', 'ff', 'FF')
+      >>> format(255, '#x'), format(255, 'x'), format(255, 'X')
+      ('0xff', 'ff', 'FF')
+      >>> f'{255:#x}', f'{255:x}', f'{255:X}'
+      ('0xff', 'ff', 'FF')
+
+   See also :func:`format` for more information.
+
+   See also :func:`int` for converting a hexadecimal string to an integer using a base of 16.
 
    .. note::
 
@@ -878,10 +904,29 @@ are always available.  They are listed here in alphabetical order.
 
 .. function:: oct(x)
 
-   Convert an integer number to an octal string.  The result is a valid Python
-   expression.  If *x* is not a Python :class:`int` object, it has to define an
-   :meth:`__index__` method that returns an integer.
+   Convert an integer number to an octal string prefixed with "0o".  The result is
+   a valid Python expression. If *x* is not a Python :class:`int` object, it has to
+   define an :meth:`__index__` method that returns an integer.
+
+   For example:
+
+      >>> oct(10)
+      '0o12'
+      >>> oct(-56)
+      '-0o70'
+
+   If you want to convert an integer number to octal string either with prefix "0o"
+   or not, you can use either of the following ways.
+
+      >>> num = 10
+      >>> '%#o' % num, '%o' % num
+      ('0o12', '12')
+      >>> format(num, '#o'), format(num, 'o')
+      ('0o12', '12')
+      >>> f'{num:#o}', f'{num:o}'
+      ('0o12', '12')
 
+      See also :func:`format` for more information.
 
    .. index::
       single: file object; open() built-in function