[issue14957] Improve docs for str.splitlines
New submission from Nick Coghlan <ncoghlan@gmail.com>: The docs for str.splitlines() should explain: 1. That it uses the universal newlines approach to splitting lines 2. That unlike str.split() a trailing empty line is *not* included in the resulting list ---------- assignee: docs@python components: Documentation messages: 161915 nosy: docs@python, ncoghlan priority: normal severity: normal status: open title: Improve docs for str.splitlines versions: Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14957> _______________________________________
Changes by Éric Araujo <merwok@netwok.org>: ---------- keywords: +easy nosy: +eric.araujo stage: -> needs patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14957> _______________________________________
Michael Driscoll <mike@pythonlibrary.org> added the comment: I'm assuming Nick is talking about the stdtypes.rst (in Doc/library) file, correct? If so, I went ahead and created a simple patch that almost uses his verbiage verbatim. ---------- keywords: +patch nosy: +michael.driscoll Added file: http://bugs.python.org/file25791/stdtypes.patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14957> _______________________________________
Roundup Robot <devnull@psf.upfronthosting.co.za> added the comment: New changeset 24572015e24f by R David Murray in branch '3.2': #14957: clarify splitlines docs. http://hg.python.org/cpython/rev/24572015e24f New changeset 2a43088318ed by R David Murray in branch 'default': #14957: clarify splitlines docs. http://hg.python.org/cpython/rev/2a43088318ed New changeset 0df7594e4ebd by R David Murray in branch '2.7': #14957: clarify splitlines docs. http://hg.python.org/cpython/rev/0df7594e4ebd ---------- nosy: +python-dev _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14957> _______________________________________
R. David Murray <rdmurray@bitdance.com> added the comment: Thanks. I added an example, too, since split has some. ---------- nosy: +r.david.murray resolution: -> fixed stage: needs patch -> committed/rejected status: open -> closed type: -> behavior _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14957> _______________________________________
Roundup Robot <devnull@psf.upfronthosting.co.za> added the comment: New changeset 4d9b3a58e208 by R David Murray in branch '3.2': #14957: fix doc typo. http://hg.python.org/cpython/rev/4d9b3a58e208 New changeset 3bb35ad5d9da by R David Murray in branch 'default': #14957: fix doc typo. http://hg.python.org/cpython/rev/3bb35ad5d9da New changeset 48564362b687 by R David Murray in branch '2.7': #14957: fix doc typo. http://hg.python.org/cpython/rev/48564362b687 ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue14957> _______________________________________
participants (5)
-
Michael Driscoll -
Nick Coghlan
-
R. David Murray
-
Roundup Robot
-
Éric Araujo