Skip to content

Outdated os.linesep docs in os.py #136087

Closed
Closed
@sobolevn

Description

@sobolevn

- os.linesep is the line separator in text files ('\r' or '\n' or '\r\n')

Docs claim that \r is a possible value for os.linesep, however, I can't find any code that actually sets it to \r.

But it can only be:

Docs:

.. data:: linesep

   The string used to separate (or, rather, terminate) lines on the current
   platform.  This may be a single character, such as ``'\n'`` for POSIX, or
   multiple characters, for example, ``'\r\n'`` for Windows. Do not use
   *os.linesep* as a line terminator when writing files opened in text mode (the
   default); use a single ``'\n'`` instead, on all platforms.

The internet says:

Windows: '\r\n'
Mac (OS 9-): '\r'
Mac (OS 10+): '\n'
Unix/Linux: '\n'

So, it looks like an outdated doc?

Linked PRs

Metadata

Metadata

Assignees

Labels

docsDocumentation in the Doc dirstdlibPython modules in the Lib dirtype-bugAn unexpected behavior, bug, or error

Projects

Status

Todo

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions