[docs] [issue12855] linebreak sequences should be better documented
report at bugs.python.org
Tue Aug 30 16:46:46 CEST 2011
Matthew Boehm <boehm.matthew at gmail.com> added the comment:
I can fix the patch to list all the unicode line boundaries. The three places I've considered putting it are:
1. On the howto/unicode.html
2. Somewhere in the stdtypes.html#typesseq description (maybe with other notes at the bottom)
3. As a note to the stdtypes.html#str.splitlines method description (where it is in the previous patch.)
I can move it to any of these places if you think it's a better fit. I'll fix the list so that it's complete, add a note about \x0b and \x0c being added in 2.7/3.2, and possibly reference it from StreamReader.readline.
After confirming that my documentation matches the style guide, I'll make the docs, test the output, and upload a patch. I can do this for 2.7, 3.2 and 3.3 separately.
Let me know if that sounds good and if you have any further thoughts. I should be able to upload new patches in 10 hours (after work today).
Python tracker <report at bugs.python.org>
More information about the docs