[New-bugs-announce] [issue40382] Make 'rt' the default for open in docs

[Facundo Batista]

New submission from Facundo Batista <facundo at taniquetil.com.ar>:

This is mostly a confusion about 'r' being a synonym of 'rt', while it's more explicit if we consider 'r' as one default, and 't' as other (as other parts of the documentation do).

Doing `help(open)` we get:

    mode is an optional string that specifies the mode in which the file
    is opened. It defaults to 'r' which means open for reading in text
    mode. 

Later in the same text it's stated:

    The default mode is 'rt' (open for reading text).

Which reflects the wording I want to have, but is confusing that initially it said a different thing.

If we get the html docs, it says "The default mode is 'r' (open for reading text, synonym of 'rt')."
    
Why not just stating that the default mode is 'rt'?

----------
assignee: docs at python
components: Documentation
messages: 367219
nosy: docs at python, facundobatista
priority: normal
severity: normal
stage: needs patch
status: open
title: Make 'rt' the default for open in docs
type: enhancement
versions: Python 3.9

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue40382>
_______________________________________