diff options
| author | Ville Skyttä <ville.skytta@iki.fi> | 2017-12-15 12:19:23 +0200 |
|---|---|---|
| committer | Victor Stinner <victor.stinner@gmail.com> | 2017-12-15 11:19:23 +0100 |
| commit | 297fd876aad8ef443d8992618de22c46dbda258b (patch) | |
| tree | dcebeb0ea65ca3afc8d4f4e9ceffdfce14444f0e /Doc/library/codecs.rst | |
| parent | e425bd75177ffb7f098bdb0618b4a5ba3211fe52 (diff) | |
| download | cpython-git-297fd876aad8ef443d8992618de22c46dbda258b.tar.gz | |
bpo-28393: Update encoding lookup docs wrt bpo-27938 (#4871)
Diffstat (limited to 'Doc/library/codecs.rst')
| -rw-r--r-- | Doc/library/codecs.rst | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst index 6e249ecf2b..74b24e10ed 100644 --- a/Doc/library/codecs.rst +++ b/Doc/library/codecs.rst @@ -977,10 +977,14 @@ e.g. ``'utf-8'`` is a valid alias for the ``'utf_8'`` codec. Some common encodings can bypass the codecs lookup machinery to improve performance. These optimization opportunities are only - recognized by CPython for a limited set of aliases: utf-8, utf8, - latin-1, latin1, iso-8859-1, mbcs (Windows only), ascii, utf-16, - and utf-32. Using alternative spellings for these encodings may - result in slower execution. + recognized by CPython for a limited set of (case insensitive) + aliases: utf-8, utf8, latin-1, latin1, iso-8859-1, iso8859-1, mbcs + (Windows only), ascii, us-ascii, utf-16, utf16, utf-32, utf32, and + the same using underscores instead of dashes. Using alternative + aliases for these encodings may result in slower execution. + + .. versionchanged:: 3.6 + Optimization opportunity recognized for us-ascii. Many of the character sets support the same languages. They vary in individual characters (e.g. whether the EURO SIGN is supported or not), and in the |