diff options
| author | Victor Stinner <victor.stinner@gmail.com> | 2017-12-13 12:29:09 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2017-12-13 12:29:09 +0100 |
| commit | 91106cd9ff2f321c0f60fbaa09fd46c80aa5c266 (patch) | |
| tree | ff002e0532736a97f3ddd367c1491e7b04611816 /Doc/using | |
| parent | c3e070f84931c847d1b35e7fb36aa71edd6215f6 (diff) | |
| download | cpython-git-91106cd9ff2f321c0f60fbaa09fd46c80aa5c266.tar.gz | |
bpo-29240: PEP 540: Add a new UTF-8 Mode (#855)
* Add -X utf8 command line option, PYTHONUTF8 environment variable
and a new sys.flags.utf8_mode flag.
* If the LC_CTYPE locale is "C" at startup: enable automatically the
UTF-8 mode.
* Add _winapi.GetACP(). encodings._alias_mbcs() now calls
_winapi.GetACP() to get the ANSI code page
* locale.getpreferredencoding() now returns 'UTF-8' in the UTF-8
mode. As a side effect, open() now uses the UTF-8 encoding by
default in this mode.
* Py_DecodeLocale() and Py_EncodeLocale() now use the UTF-8 encoding
in the UTF-8 Mode.
* Update subprocess._args_from_interpreter_flags() to handle -X utf8
* Skip some tests relying on the current locale if the UTF-8 mode is
enabled.
* Add test_utf8mode.py.
* _Py_DecodeUTF8_surrogateescape() gets a new optional parameter to
return also the length (number of wide characters).
* pymain_get_global_config() and pymain_set_global_config() now
always copy flag values, rather than only copying if the new value
is greater than the old value.
Diffstat (limited to 'Doc/using')
| -rw-r--r-- | Doc/using/cmdline.rst | 13 |
1 files changed, 12 insertions, 1 deletions
diff --git a/Doc/using/cmdline.rst b/Doc/using/cmdline.rst index e32f77e7ff..5cb9071770 100644 --- a/Doc/using/cmdline.rst +++ b/Doc/using/cmdline.rst @@ -439,6 +439,9 @@ Miscellaneous options * Set the :attr:`~sys.flags.dev_mode` attribute of :attr:`sys.flags` to ``True`` + * ``-X utf8`` enables the UTF-8 mode, whereas ``-X utf8=0`` disables the + UTF-8 mode. + It also allows passing arbitrary values and retrieving them through the :data:`sys._xoptions` dictionary. @@ -455,7 +458,7 @@ Miscellaneous options The ``-X showalloccount`` option. .. versionadded:: 3.7 - The ``-X importtime`` and ``-X dev`` options. + The ``-X importtime``, ``-X dev`` and ``-X utf8`` options. Options you shouldn't use @@ -816,6 +819,14 @@ conflict. .. versionadded:: 3.7 +.. envvar:: PYTHONUTF8 + + If set to ``1``, enable the UTF-8 mode. If set to ``0``, disable the UTF-8 + mode. Any other non-empty string cause an error. + + .. versionadded:: 3.7 + + Debug-mode variables ~~~~~~~~~~~~~~~~~~~~ |