[issue20722] newline is (partially) independent of universal newlines; needs to be made more clear in docs

Change by Cheryl Sabella : -- stage: -> needs patch type: -> enhancement versions: +Python 3.8 -Python 3.4 ___ Python tracker ___

[issue20722] newline is (partially) independent of universal newlines; needs to be made more clear in docs

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

[issue20722] newline is (partially) independent of universal newlines; needs to be made more clear in docs

Thomas Wouters added the comment: Additionally, the deprecation notice for 'U' in the table of modules should mention that the 'U' mode, not universal newlines, is deprecated because it is unnecessary. Or 'controlled by the newline argument' perhaps. -- nosy: +twouters