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.20:26:13
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1584822373.26.0.861406132036.issue40016@roundup.psfhosted.org>
In-reply-to
Content
The root confusion is that re compilation has several variations with two sets of indicators, each with an unhelpful exception, and each combined and used in different ways.

1. Module constants with uppercase English words or word pairs, also abbreviated by uppercase letters that are the first letter of the word -- except for S-DOTALL and X-VERBOSE.  As arguments for the flags parameter of functions other than escape and purge, they are combined with '|'.

2. Syntax letters within '(?...)', itself within an regex string, that are the single letter module constants lowercased b -- except that L is not lowercased because some fonts make l and 1 look nearly the same or even identical.  Multiple syntax letters are combined by concatenation.

The additional issue for docstrings is the extreme compression, including the omission (here) of 're.' prefixes.  They are intended as reminders for those who have read and understood the full doc, but we try to make them as clear as possible.  I am working on an alternate revision.
History
Date User Action Args
2020-03-21 20:26:13terry.reedysetrecipients: + terry.reedy, mrabarnett, cool-RR, docs@python, serhiy.storchaka
2020-03-21 20:26:13terry.reedysetmessageid: <1584822373.26.0.861406132036.issue40016@roundup.psfhosted.org>
2020-03-21 20:26:13terry.reedylinkissue40016 messages
2020-03-21 20:26:13terry.reedycreate