[3.12] Fix Sphinx warnings in re module docs (GH-107044) (#107046)

Fix Sphinx warnings in `re` module docs (GH-107044)
(cherry picked from commit 149748ea4f)

Co-authored-by: wulmer <wulmer@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2023-07-22 08:54:02 -07:00 committed by GitHub
parent c8a0296901
commit 844bdce712
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 18 additions and 6 deletions

View file

@ -501,6 +501,8 @@ The special characters are:
in the ASCII range (``b'\x00'``-``b'\x7f'``). in the ASCII range (``b'\x00'``-``b'\x7f'``).
.. _re-special-sequences:
The special sequences consist of ``'\'`` and a character from the list below. The special sequences consist of ``'\'`` and a character from the list below.
If the ordinary character is not an ASCII digit or an ASCII letter, then the If the ordinary character is not an ASCII digit or an ASCII letter, then the
resulting RE will match the second character. For example, ``\$`` matches the resulting RE will match the second character. For example, ``\$`` matches the
@ -779,6 +781,17 @@ Flags
Corresponds to the inline flag ``(?s)``. Corresponds to the inline flag ``(?s)``.
.. data:: U
UNICODE
In Python 2, this flag made :ref:`special sequences <re-special-sequences>`
include Unicode characters in matches. Since Python 3, Unicode characters
are matched by default.
See :const:`A` for restricting matching on ASCII characters instead.
This flag is only kept for backward compatibility.
.. data:: X .. data:: X
VERBOSE VERBOSE
@ -1520,14 +1533,14 @@ Simulating scanf()
.. index:: single: scanf() .. index:: single: scanf()
Python does not currently have an equivalent to :c:func:`scanf`. Regular Python does not currently have an equivalent to :c:func:`!scanf`. Regular
expressions are generally more powerful, though also more verbose, than expressions are generally more powerful, though also more verbose, than
:c:func:`scanf` format strings. The table below offers some more-or-less :c:func:`!scanf` format strings. The table below offers some more-or-less
equivalent mappings between :c:func:`scanf` format tokens and regular equivalent mappings between :c:func:`!scanf` format tokens and regular
expressions. expressions.
+--------------------------------+---------------------------------------------+ +--------------------------------+---------------------------------------------+
| :c:func:`scanf` Token | Regular Expression | | :c:func:`!scanf` Token | Regular Expression |
+================================+=============================================+ +================================+=============================================+
| ``%c`` | ``.`` | | ``%c`` | ``.`` |
+--------------------------------+---------------------------------------------+ +--------------------------------+---------------------------------------------+
@ -1552,7 +1565,7 @@ To extract the filename and numbers from a string like ::
/usr/sbin/sendmail - 0 errors, 4 warnings /usr/sbin/sendmail - 0 errors, 4 warnings
you would use a :c:func:`scanf` format like :: you would use a :c:func:`!scanf` format like ::
%s - %d errors, %d warnings %s - %d errors, %d warnings

View file

@ -188,7 +188,6 @@ Doc/library/pyclbr.rst
Doc/library/pydoc.rst Doc/library/pydoc.rst
Doc/library/pyexpat.rst Doc/library/pyexpat.rst
Doc/library/random.rst Doc/library/random.rst
Doc/library/re.rst
Doc/library/readline.rst Doc/library/readline.rst
Doc/library/reprlib.rst Doc/library/reprlib.rst
Doc/library/resource.rst Doc/library/resource.rst