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 r.david.murray
Recipients chris.jerdonek, docs@python, jcea, ncoghlan, pitrou, r.david.murray
Date 2012-08-04.22:13:54
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1344118435.76.0.441695334299.issue15554@psf.upfronthosting.co.za>
In-reply-to
Content
Sigh. ;)

At this point in my Python programming I intuitively understand what splitlines does, but every time we try to explain it in detail it gets messier and messier.  I wasn't really happy with the addition of that sentence about split in the first place.

I don't understand what your splitlines examples are trying to say, they all look clear to me based on the fact that we are splitting *lines*.  

I don't find your proposed language in the patch to be clearer.  The existing sentence describes the concrete behavior, while your version is sort-of describing (ascribing?) some syntax to the line separators ("does not delimit").  The problem is that there *is* a syntax here, that of universal-newline-delimited-text, but that is too big a topic to explain in the splitlines doc.  There's another issue for creating a central description of universal-newline parsing, perhaps this entry could link to that discussion (and that discussion could perhaps mention splitlines).

The split behavior without a specified separator might actually be a bug (if so, it is not a fixable one), but in any case you are right that that clarification should be added if the existing sentence is kept.
History
Date User Action Args
2012-08-04 22:13:55r.david.murraysetrecipients: + r.david.murray, jcea, ncoghlan, pitrou, chris.jerdonek, docs@python
2012-08-04 22:13:55r.david.murraysetmessageid: <1344118435.76.0.441695334299.issue15554@psf.upfronthosting.co.za>
2012-08-04 22:13:55r.david.murraylinkissue15554 messages
2012-08-04 22:13:54r.david.murraycreate