[issue46143] [docs] IO > Text Encoding info outdated

[Eryk Sun]

Eryk Sun  added the comment:

The rare circumstance in which UTF-8 mode gets enabled automatically is 
described in the following paragraph [1]:

If the PYTHONUTF8 environment variable is not set at all, then the
interpreter defaults to using the current locale settings, unless the
current locale is identified as a legacy ASCII-based locale (as
described for PYTHONCOERCECLOCALE), and locale coercion is either 
disabled or fails. In such legacy locales, the interpreter will
default to enabling UTF-8 mode unless explicitly instructed not to do
so.

Note that UTF-8 mode is never enabled automatically in Windows. In contrast to 
POSIX, the locale encoding in Windows is unrelated to the current LC_CTYPE 
locale. Instead, the locale encoding gets set to the process code page, which 
is based on the system locale by default and never changes while a process is 
running. The system locale may be incompatible with the current LC_CTYPE 
locale, Windows user locale, and preferred UI language (e.g. for text resources 
such as error messages), so try to explicitly use UTF-8 for text files whenever 
possible.

---
[1] https://docs.python.org/3/library/os.html#utf8-mode

--
nosy: +eryksun

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46143] [docs] IO > Text Encoding info outdated

[Inada Naoki]

Inada Naoki  added the comment:

UTF-8 mode is not enabled by default. So locale encoding is still the default 
encoding.

--
nosy: +methane

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue46143] [docs] IO > Text Encoding info outdated

[David Gilbertson]

New submission from David Gilbertson :

On this page: https://docs.python.org/3/library/io.html#text-encoding it says 
"there is no concrete plan as of yet, Python may change the default text file 
encoding to UTF-8 in the future".

On this page https://docs.python.org/3/library/os.html#utf8-mode is says that 
from 3.7 onwards UTF-8 will be selected by default.

Does that mean that the text in the first section is now outdated, as it was 
addressed by PEP 540?

I'm a newbie, so apologies if I'm missing something obvious or filing this in 
the wrong spot.

--
assignee: docs@python
components: Documentation
messages: 408983
nosy: docs@python, gilbertson.david
priority: normal
severity: normal
status: open
title: [docs] IO > Text Encoding info outdated
type: behavior
versions: Python 3.10

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com