[Python-checkins] bpo-37751: Update `codecs.register()` doc. (GH-25643)
methane
webhook-mailer at python.org
Tue Apr 27 20:37:09 EDT 2021
https://github.com/python/cpython/commit/5c84bb506aaca01f5f750116d8f7a41d41f8124d
commit: 5c84bb506aaca01f5f750116d8f7a41d41f8124d
branch: master
author: Inada Naoki <songofacandy at gmail.com>
committer: methane <songofacandy at gmail.com>
date: 2021-04-28T09:37:02+09:00
summary:
bpo-37751: Update `codecs.register()` doc. (GH-25643)
files:
M Doc/library/codecs.rst
diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst
index b15d293e38f63..0dcd88f9fd5b7 100644
--- a/Doc/library/codecs.rst
+++ b/Doc/library/codecs.rst
@@ -159,9 +159,13 @@ function:
.. function:: register(search_function)
Register a codec search function. Search functions are expected to take one
- argument, being the encoding name in all lower case letters, and return a
- :class:`CodecInfo` object. In case a search function cannot find
- a given encoding, it should return ``None``.
+ argument, being the encoding name in all lower case letters with hyphens
+ and spaces converted to underscores, and return a :class:`CodecInfo` object.
+ In case a search function cannot find a given encoding, it should return
+ ``None``.
+
+ .. versionchanged:: 3.9
+ Hyphens and spaces are converted to underscore.
.. function:: unregister(search_function)
More information about the Python-checkins
mailing list