diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst
index b231fa568cf342..efe211cd2db6c8 100644
--- a/Doc/library/codecs.rst
+++ b/Doc/library/codecs.rst
@@ -1484,6 +1484,66 @@ mapping. It is not supported by :meth:`str.encode` (which only produces
Restoration of the ``rot13`` alias.
+:mod:`encodings` --- Encodings package
+--------------------------------------
+
+.. module:: encodings
+ :synopsis: Encodings package
+
+This module implements the following functions:
+
+.. function:: normalize_encoding(encoding)
+
+ Normalize encoding name *encoding*.
+
+ Normalization works as follows: all non-alphanumeric characters except the
+ dot used for Python package names are collapsed and replaced with a single
+ underscore, leading and trailing underscores are removed.
+ For example, ``' -;#'`` becomes ``'_'``.
+
+ Note that *encoding* should be ASCII only.
+
+
+.. note::
+ The following functions should not be used directly, except for testing
+ purposes; :func:`codecs.lookup` should be used instead.
+
+
+.. function:: search_function(encoding)
+
+ Search for the codec module corresponding to the given encoding name
+ *encoding*.
+
+ This function first normalizes the *encoding* using
+ :func:`normalize_encoding`, then looks for a corresponding alias.
+ It attempts to import a codec module from the encodings package using either
+ the alias or the normalized name. If the module is found and defines a valid
+ ``getregentry()`` function that returns a :class:`codecs.CodecInfo` object,
+ the codec is cached and returned.
+
+ If the codec module defines a ``getaliases()`` function any returned aliases
+ are registered for future use.
+
+
+.. function:: win32_code_page_search_function(encoding)
+
+ Search for a Windows code page encoding *encoding* of the form ``cpXXXX``.
+
+ If the code page is valid and supported, return a :class:`codecs.CodecInfo`
+ object for it.
+
+ .. availability:: Windows.
+
+ .. versionadded:: 3.14
+
+
+This module implements the following exception:
+
+.. exception:: CodecRegistryError
+
+ Raised when a codec is invalid or incompatible.
+
+
:mod:`encodings.idna` --- Internationalized Domain Names in Applications
------------------------------------------------------------------------
diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst
index 7fd9e6ac66e6c8..40d4a27bff9fee 100644
--- a/Doc/whatsnew/3.9.rst
+++ b/Doc/whatsnew/3.9.rst
@@ -1139,7 +1139,7 @@ Changes in the Python API
(Contributed by Christian Heimes in :issue:`36384`).
* :func:`codecs.lookup` now normalizes the encoding name the same way as
- :func:`!encodings.normalize_encoding`, except that :func:`codecs.lookup` also
+ :func:`encodings.normalize_encoding`, except that :func:`codecs.lookup` also
converts the name to lower case. For example, ``"latex+latin1"`` encoding
name is now normalized to ``"latex_latin1"``.
(Contributed by Jordon Xu in :issue:`37751`.)
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy