From c2d48265fa03ea3ac7a6e5984a11b2d619e2c3b3 Mon Sep 17 00:00:00 2001 From: Athos Ribeiro Date: Tue, 4 Oct 2022 21:39:42 -0300 Subject: [PATCH] Add re.VERBOSE flag documentation example (GH-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. (cherry picked from commit 0ceafa7fa408b64377ea31dd5386152da19ef38a) Co-authored-by: Athos Ribeiro --- Doc/library/re.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Doc/library/re.rst b/Doc/library/re.rst index fd12241312211d..e7d1f0560b2ab8 100644 --- a/Doc/library/re.rst +++ b/Doc/library/re.rst @@ -702,7 +702,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.