https://github.com/python/cpython/commit/ce21b1a25085b61d7aa572208adce929f6569363 commit: ce21b1a25085b61d7aa572208adce929f6569363 branch: 3.13 author: Miss Islington (bot) <[email protected]> committer: malemburg <[email protected]> date: 2025-07-13T13:19:28Z summary:
[3.13] gh-42237: Link to complete list of codec aliases (GH-136625) (#136627) gh-42237: Link to complete list of codec aliases (GH-136625) Closes GH-42237 (cherry picked from commit a93d9aaf62bb2565e9eec00a2a8d06a91305127b) Co-authored-by: Stan Ulbrych <[email protected]> files: M Doc/library/codecs.rst diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst index ec0644279e738d..21c6409ece44c9 100644 --- a/Doc/library/codecs.rst +++ b/Doc/library/codecs.rst @@ -1061,8 +1061,15 @@ or with dictionaries as mapping tables. The following table lists the codecs by name, together with a few common aliases, and the languages for which the encoding is likely used. Neither the list of aliases nor the list of languages is meant to be exhaustive. Notice that spelling alternatives that only differ in -case or use a hyphen instead of an underscore are also valid aliases; therefore, -e.g. ``'utf-8'`` is a valid alias for the ``'utf_8'`` codec. +case or use a hyphen instead of an underscore are also valid aliases +because they are equivalent when normalized by +:func:`~encodings.normalize_encoding`. For example, ``'utf-8'`` is a valid +alias for the ``'utf_8'`` codec. + +.. note:: + + The below table lists the most common aliases, for a complete list + refer to the source :source:`aliases.py <Lib/encodings/aliases.py>` file. .. impl-detail:: _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
