[Python-checkins] Add re.VERBOSE flag documentation example (#97678)

[JelleZijlstra]

https://github.com/python/cpython/commit/0ceafa7fa408b64377ea31dd5386152da19ef38a
commit: 0ceafa7fa408b64377ea31dd5386152da19ef38a
branch: main
author: Athos Ribeiro <athoscribeiro at gmail.com>
committer: JelleZijlstra <jelle.zijlstra at gmail.com>
date: 2022-10-04T17:39:42-07:00
summary:

Add re.VERBOSE flag documentation example (#97678)

The current re.VERBOSE documentation example leaves space for ambiguous
interpretation. One may read that spaces within the `(?:` token are
spaces inside the non-capturing group (such as `(?: )`). This patch
removes the ambiguity by including examples after the statement.

files:
M Doc/library/re.rst

diff --git a/Doc/library/re.rst b/Doc/library/re.rst
index 1b9a7b63ef5e..5b304f717b07 100644
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -783,7 +783,8 @@ Flags
    more readable by allowing you to visually separate logical sections of the
    pattern and add comments. Whitespace within the pattern is ignored, except
    when in a character class, or when preceded by an unescaped backslash,
-   or within tokens like ``*?``, ``(?:`` or ``(?P<...>``.
+   or within tokens like ``*?``, ``(?:`` or ``(?P<...>``. For example, ``(? :``
+   and ``* ?`` are not allowed.
    When a line contains a ``#`` that is not in a character class and is not
    preceded by an unescaped backslash, all characters from the leftmost such
    ``#`` through the end of the line are ignored.