[docs] [issue12855] linebreak sequences should be better documented

Matthew Boehm 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>
<http://bugs.python.org/issue12855>
_______________________________________


More information about the docs mailing list