From 89a2209ae6fc5f39868621799730e16f931eb497 Mon Sep 17 00:00:00 2001 From: Ram Rachum Date: Wed, 25 Mar 2020 20:44:47 +0200 Subject: bpo-40016: re docstring: Clarify relationship of inline and argument flags (#19078) Co-authored-by: Terry Jan Reedy --- Lib/re.py | 6 ++++-- Misc/NEWS.d/next/Library/2020-03-19-19-40-27.bpo-40016.JWtxqJ.rst | 1 + 2 files changed, 5 insertions(+), 2 deletions(-) create mode 100644 Misc/NEWS.d/next/Library/2020-03-19-19-40-27.bpo-40016.JWtxqJ.rst diff --git a/Lib/re.py b/Lib/re.py index 8f1d55d..bfb7b1c 100644 --- a/Lib/re.py +++ b/Lib/re.py @@ -44,7 +44,7 @@ The special characters are: "|" A|B, creates an RE that will match either A or B. (...) Matches the RE inside the parentheses. The contents can be retrieved or matched later in the string. - (?aiLmsux) Set the A, I, L, M, S, U, or X flag for the RE (see below). + (?aiLmsux) The letters set the corresponding flags defined below. (?:...) Non-grouping version of regular parentheses. (?P...) The substring matched by the group is accessible by name. (?P=name) Matches the text matched earlier by the group named name. @@ -97,7 +97,9 @@ This module exports the following functions: purge Clear the regular expression cache. escape Backslash all non-alphanumerics in a string. -Some of the functions in this module takes flags as optional parameters: +Each function other than purge and escape can take an optional 'flags' argument +consisting of one or more of the following module constants, joined by "|". +A, L, and U are mutually exclusive. A ASCII For string patterns, make \w, \W, \b, \B, \d, \D match the corresponding ASCII character categories (rather than the whole Unicode categories, which is the diff --git a/Misc/NEWS.d/next/Library/2020-03-19-19-40-27.bpo-40016.JWtxqJ.rst b/Misc/NEWS.d/next/Library/2020-03-19-19-40-27.bpo-40016.JWtxqJ.rst new file mode 100644 index 0000000..0c6449d --- /dev/null +++ b/Misc/NEWS.d/next/Library/2020-03-19-19-40-27.bpo-40016.JWtxqJ.rst @@ -0,0 +1 @@ +In re docstring, clarify the relationship between inline and argument compile flags. \ No newline at end of file -- cgit v0.12