gh-101100: Fix Sphinx warnings for removed dead batteries

[hugovk]

Fix 58 warnings for modules removed by PEP 594: "Removing dead batteries from the standard library":

Doc/whatsnew/2.0.rst:1098: WARNING: py:mod reference target not found: linuxaudiodev Doc/whatsnew/2.0.rst:1098: WARNING: py:mod reference target not found: sunaudiodev Doc/whatsnew/2.4.rst:998: WARNING: py:mod reference target not found: asyncore Doc/whatsnew/2.6.rst:1792: WARNING: py:mod reference target not found: asyncore Doc/whatsnew/2.6.rst:1792: WARNING: py:mod reference target not found: asynchat Doc/whatsnew/2.6.rst:2927: WARNING: py:mod reference target not found: audiodev Doc/whatsnew/2.6.rst:2927: WARNING: py:mod reference target not found: linuxaudiodev Doc/whatsnew/2.6.rst:2927: WARNING: py:mod reference target not found: sunaudiodev Doc/whatsnew/3.11.rst:1750: WARNING: py:mod reference target not found: asynchat Doc/whatsnew/3.11.rst:1750: WARNING: py:mod reference target not found: asyncore Doc/whatsnew/3.11.rst:1750: WARNING: py:mod reference target not found: smtpd Doc/whatsnew/3.11.rst:1880: WARNING: py:mod reference target not found: asynchat Doc/whatsnew/3.11.rst:1881: WARNING: py:mod reference target not found: asyncore Doc/whatsnew/3.11.rst:2010: WARNING: py:mod reference target not found: smtpd Doc/whatsnew/3.2.rst:1861: WARNING: py:class reference target not found: asyncore.dispatcher Doc/whatsnew/3.2.rst:1861: WARNING: py:meth reference target not found: asyncore.dispatcher.handle_accepted Doc/whatsnew/3.2.rst:1861: WARNING: py:meth reference target not found: asyncore.dispatcher.handle_accept Doc/whatsnew/3.2.rst:1861: WARNING: py:meth reference target not found: asyncore.dispatcher.accept Doc/whatsnew/3.2.rst:2740: WARNING: py:func reference target not found: asyncore.handle_accept Doc/whatsnew/3.2.rst:2740: WARNING: py:func reference target not found: asyncore.handle_accepted Doc/whatsnew/3.3.rst:1848: WARNING: py:mod reference target not found: smtpd Doc/whatsnew/3.4.rst:1372: WARNING: py:class reference target not found: smtpd.SMTPServer Doc/whatsnew/3.4.rst:1372: WARNING: py:class reference target not found: smtpd.SMTPChannel Doc/whatsnew/3.4.rst:1372: WARNING: py:class reference target not found: asynchat.async_chat Doc/whatsnew/3.4.rst:2373: WARNING: py:attr reference target not found: cgi.FieldStorage.file Doc/whatsnew/3.5.rst:881: WARNING: py:class reference target not found: cgi.FieldStorage Doc/whatsnew/3.5.rst:1666: WARNING: py:class reference target not found: smtpd.SMTPServer Doc/whatsnew/3.5.rst:1666: WARNING: py:class reference target not found: smtpd.SMTPChannel Doc/whatsnew/3.5.rst:1666: WARNING: py:meth reference target not found: smtpd.SMTPServer.process_message Doc/whatsnew/3.5.rst:1677: WARNING: py:class reference target not found: smtpd.SMTPServer Doc/whatsnew/3.5.rst:1677: WARNING: py:meth reference target not found: smtpd.SMTPServer.process_message Doc/whatsnew/3.5.rst:1684: WARNING: py:class reference target not found: smtpd.SMTPServer Doc/whatsnew/3.5.rst:1684: WARNING: py:meth reference target not found: smtpd.SMTPServer.process_message Doc/whatsnew/3.5.rst:1692: WARNING: py:class reference target not found: smtpd.SMTPServer Doc/whatsnew/3.5.rst:1717: WARNING: py:func reference target not found: sndhdr.what Doc/whatsnew/3.5.rst:1717: WARNING: py:func reference target not found: sndhdr.whathdr Doc/whatsnew/3.5.rst:2299: WARNING: py:mod reference target not found: smtpd Doc/whatsnew/3.5.rst:2299: WARNING: py:class reference target not found: smtpd.SMTPServer Doc/whatsnew/3.6.rst:1964: WARNING: py:mod reference target not found: asynchat Doc/whatsnew/3.6.rst:1971: WARNING: py:mod reference target not found: asyncore Doc/whatsnew/3.6.rst:2187: WARNING: py:mod reference target not found: smtpd Doc/whatsnew/3.6.rst:2222: WARNING: py:class reference target not found: smtpd.SMTPChannel Doc/whatsnew/3.6.rst:2222: WARNING: py:class reference target not found: smtpd.SMTPServer Doc/whatsnew/3.6.rst:2222: WARNING: py:meth reference target not found: smtpd.SMTPServer.process_message Doc/whatsnew/3.7.rst:2307: WARNING: py:func reference target not found: cgi.parse_multipart Doc/whatsnew/3.9.rst:934: WARNING: py:func reference target not found: smtpd.MailmanProxy build/NEWS:6679: WARNING: py:mod reference target not found: asyncore build/NEWS:6679: WARNING: py:mod reference target not found: asynchat build/NEWS:8169: WARNING: py:mod reference target not found: smtpd build/NEWS:10143: WARNING: py:mod reference target not found: asynchat build/NEWS:10143: WARNING: py:mod reference target not found: asyncore build/NEWS:10143: WARNING: py:mod reference target not found: smtpd build/NEWS:10362: WARNING: py:mod reference target not found: asyncore build/NEWS:13815: WARNING: py:class reference target not found: smtpd.MailmanProxy build/NEWS:18404: WARNING: py:obj reference target not found: cgi.parse_multipart build/NEWS:25609: WARNING: py:obj reference target not found: crypt build/NEWS:25609: WARNING: py:obj reference target not found: crypt_r() build/NEWS:25609: WARNING: py:obj reference target not found: crypt() 

These removals began in 3.12, and the bulk were in 3.13. So some need backporting to 3.12, and we don't need to backport to 3.11.

• Issue: Fix all Sphinx reference warnings in the documentation #101100

---

📚 Documentation preview 📚: https://cpython-previews--113669.org.readthedocs.build/

[AlexWaygood]

Looks good, just a couple of suggestions to fix some adjacent warnings while we're here:

[hugovk]

Thanks, these 10 also now fixed:

/Users/hugo/github/python/cpython/main/Doc/whatsnew/2.4.rst:998: WARNING: py:func reference target not found: loop /Users/hugo/github/python/cpython/main/Doc/whatsnew/3.10.rst:1280: WARNING: py:meth reference target not found: pathlib.Path.link_to /Users/hugo/github/python/cpython/main/Doc/whatsnew/3.10.rst:1743: WARNING: py:meth reference target not found: pathlib.Path.link_to /Users/hugo/github/python/cpython/main/Doc/whatsnew/3.10.rst:1774: WARNING: 'envvar' reference target not found: PYTHONTHREADDEBUG /Users/hugo/github/python/cpython/main/Doc/whatsnew/3.11.rst:1905: WARNING: py:meth reference target not found: pathlib.Path.link_to /Users/hugo/github/python/cpython/main/Doc/whatsnew/3.11.rst:1908: WARNING: 'envvar' reference target not found: PYTHONTHREADDEBUG /Users/hugo/github/python/cpython/main/Doc/whatsnew/3.7.rst:2307: WARNING: py:class reference target not found: FieldStorage /Users/hugo/github/python/cpython/main/Doc/whatsnew/3.8.rst:1089: WARNING: py:meth reference target not found: pathlib.Path.link_to /Users/hugo/github/python/cpython/main/build/NEWS:13070: WARNING: 'envvar' reference target not found: PYTHONTHREADDEBUG /Users/hugo/github/python/cpython/main/build/NEWS:23944: WARNING: py:obj reference target not found: pathlib.path.link_to() 

Edit: include that extra one :)

[miss-islington-app]

Thanks @hugovk for the PR 🌮🎉.. I'm working now to backport this PR to: 3.12.
🐍🍒⛏🤖

[miss-islington-app]

Sorry, @hugovk, I could not cleanly backport this to 3.12 due to a conflict.
Please backport using cherry_picker on command line.

cherry_picker fab7ad62ceca1f88767bca4e1f06f8e4b1faef2f 3.12 

[bedevere-app]

GH-113681 is a backport of this pull request to the 3.12 branch.