mirror of
https://github.com/python/cpython.git
synced 2025-10-01 12:52:18 +00:00
[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:
parent
c8a0296901
commit
844bdce712
2 changed files with 18 additions and 6 deletions
|
@ -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
|
||||||
|
|
||||||
|
|
|
@ -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
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue