This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author vstinner
Recipients Matthew.Boehm, docs@python, vstinner
Date 2011-08-30.08:22:53
SpamBayes Score 4.0248e-05
Marked as misclassified No
Message-id <1314692574.67.0.567076643261.issue12855@psf.upfronthosting.co.za>
In-reply-to
Content
> Would it be better to put this note in a different place?

You may just say that StreamReader.readline() uses unicode.splitlines(), and so point to unicode.splitlines() doc (use :meth:`unicode.splitlines` syntax). unicode.splitlines() is now well documented: line boundaries are not listed, even in Python 3 documentation.

Unicode line boundaries used by Python 2.7 and 3.3:

U+000A: Line feed
U+000B: Line tabulation
U+000C: Form feed
U+000D: Carriage return
U+001C: File separator
U+001D: Group separator
U+001E: Record separator
U+0085: "control"
U+2028: Line separator
U+2029: Paragraph separator

> It looks like \x0b and \x0c (vertical tab and form feed) were first
> considered line breaks in Python 2.7

Correct: U+000B and U+000C were added to Python 2.7 and 3.2.

> It might be worth putting a "changed in 2.7" note somewhere in the docs

We add the following syntax exactly for this:

   .. versionchanged:: 2.6
      Also unset environment variables when calling :meth:`os.environ.clear`
      and :meth:`os.environ.pop`.

If you downloaded Python source code, go into Doc/ directory and run "make html" to compile the doc to HTML.

http://docs.python.org/devguide/setup.html
http://docs.python.org/devguide/docquality.html
History
Date User Action Args
2011-08-30 08:22:54vstinnersetrecipients: + vstinner, docs@python, Matthew.Boehm
2011-08-30 08:22:54vstinnersetmessageid: <1314692574.67.0.567076643261.issue12855@psf.upfronthosting.co.za>
2011-08-30 08:22:54vstinnerlinkissue12855 messages
2011-08-30 08:22:53vstinnercreate