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

(cherry picked from commit b0b44b4b3337297007f5ef87220a75df204399f8)

diff --git a/Doc/library/re.rst b/Doc/library/re.rst
index a4fe6d507072e080b83bcabf1b52253459f0ce13..30a01eba3cc0bea8870ef40f1147fff27ccc7e2c 100644 (file)
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -610,7 +610,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.