Georg Brandl added the comment: Your points 1-5 all sound valid to me. Would you like to do make a patch? I don't know what to do about the release number. Probably doesn't hurt anyone to keep it. ---------- nosy: +georg.brandl _______________________________________ Python tracker http://bugs.python.org/issue10875 _______________________________________

Georg Brandl added the comment: Oh right, I misread that one. Can't Windows help users right-click and select "Copy URL"? ---------- _______________________________________ Python tracker http://bugs.python.org/issue10875 _______________________________________

SilentGhost added the comment: A few bits and pieces fixed compared to the previous patch.

...

...

doctest.testfile("/home/mischa/pydev/Doc/howto/regex.rst", module_relative = False, optionflags=doctest.ELLIPSIS) TestResults(failed=0, attempted=98)

---------- Added file: http://bugs.python.org/file20331/regex.rst.diff _______________________________________ Python tracker http://bugs.python.org/issue10875 _______________________________________

SilentGhost added the comment: It seems that the special sequences description in Matching Characters section need to be updated to incorporate information on unicode and bytes. I don't think, however, that it's a good idea just to copy that information from the Doc/library/re.rst May be the section could be shortened and linked to that RE Syntax section? there aren't any deeper links available unfortunately. ---------- _______________________________________ Python tracker http://bugs.python.org/issue10875 _______________________________________

SilentGhost added the comment: I don't know whether it would be easy to strip down py3k version to 2.7 version. Seeing how it's just a basic introduction, I would think that a single statement re unicode support might be sufficient. For exhaustive description of special sequences refer the docs and carry on with ascii strings. Attached patch fixes path issue. ---------- Added file: http://bugs.python.org/file20332/regex.rst.diff _______________________________________ Python tracker http://bugs.python.org/issue10875 _______________________________________

Terry J. Reedy added the comment: Since I think I know how to do it, easily, I will try to derive the 2.7 patch. In Matching Characters, I think "The following predefined special sequences are available:" should be expanded to "The following predefined special sequences are a subset of those available. The equivalent classes are for bytes patterns. For a complete list of sequences and expanded class definitions for Unicode string patterns, see the end of Regular Expression Syntax." (with section reference markup). Note to myself. /bytes/byte string/ for 2.7. While the changes all look innocuous to me with respect to building the docs, I am curious if you have tried to rebuild the HOWTO (if you have the tool chain, which I do not). ---------- _______________________________________ Python tracker http://bugs.python.org/issue10875 _______________________________________

SilentGhost added the comment:

While the changes all look innocuous to me with respect to building the docs, I am curious if you have tried to rebuild the HOWTO (if you have the tool chain, which I do not).

I did rebuild the docs with 'make html'. Build was clean every time. If you meant something else please let me know. ---------- _______________________________________ Python tracker http://bugs.python.org/issue10875 _______________________________________

Éric Araujo added the comment: Looks good, builds without warnings. Note that you can use :ref:`re-syntax` and Sphinx will substitute the heading for you. The :role:`some special text <real-target>` form is used when you want to control the text of the link. (That thing is called an hyperlink target: http://docutils.sourceforge.net/docs/user/rst/quickref.html#hyperlink-target...) ---------- _______________________________________ Python tracker http://bugs.python.org/issue10875 _______________________________________

Terry J. Reedy added the comment: and r87918 for 2.7, with bytes -> byte string ---------- _______________________________________ Python tracker http://bugs.python.org/issue10875 _______________________________________

Terry J. Reedy added the comment: Correction: r87912 and r87913 for 3.x ---------- _______________________________________ Python tracker http://bugs.python.org/issue10875 _______________________________________