New submission from Tobias Kunze <r...@rixx.de>:

The documentation for the encodings.idna module contains no indicator that the 
RFC it supports has been obsoleted by another RFC: 
https://docs.python.org/3.10/library/codecs.html#module-encodings.idna

I'm sure this is obvious when you know your RFCs, but when just looking at the 
docs, it's easy to miss. In #msg379674, Marc-Andre suggested to fix the 
situation by deprecating or updating IDNA support. I'd like to propose to add a 
warning message in the meantime, pointing out the newer RFC and linking to the 
idna package on PyPI (if links to PyPI packages are alright in the docs?)

----------
assignee: docs@python
components: Documentation, Unicode
messages: 382300
nosy: docs@python, ezio.melotti, rixx, vstinner
priority: normal
severity: normal
status: open
title: Document encodings.idna limitations
type: enhancement
versions: Python 3.10

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue42533>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to