mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-01 12:52:18 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

[3.11] Fix Sphinx warnings in re module docs (GH-107044). (#107055)

Browse source 
(cherry picked from commit 149748ea4f)
This commit is contained in:
wulmer 2023-07-22 18:39:46 +02:00 • committed by GitHub
parent c332117b52
commit b71144193b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 18 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

23
Doc/library/re.rst
View file

@ -500,6 +500,8 @@ The special characters are:
(``b'\x00'``-``b'\x7f'``) in :class:`bytes` replacement strings. (``b'\x00'``-``b'\x7f'``) in :class:`bytes` replacement strings.
.. _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
@ -778,6 +780,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
@ -1518,14 +1531,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`` | ``.`` |
+--------------------------------+---------------------------------------------+ +--------------------------------+---------------------------------------------+
@ -1550,7 +1563,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