summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2021-04-06 08:19:15 (GMT)
committerGitHub <noreply@github.com>2021-04-06 08:19:15 (GMT)
commitc7ccb0ff61e443633d0c54cb18b5633a8e95b30c (patch)
tree9d695db006e3ab15b3c151950345cca2fa66d501
parent028d5286d4255195ba6715e1aeb4bffed6b0279e (diff)
downloadcpython-c7ccb0ff61e443633d0c54cb18b5633a8e95b30c.zip
cpython-c7ccb0ff61e443633d0c54cb18b5633a8e95b30c.tar.gz
cpython-c7ccb0ff61e443633d0c54cb18b5633a8e95b30c.tar.bz2
bpo-17305: Link to the third-party idna package. (GH-25208)
So long as we don't have idna2008 in the standard library, we should at least point people to the third-party solution. (cherry picked from commit 1d023e374cf96d143b065242131ddc9b889f9a1e) Co-authored-by: Gregory P. Smith <greg@krypto.org>
-rw-r--r--Doc/library/codecs.rst3
1 files changed, 3 insertions, 0 deletions
diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst
index 6eb907a..32fbc83 100644
--- a/Doc/library/codecs.rst
+++ b/Doc/library/codecs.rst
@@ -1414,6 +1414,9 @@ Applications) and :rfc:`3492` (Nameprep: A Stringprep Profile for
Internationalized Domain Names (IDN)). It builds upon the ``punycode`` encoding
and :mod:`stringprep`.
+If you need the IDNA 2008 standard from :rfc:`5891` and :rfc:`5895`, use the
+third-party `idna module <https://pypi.org/project/idna/>_`.
+
These RFCs together define a protocol to support non-ASCII characters in domain
names. A domain name containing non-ASCII characters (such as
``www.Alliancefrançaise.nu``) is converted into an ASCII-compatible encoding