[3.14] gh-144133: Add a warning to the `encodings.punycode` documentation (GH-151812...

(cherry picked from commit 7ec70e1df33098de24d4b2cb181586d04cdde441)

Co-authored-by: Stan Ulbrych <stan@python.org>

diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst
index a43e90ee455a5fe290cf4e54510161cf35af5986..cf17e0d34dc2a6544ab36e2706ffb8b4cb9f7b59 100644 (file)
--- a/Doc/library/codecs.rst
+++ b/Doc/library/codecs.rst
@@ -1396,6 +1396,14 @@ encodings.
 | punycode           |         | Implement :rfc:`3492`.    |
 |                    |         | Stateful codecs are not   |
 |                    |         | supported.                |
+|                    |         |                           |
+|                    |         | .. warning::              |
+|                    |         |                           |
+|                    |         |    The decoding and       |
+|                    |         |    encoding algorithms    |
+|                    |         |    scale poorly, so       |
+|                    |         |    limit the length of    |
+|                    |         |    untrusted input.       |
 +--------------------+---------+---------------------------+
 | raw_unicode_escape |         | Latin-1 encoding with     |
 |                    |         | :samp:`\\u{XXXX}` and     |