[Python-checkins] gh-68966: Document mailcap deprecation in Python 3.11 (GH-91971)

[miss-islington]

https://github.com/python/cpython/commit/24ce12366f95d8fa8a3dc609daa59579819481bd
commit: 24ce12366f95d8fa8a3dc609daa59579819481bd
branch: 3.9
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2022-04-27T02:59:32-07:00
summary:

gh-68966: Document mailcap deprecation in Python 3.11 (GH-91971)


(cherry picked from commit 80de0273c0caf8bae19787bb00255eb3fb2a2d0c)
(cherry picked from commit a36d97e3f1daeb431e1c5bc8ab83daca93b747b0)

Co-authored-by: Victor Stinner <vstinner at python.org>

files:
M Doc/library/mailcap.rst
M Doc/library/netdata.rst
M Doc/library/superseded.rst

diff --git a/Doc/library/mailcap.rst b/Doc/library/mailcap.rst
index bf9639bdaca50..cd5ab0b32f49c 100644
--- a/Doc/library/mailcap.rst
+++ b/Doc/library/mailcap.rst
@@ -3,9 +3,14 @@
 
 .. module:: mailcap
    :synopsis: Mailcap file handling.
+   :deprecated:
 
 **Source code:** :source:`Lib/mailcap.py`
 
+.. deprecated:: 3.11
+   The :mod:`mailcap` module is deprecated. See :pep:`594` for the rationale
+   and the :mod:`mimetypes` module for an alternative.
+
 --------------
 
 Mailcap files are used to configure how MIME-aware applications such as mail
diff --git a/Doc/library/netdata.rst b/Doc/library/netdata.rst
index 8a3ad68753a53..2520036c2fa51 100644
--- a/Doc/library/netdata.rst
+++ b/Doc/library/netdata.rst
@@ -13,7 +13,6 @@ on the Internet.
 
    email.rst
    json.rst
-   mailcap.rst
    mailbox.rst
    mimetypes.rst
    base64.rst
diff --git a/Doc/library/superseded.rst b/Doc/library/superseded.rst
index e3f9b0d37fe10..b38f16691f6ea 100644
--- a/Doc/library/superseded.rst
+++ b/Doc/library/superseded.rst
@@ -20,9 +20,10 @@ backwards compatibility. They have been superseded by other modules.
    crypt.rst
    imghdr.rst
    imp.rst
+   mailcap.rst
    msilib.rst
-   nntplib.rst
    nis.rst
+   nntplib.rst
    optparse.rst
    ossaudiodev.rst
    pipes.rst