New submission from Devin Jeanpierre:

http://docs.python.org/3.4/library/functions.html#open says "newline controls 
how universal newlines mode works (it only applies to text mode)."

My reading of this when I saw it was that newline= doesn't do anything unless 
universal newlines mode is enabled. This is untrue, and you can infer it's 
untrue from the following lines, but then the docs appear to contradict 
themselves. Please fix to say something more along the lines of "newline 
controls how newlines are read and written. It only applies to text mode."

The interactions with universal newlines mode are explained in the following 
text, so they don't need to be called out upfront. newline does more than just 
that.

----------
assignee: docs@python
components: Documentation
messages: 211854
nosy: Devin Jeanpierre, docs@python
priority: normal
severity: normal
status: open
title: newline is (partially) independent of universal newlines; needs to be 
made more clear in docs
versions: Python 3.4

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue20722>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to