Rewrite re.VERBOSE section.

It now has slightly better rationale and a less awkward wording in the
explanation.

Inspired by a report of a neither/or conflict by 'animalize' on docs@.
This commit is contained in:
Zachary Ware 2015-11-11 23:32:14 -06:00
parent c54b8ceb91
commit 77d61d4156
1 changed files with 8 additions and 6 deletions

View File

@ -514,13 +514,15 @@ form.
.. data:: X .. data:: X
VERBOSE VERBOSE
This flag allows you to write regular expressions that look nicer. Whitespace This flag allows you to write regular expressions that look nicer and are
within the pattern is ignored, except when in a character class or preceded by more readable by allowing you to visually separate logical sections of the
an unescaped backslash, and, when a line contains a ``'#'`` neither in a pattern and add comments. Whitespace within the pattern is ignored, except
character class or preceded by an unescaped backslash, all characters from the when in a character class or when preceded by an unescaped backslash.
leftmost such ``'#'`` through the end of the line are ignored. 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.
That means that the two following regular expression objects that match a This means that the two following regular expression objects that match a
decimal number are functionally equal:: decimal number are functionally equal::
a = re.compile(r"""\d + # the integral part a = re.compile(r"""\d + # the integral part