This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author terry.reedy
Recipients cool-RR, docs@python, mrabarnett, serhiy.storchaka, terry.reedy
Date 2020-03-21.23:49:18
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1584834558.64.0.230648180515.issue40016@roundup.psfhosted.org>
In-reply-to
Content
The docstring line in question is
  (?aiLmsux) Set the A, I, L, M, S, U, or X flag for the RE (see below).

This is exceptional in that other syntaxes in the special characters list use lower case only for syntax variables (m, n, name, id/name, yes, no).  Here, each letter is a separate and literal special character.  (Also exceptional is that the syntax given is illegal, as 'a', 'L', and 'u' are mutually exclusive.)

The corresponding doc entry starts
"(One or more letters from the set 'a', 'i', 'L', 'm', 's', 'u', 'x'.)
... the letters set the corresponding flags:" followed by 6 more lines.

I suggest the following as the replacement here (followed by more 'below').
  (?aiLmsux) The letters set the corresponding flags defined below.

I think 'letters' pretty clearly refers to 'a', 'i', ..., and 'x' as given, and that each 'corresponds' to and sets a flag that is a separate entity.

The more complicated inline flags syntax, "(?aiLmsux-imsx:...)", is omitted from the docstring.  Perhaps this is intentional.

The flag constants are currently introduced by
Some of the functions in this module takes flags as optional parameters:

My suggested more accurate and expanded replacement:
"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."
History
Date User Action Args
2020-03-21 23:49:18terry.reedysetrecipients: + terry.reedy, mrabarnett, cool-RR, docs@python, serhiy.storchaka
2020-03-21 23:49:18terry.reedysetmessageid: <1584834558.64.0.230648180515.issue40016@roundup.psfhosted.org>
2020-03-21 23:49:18terry.reedylinkissue40016 messages
2020-03-21 23:49:18terry.reedycreate