I was reading the re documentation recently, and I noticed that the information around the Unicode, ASCII, and Locale flags and how matching is affected was unclear in parts and inconsistent within the documentation. This provides an opportunity to review that documentation and be more explicit.

I plan to use more admonitions, bring lists of flags into bullets, ensure consistency when referring to str or bytes patterns, and be more explicit about flags that are discouraged or redundant.

A

Linked PRs

• GH-107678: Improve Unicode handling clarity in library/re.rst #107679
• [3.12] GH-107678: Improve Unicode handling clarity in library/re.rst (GH-107679) #113965
• [3.11] GH-107678: Improve Unicode handling clarity in library/re.rst (GH-107679) #113966