Mailman 3 [issue31714] Improve re documentation - docs

newer
[issue31757] Tutorial: Fibonacci...

[issue31714] Improve re documentation

Serhiy Storchaka

6 Oct 2017 6 Oct '17

7:52 p.m.

New submission from Serhiy Storchaka : The proposed PR improves the documentation of re module and Regular Expression HOWTO. * Clarify the effect of the LOCALE flag. * Remove outdated statements. * Add an example of escaping a replacement string. * Add or correct some references. * Improve and fix a formatting. ---------- assignee: docs@python components: Documentation, Regular Expressions messages: 303822 nosy: akuchling, barry, docs@python, ezio.melotti, mrabarnett, serhiy.storchaka priority: normal severity: normal stage: patch review status: open title: Improve re documentation type: enhancement versions: Python 3.6, Python 3.7 _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

Show replies by date

Serhiy Storchaka

6 Oct 6 Oct

7:54 p.m.

Change by Serhiy Storchaka : ---------- keywords: +patch pull_requests: +3878 _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

Serhiy Storchaka

8:35 p.m.

Change by Serhiy Storchaka : ---------- nosy: +gregory.p.smith _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

Henk-Jaap Wagenaar

8:41 p.m.

Henk-Jaap Wagenaar added the comment: I was looking at your changes and got myself in a muddle. What is you rational for when you use ``[character or string]`` versus ``'[character or string]``? You seem to be creating consistency there, but I cannot quite see the rules you are aiming for! ---------- nosy: +Henk-Jaap Wagenaar _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

Ezio Melotti

8:49 p.m.

Ezio Melotti added the comment: ISTM that ``x`` is used when x is a regex or regex metachar, whereas ``'x'`` is used when 'x' is a string. I find this distinction reasonable. ---------- _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

Serhiy Storchaka

9:10 p.m.

Serhiy Storchaka added the comment: It is explained in the documentation: """ (In the rest of this section, we'll write RE's in ``this special style``, usually without quotes, and strings to be matched ``'in single quotes'``.) """ ---------- _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

Brian Ward

9:30 p.m.

Brian Ward added the comment: In re.rst, the instances of "Correcsponds the" should be "Corresponds to the" and "Doesn't have correcsponding inline flag" should be "No corresponding inline flag." ---------- nosy: +Brian Ward _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

Serhiy Storchaka

14 Oct 14 Oct

1:44 p.m.

Serhiy Storchaka added the comment: New changeset cd195e2a7ac5c9b2574d5462752b7939641de4a9 by Serhiy Storchaka in branch 'master': bpo-31714: Improved regular expression documentation. (#3907) https://github.com/python/cpython/commit/cd195e2a7ac5c9b2574d5462752b7939641... ---------- _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

Serhiy Storchaka

2:12 p.m.

Change by Serhiy Storchaka : ---------- pull_requests: +3970 _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

Serhiy Storchaka

2:47 p.m.

Serhiy Storchaka added the comment: New changeset 69ed5b61e7d2bdaf2dc6684061f737adc24a96ae by Serhiy Storchaka in branch '3.6': [3.6] bpo-31714: Improved regular expression documentation. (GH-3907). (#3994) https://github.com/python/cpython/commit/69ed5b61e7d2bdaf2dc6684061f737adc24... ---------- _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

Serhiy Storchaka

2:56 p.m.

Change by Serhiy Storchaka : ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker https://bugs.python.org/issue31714 _______________________________________

2385

Age (days ago)

2393

Last active (days ago)

List overview

Download

10 comments

4 participants

participants (4)

Brian Ward
Ezio Melotti
Henk-Jaap Wagenaar
Serhiy Storchaka

[issue31714] Improve re documentation

tags

participants (4)