bpo-15606: Improve the re.VERBOSE documentation. (#4366)

diff --git a/Doc/library/re.rst b/Doc/library/re.rst
index e0cb626305d893eeb0d6698a5e896d616b87ddd5..cbb2f439d15391020c9dd238aa48cd78a5a3cb85 100644 (file)
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -617,7 +617,8 @@ form.
    This flag allows you to write regular expressions that look nicer and are
    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.
+   when in a character class, or when preceded by an unescaped backslash,
+   or within tokens like ``*?``, ``(?:`` or ``(?P<...>``.
    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.