Outdated os.linesep docs in os.py

Line 13 in 5334732

- 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:

cpython/Lib/os.py

Lines 52 to 54 in 5334732

if 'posix' in _names:

name = 'posix'

linesep = '\n'

for POSIX
cpython/Lib/os.py

Lines 76 to 78 in 5334732

elif 'nt' in _names:

name = 'nt'

linesep = '\r\n'

on Windows

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

pythongh-136087: Remove `\r` from documented `os.linesep` values

gh-136087: Remove `\r` from documented `os.linesep` values (#136088)

pythongh-136087: Remove `\r` from documented `os.linesep` values (pyt…

[3.14] gh-136087: Remove `\r` from documented `os.linesep` values (GH…

[3.13] gh-136087: Remove `\r` from documented `os.linesep` values (GH…

pythongh-136087: Remove `\r` from documented `os.linesep` values (pyt…

Navigation Menu

Repository navigation

Outdated `os.linesep` docs in `os.py` #136087

Linked PRs

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

	if 'posix' in _names:
	name = 'posix'
	linesep = '\n'

	elif 'nt' in _names:
	name = 'nt'
	linesep = '\r\n'

Outdated os.linesep docs in os.py #136087

Description

Linked PRs

Activity

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions

Outdated `os.linesep` docs in `os.py` #136087