PEP 11: add mailcap to the deprecation list (#2557)

brettcannon · web-flow · commit 701999a91dc5 · 2022-04-25T20:41:00.000-07:00
This received SC approval at their 2022-04-25 meeting.
diff --git a/pep-0594.rst b/pep-0594.rst
@@ -145,6 +145,7 @@ audio processing.
     chunk,3.11,3.13,1999,no,\-
     crypt,3.11,3.13,1994,**yes (inactive)**,"legacycrypt_, bcrypt_, argon2-cffi_, hashlib_, passlib_"
     imghdr,3.11,3.13,1992,no,"filetype_, puremagic_, python-magic_"
+    mailmap,3.11,3.13,1995,no,\-
     msilib,3.11,3.13,2006,no,\-
     nntplib,3.11,3.13,1992,no,\-
     nis,3.11 (3.0\*),3.13,1992,no,\-
@@ -470,6 +471,17 @@ security engine like SELinux or AppArmor.
 Misc modules
 ------------
 
+mailcap
+~~~~~~~
+
+The `mailcap <https://docs.python.org/3/library/mailcap.html>`__ package
+reads *mail capability* files to assist in handling a file attachment in
+an email. In most modern OSs the email client itself handles reacting to
+file attachments. Operating systems also have their own way to register
+handling files by their file name extension. Finally, the module has
+`CVE-2015-20107 <https://nvd.nist.gov/vuln/detail/CVE-2015-20107>`__ filed
+against it while having no maintainer to help fix it.
+
 
 msilib
 ~~~~~~
