New submission from Facundo Batista <facu...@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@python
components: Documentation
messages: 367219
nosy: docs@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 <rep...@bugs.python.org>
<https://bugs.python.org/issue40382>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to