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 terry.reedy
Recipients barry, docs@python, ezio.melotti, python-dev, r.david.murray, scharron, serhiy.storchaka, terry.reedy, vstinner
Date 2014-08-23.23:12:15
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1408835535.23.0.736048665379.issue22232@psf.upfronthosting.co.za>
In-reply-to
Content
Glossary fixed. I changed the components to Documention as you will handle email elsewhere.

For library references: The key sentence currently used in all entries is "This method uses the universal newlines approach to splitting lines.", where *universal newlines* is linked to the glossary.

2.x has one entry for str and unicode. I propose to add "Unicode.splitlines also splits on '\x0b' ('\v'), '\x0c' ('\f'), '\x1c', '\x1d', '\x1e', '\x85', '\u2028', and '\u2029'." 

3.x bytes entry is good as is.

3.x str entry is wrong. Replace with "This method splits on universal newlines and also on '\x0b' ('\v'), '\x0c' ('\f'), '\x1c', '\x1d', '\x1e', '\x85', '\u2028', and '\u2029'." 

The docstrings now contain about the same as the docs, minus the key line above.
"   Return a list of the lines in S, breaking at line boundaries.
    Line breaks are not included in the resulting list unless keepends
    is given and true."

Between the sentences, I propose to add:
"Boundaries are indicated by 'universal newlines' ('\x0a' ('\n'), '\x0d' ('\r'), and '\x0d\x0a' ('\r\n'))." for bytes,
 with the addition of "and '\x0b' ('\v'), '\x0c' ('\f'), '\x1c', '\x1d', '\x1e', '\x85', '\u2028', and '\u2029'" for unicode.
History
Date User Action Args
2014-08-23 23:12:15terry.reedysetrecipients: + terry.reedy, barry, vstinner, ezio.melotti, r.david.murray, docs@python, python-dev, serhiy.storchaka, scharron
2014-08-23 23:12:15terry.reedysetmessageid: <1408835535.23.0.736048665379.issue22232@psf.upfronthosting.co.za>
2014-08-23 23:12:15terry.reedylinkissue22232 messages
2014-08-23 23:12:15terry.reedycreate