Sphinx linkcheck and broken/redirect occurrences in Python Docs

Running make linkcheck in Doc folder outputs thousands of broken and redirected status. It would be nice to clean this up so we can link-check Python in CI/CD for each commit, but right now it is too polluted.

Some of these occurrences could/should be fixed in the docs itself, others can benefit from Sphinx's linkcheck configs e.g. linkcheck_ignore and linkcheck_allow_redirect.

See linkcheck-log.txt for the full log as of commit f2b7ecb.

Fun stats obtained from the above file:

Of its 8327 lines, where 7824 are related to BPO -> GH issues. Of 7824, 5744 lines are from whatsnew/changelog and only 20 are not from whatsnew/
241 lines are redirection of CPython CVS URL, fixing /tree/ to /blob/ in GitHub URL
28 lines are broken links, where one broken link is 'https://' from an example in whatsnet/changelog

The way I see, this steps divide in:

Clean BPO to GH redirection messages
Fix broken links
Clean CPython CVS URL redirections
Clean GH issues to GH PR redirections
Fix the rest of the occurrences.

linkcheck_allow_redirect and linkcheck_ignore can be very handy in this case. linkcheck_allow_redirect makes 'ok' status a redirect that is being spotted by linkcheck, and we have linkcheck_ignore as the last resource.

Questions I have before implementing the solution:

Documentation hosted by Read The Docs may have language enabled so example.com is redirected to example.com/en/latest. To handle occurrences, I could add them to linkcheck_allow_redirect or we can use sphinx-ext-intersphinx to map a keyword to the documentation URL (e.g 'rtd' for read-the-docs docs). The last option allows to map to proper language of the target URL linked, similar on how Weblate did)

Is there any restrictions to fix broken/redirect links in old whatsnew/.rst?
Is there any restrictions to fix broken/redirect links in old whatsnew/changelog.rst (i.e. Misc/NEWS)?
Should I create a single Pull Request for all the fixes?

Linked PRs

What about ignoring the 7824 bpo redirects? They work fine, we control bpo and can keep the redirector working, we don’t need to change 8000 lines in historical whatsnew docs.

The CVS redirections can be fixed, as well as the broken links.

(For reference, some earlier discussion at https://discuss.python.org/t/sphinx-linkcheck-and-broken-redirect-occurrences-in-python-docs/25687)

Of its 8327 lines, where 7824 are related to BPO -> GH issues. Of 7824, 5744 lines are from whatsnew/changelog and only 20 are not from whatsnew/

Yes, let's ignore the BPO redirects. There's so many, I think either linkcheck_allow_redirect or linkcheck_ignore, whichever is quicker for linkcheck to process.

We actually have a linkcheck_ignore for BPO, but the regex doesn't match, I guess it's gone out of sync:

cpython/Doc/conf.py

Line 258 in 7f3c106

linkcheck_ignore = [r'https://bugs.python.org/(issue)?\d+']

241 lines are redirection of CPython CVS URL, fixing /tree/ to /blob/ in GitHub URL

Please could you give some examples of these?

Documentation hosted by Read The Docs may have language enabled so example.com is redirected to example.com/en/latest. To handle occurrences, I could add them to linkcheck_allow_redirect or we can use sphinx-ext-intersphinx to map a keyword to the documentation URL (e.g 'rtd' for read-the-docs docs). The last option allows to map to proper language of the target URL linked, similar on how Weblate did)

If there's not too many, we could add to linkcheck_allow_redirect, similar to the devguide. There may be some other useful rules to copy over:

https://github.com/python/devguide/blob/79e1a1f2961ba0882d5f0274f7c8876e36ca5dff/conf.py#L60-L107

Is there any restrictions to fix broken/redirect links in old whatsnew/.rst?

Is there any restrictions to fix broken/redirect links in old whatsnew/changelog.rst (i.e. Misc/NEWS)?

Not as such, although effort is usually prioritised for the newer/more active pages. Cleaning them up would mean linkcheck output is more useful in the future.

The way I see, this steps divide in:

Clean BPO to GH redirection messages

Fix broken links

Clean CPython CVS URL redirections

Clean GH issues to GH PR redirections

Fix the rest of the occurrences.

...

Should I create a single Pull Request for all the fixes?

Maybe a PR for each of these steps? And split smaller if you feel they're too big. Smaller PRs are easier to review and get merged.

241 lines are redirection of CPython CVS URL, fixing /tree/ to /blob/ in GitHub URL

Please could you give some examples of these?

Sure. The file Doc/about.rst has :source:`Misc/ACKS` , which links to that file in CPython's source code repository. The custom role "source" is defined in Doc/tools/extensions/pyspecific.py to https://github.com/python/cpython/tree/main/ + the suffix.

GitHub URL for browsing files is /blob/ and directories is /tree/. When browsing Misc/ACKS, the /tree/ redirects to /blob/.

From linkcheck stdout:

about: line   33) redirect  https://github.com/python/cpython/tree/main/Misc/ACKS - permanently to https://github.com/python/cpython/blob/main/Misc/ACKS

See in the above log how the redirect was from /tree/ to /blob/.

Is there any restrictions to fix broken/redirect links in old whatsnew/.rst?

Is there any restrictions to fix broken/redirect links in old whatsnew/changelog.rst (i.e. Misc/NEWS)?

Not as such, although effort is usually prioritised for the newer/more active pages. Cleaning them up would mean linkcheck output is more useful in the future.

Great, I'll focus on the cleanup then.

Should I create a single Pull Request for all the fixes?

Maybe a PR for each of these steps? And split smaller if you feel they're too big. Smaller PRs are easier to review and get merged.

Will do, thanks for the suggestion.

Thanks, we can add the tree->blob redirects to linkcheck_allow_redirect like: https://github.com/python/devguide/blob/main/conf.py#L73-L74

Why not do the one-line fix to pyspecific rather?

Because in :source:`something` the URL has /tree/ if something is a directory and /blob/ if it is a file. GitHub redirects both ways. If we put /blob/ in pyspecific.py, then a :source:`Misc/` would result in /blob/ being redirected to /tree/.

EDIT: See some examples:

$ curl -sI https://github.com/python/cpython/blob/main/Misc | grep -E '(^HTTP|^location:)'
HTTP/2 301 
location: https://github.com/python/cpython/tree/main/Misc
$ curl -sI https://github.com/python/cpython/tree/main/Misc/ACKS | grep -E '(^HTTP|^location:)'
HTTP/2 301 
location: https://github.com/python/cpython/blob/main/Misc/ACKS

Suggestion please?

bpo-31453: Add TLSVersion constants and SSLContext.maximum_version / minimum_version attributes. The new API wraps OpenSSL 1.1 https://www.openssl.org/docs/man1.1.0/ssl/SSL_CTX_set_min_proto_version.html feature.

The text talks about OpenSSL 1.1.0 and the URL for version 1.1.0 is broken (HTTP 404), but there are valid URLs for the same resource pointing to OpenSSL version 1.1.1 and to 3.1.0. Should I update the URL to either one, or use wayback machine to make sure to match the OpenSSL version?

If openssl 1.1.1 is a bugfix release of the 1.1 branch, then it would be fine to point there.

Created the first PR. I'm planning to create other 2 PRs, with more file changes than this one.

I noticed the docs.yml workflow file runs for all branches from main to 3.7. Should I back-port the fixes to all these versions (cases were the bot won't be able to back-port automatically) or is there some code freeze that prevents it?

Backporting doc fixes to 3.11 is fine, but older branches only accept security fixes.

Got it. It means a linkcheck job in docs.yml will require a condition check to exclude versions < 3.11. Thanks.

@vstinner

@vstinner I was hoping to include at least another PR for "redirect with found" reported by linkcheck, (see above comment #103484 (comment)), and then we can close this. Can you please keep this open for now?

pythonGH-103484: Fix permanently redirects reported by linkcheck (pyt…

pythonGH-103484: Fix broken links reported by linkcheck (python#124169)

[3.13] GH-103484: Tell linkcheck to ignore debian manpage redirects (G…

[3.13] GH-103484: Fix broken links reported by linkcheck (GH-124169) (#…

[3.13] GH-103484: Fix permanently redirects reported by linkcheck (GH…

[3.12]: gh-103484: Relink _xxsubinterpretersmodule.c in whatsnew/3.12…

I ran make linkcheck on main (which took a while!), the full log: anseo!

Broken cases, ignoring 403's and false positives they are all fixed by #140012:

$ grep "broken" log
(whatsnew/changelog: line 35393) broken    http://www.example.com - HTTPConnectionPool(host='www.example.com', port=80): Max retries exceeded with url: / (Caused by NameResolutionError("<urllib3.connection.HTTPConnection object at 0x7f39a855c060>: Failed to resolve 'www.example.com' ([Errno -2] Name or service not known)"))
(library/collections: line  444) broken    http://www.java2s.com/Tutorial/Cpp/0380__set-multiset/Catalog0380__set-multiset.htm - HTTPConnectionPool(host='www.java2s.com', port=80): Max retries exceeded with url: /Tutorial/Cpp/0380__set-multiset/Catalog0380__set-multiset.htm (Caused by NameResolutionError("<urllib3.connection.HTTPConnection object at 0x7f39a855d5a0>: Failed to resolve 'www.java2s.com' ([Errno -2] Name or service not known)"))
(    whatsnew/3.8: line 2231) broken    https://ark.intel.com/content/www/us/en/ark/products/76088/intel-core-i7-4960hq-processor-6m-cache-up-to-3-80-ghz.html - 403 Client Error: Forbidden for url: https://corpredirect.intel.com/Redirector/404Redirector.aspx?404;https://ark.intel.com/content/www/us/en/ark/products/76088/intel-core-i7-4960hq-processor-6m-cache-up-to-3-80-ghz.html
( library/secrets: line  131) broken    https://codahale.com/a-lesson-in-timing-attacks/ - HTTPSConnectionPool(host='codahale.com', port=443): Max retries exceeded with url: /a-lesson-in-timing-attacks/ (Caused by NameResolutionError("<urllib3.connection.HTTPSConnection object at 0x7f39a4949240>: Failed to resolve 'codahale.com' ([Errno -5] No address associated with hostname)"))
(    whatsnew/2.3: line 1080) broken    https://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.19.3910 - HTTPSConnectionPool(host='citeseerx.ist.psu.edu', port=443): Max retries exceeded with url: /viewdoc/summary?doi=10.1.1.19.3910 (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1108)')))
(   whatsnew/3.10: line 1565) broken    https://developers.redhat.com/blog/2020/06/25/red-hat-enterprise-linux-8-2-brings-faster-python-3-8-run-speeds/ - 403 Client Error: Forbidden for url: https://developers.redhat.com/blog/2020/06/25/red-hat-enterprise-linux-8-2-brings-faster-python-3-8-run-speeds/
(       howto/mro: line  667) broken    https://doi.org/10.1145/236337.236343 - 403 Client Error: Forbidden for url: https://dl.acm.org/doi/10.1145/236337.236343
(     faq/library: line  181) broken    https://epydoc.sourceforge.net/ - 403 Client Error: Forbidden for url: https://epydoc.sourceforge.net/
(    whatsnew/2.3: line 1867) broken    https://hg.python.org/cpython/file/default/Objects/obmalloc.c - 404 Client Error: Not Found for url: https://hg.python.org/cpython/file/default/Objects/obmalloc.c
(    whatsnew/2.3: line 1334) broken    https://idlefork.sourceforge.net - 403 Client Error: Forbidden for url: https://idlefork.sourceforge.net/
( library/zipfile: line  161) broken    https://infozip.sourceforge.net/ - 403 Client Error: Forbidden for url: https://infozip.sourceforge.net/
(     faq/library: line  553) broken    https://groups.google.com/groups?selm=34A04430.CF9@ohioee.com - 500 Server Error: Internal Server Error for url: https://groups.google.com/groups?selm=34A04430.CF9@ohioee.com
(   library/intro: line  141) broken    https://issuetracker.google.com/issues/128554619#comment4 - Anchor 'comment4' not found
(    howto/curses: line  543) broken    https://linux.die.net/man/3/ncurses - 403 Client Error: Forbidden for url: https://linux.die.net/man/3/ncurses
( using/configure: line   50) broken    https://linux.die.net/man/3/libuuid - 403 Client Error: Forbidden for url: https://linux.die.net/man/3/libuuid
(  library/select: line  286) broken    https://linux.die.net/man/4/epoll - 403 Client Error: Forbidden for url: https://linux.die.net/man/4/epoll
(whatsnew/changelog: line  285) broken    https://manpages.debian.org/fg - 404 Client Error: Not Found for url: https://dyn.manpages.debian.org/fg
(    whatsnew/2.3: line 1233) broken    https://pybsddb.sourceforge.net - 403 Client Error: Forbidden for url: https://pybsddb.sourceforge.net/
(    whatsnew/2.0: line  571) broken    https://pythonce.sourceforge.net/ - 403 Client Error: Forbidden for url: https://pythonce.sourceforge.net/
( library/tkinter: line  999) broken    https://python-pillow.org/ - HTTPSConnectionPool(host='python-pillow.org', port=443): Max retries exceeded with url: / (Caused by SSLError(SSLError(1, '[SSL: SSLV3_ALERT_HANDSHAKE_FAILURE] ssl/tls alert handshake failure (_ssl.c:1108)')))
(    whatsnew/2.1: line  612) broken    https://pyunit.sourceforge.net/ - 403 Client Error: Forbidden for url: https://pyunit.sourceforge.net/
(    whatsnew/2.0: line  936) broken    https://pyxml.sourceforge.net/topics/howto/xml-howto.html - 403 Client Error: Forbidden for url: https://pyxml.sourceforge.net/topics/howto/xml-howto.html
( library/mailbox: line  760) broken    https://rand-mh.sourceforge.io/book/ - 404 Client Error: Not Found for url: https://rand-mh.sourceforge.io/book/
(whatsnew/changelog: line 40958) broken    https://sourceforge.net/p/expat/bugs/537/ - 403 Client Error: Forbidden for url: https://sourceforge.net/p/expat/bugs/537/
(    whatsnew/2.0: line   59) broken    https://sourceforge.net/projects/python/ - 403 Client Error: Forbidden for url: https://sourceforge.net/projects/python/
(    whatsnew/2.6: line  191) broken    https://svn.python.org/view/tracker/importer/ - unauthorized
(    whatsnew/2.6: line 2372) broken    https://tipc.sourceforge.net/ - 403 Client Error: Forbidden for url: https://tipc.sourceforge.net/
(library/tkinter.ttk: line   59) broken    https://tktable.sourceforge.net/tile/doc/converting.txt - 403 Client Error: Forbidden for url: https://tktable.sourceforge.net/tile/doc/converting.txt
(library/tkinter.ttk: line 1275) broken    https://tktable.sourceforge.net/tile/tile-tcl2004.pdf - 403 Client Error: Forbidden for url: https://tktable.sourceforge.net/tile/tile-tcl2004.pdf
(    whatsnew/3.5: line 2215) broken    https://visualstudio.microsoft.com/en/vs/older-downloads/#visual-studio-2015-and-other-products - Anchor 'visual-studio-2015-and-other-products' not found
(   c-api/complex: line  131) broken    number - 
(       using/ios: line  269) broken    https://github.com/python/cpython/tree/main/Apple/iOS/testbed - 404 Client Error: Not Found for url: https://github.com/python/cpython/tree/main/Apple/iOS/testbed
( library/profile: line    7) broken    https://github.com/python/cpython/tree/main/Lib/profile/sample.py - 404 Client Error: Not Found for url: https://github.com/python/cpython/tree/main/Lib/profile/sample.py
(  library/string: line    7) broken    https://github.com/python/cpython/tree/main/Lib/string.py - 404 Client Error: Not Found for url: https://github.com/python/cpython/tree/main/Lib/string.py
( using/configure: line 1092) broken    https://github.com/python/cpython/tree/main/iOS/README.rst - 404 Client Error: Not Found for url: https://github.com/python/cpython/tree/main/iOS/README.rst

warnings

(         license: line  192) Doc/license.rst:192: WARNING: redirect  http://hdl.handle.net/1895.22/1013 - permanently to https://www.handle.net/python_licenses/python1.6.1-2-23-01.html
(    whatsnew/2.4: line  759) Doc/whatsnew/2.4.rst:759: WARNING: redirect  http://web.archive.org/web/20210306104320/https://developer.gnome.org/glib/2.26/ - with Found to http://web.archive.org/web/20210306060400/https://developer.gnome.org/glib/2.26/
(howto/logging-cookbook: line  787) Doc/howto/logging-cookbook.rst:787: WARNING: redirect  http://supervisord.org/ - permanently to https://supervisord.org/
(    whatsnew/2.2: line  960) Doc/whatsnew/2.2.rst:960: WARNING: redirect  http://xmlrpc.scripting.com/ - with Found to http://xmlrpc.com/
(library/xmlrpc.client: line  171) Doc/library/xmlrpc.client.rst:171: WARNING: redirect  http://xmlrpc.scripting.com/spec.html - with Found to http://xmlrpc.com/spec.md
(         license: line  308) Doc/license.rst:308: WARNING: redirect  http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/MT2002/emt19937ar.html - with Found to https://www.math.sci.hiroshima-u.ac.jp/m-mat/MT/MT2002/emt19937ar.html
(   using/windows: line   26) Doc/using/windows.rst:26: WARNING: redirect  https://apps.microsoft.com/detail/9NQ7512CXL7T - with Found to https://apps.microsoft.com/detail/9nq7512cxl7t?hl=en-US&gl=IE
(  howto/argparse: line  825) Doc/howto/argparse.rst:825: WARNING: redirect  https://babel.pocoo.org/ - with Found to https://babel.pocoo.org/en/latest/
(   using/android: line   33) Doc/using/android.rst:33: WARNING: redirect  https://briefcase.readthedocs.io - with Found to https://briefcase.readthedocs.io/en/stable/
(   using/android: line   34) Doc/using/android.rst:34: WARNING: redirect  https://buildozer.readthedocs.io - with Found to https://buildozer.readthedocs.io/en/latest/
(     c-api/intro: line  830) Doc/c-api/intro.rst:830: WARNING: redirect  https://cffi.readthedocs.io - with Found to https://cffi.readthedocs.io/en/stable/
(extending/extending: line   25) Doc/extending/extending.rst:25: WARNING: redirect  https://cffi.readthedocs.io/ - with Found to https://cffi.readthedocs.io/en/stable/
(   library/trace: line   18) Doc/library/trace.rst:18: WARNING: redirect  https://coverage.readthedocs.io/ - with Found to https://coverage.readthedocs.io/en/7.10.7/
(library/tkinter.ttk: line   27) Doc/library/tkinter.ttk.rst:27: WARNING: redirect  https://core.tcl.tk/tips/doc/trunk/tip/48.md - with Found to https://core.tcl-lang.org/tips/doc/trunk/tip/48.md
(howto/functional: line 1240) Doc/howto/functional.rst:1240: WARNING: redirect  https://developer.ibm.com/articles/l-prog/ - with Found to https://developer.ibm.com/technologies/linux/articles/
(howto/functional: line 1240) Doc/howto/functional.rst:1240: WARNING: redirect  https://developer.ibm.com/tutorials/l-prog2/ - with Found to https://developer.ibm.com/technologies/linux/tutorials/
(howto/functional: line 1240) Doc/howto/functional.rst:1240: WARNING: redirect  https://developer.ibm.com/tutorials/l-prog3/ - with Found to https://developer.ibm.com/technologies/linux/tutorials/
(howto/logging-cookbook: line 2123) Doc/howto/logging-cookbook.rst:2123: WARNING: redirect  https://docs.djangoproject.com/en/stable/topics/logging/#configuring-logging - with Found to https://docs.djangoproject.com/en/5.2/topics/logging/
(tutorial/whatnow: line   36) Doc/tutorial/whatnow.rst:36: WARNING: redirect  https://docs.python.org - with Found to https://docs.python.org/3/
(library/unittest: line   58) Doc/library/unittest.rst:58: WARNING: redirect  https://docs.pytest.org/ - with Found to https://docs.pytest.org/en/stable/
(    whatsnew/3.7: line  116) Doc/whatsnew/3.7.rst:116: WARNING: redirect  https://docs.python.org/fr/ - with Found to https://docs.python.org/fr/3/
(    whatsnew/3.7: line  116) Doc/whatsnew/3.7.rst:116: WARNING: redirect  https://docs.python.org/ko/ - with Found to https://docs.python.org/ko/3/
(    whatsnew/3.7: line  116) Doc/whatsnew/3.7.rst:116: WARNING: redirect  https://docs.python.org/ja/ - with Found to https://docs.python.org/ja/3/
(whatsnew/changelog: line 34665) Doc/whatsnew/changelog.rst:34665: WARNING: redirect  https://docs.python.org/zh-cn/ - with Found to https://docs.python.org/zh-cn/3/
( using/configure: line   12) Doc/using/configure.rst:12: WARNING: redirect  https://en.cppreference.com/w/c/11 - permanently to https://en.cppreference.com/w/c/11.html
(howto/free-threading-extensions: line  250) Doc/howto/free-threading-extensions.rst:250: WARNING: redirect  https://en.cppreference.com/w/c/language/storage_duration - permanently to https://en.cppreference.com/w/c/language/storage_duration.html
(     library/ast: line 2632) Doc/library/ast.rst:2632: WARNING: redirect  https://greentreesnakes.readthedocs.io/ - with Found to https://greentreesnakes.readthedocs.io/en/latest/
(library/importlib.metadata: line   55) Doc/library/importlib.metadata.rst:55: WARNING: redirect  https://importlib-metadata.readthedocs.io/ - with Found to https://importlib-metadata.readthedocs.io/en/latest/
(   using/windows: line 1237) Doc/using/windows.rst:1237: WARNING: redirect  https://learn.microsoft.com/cpp/mfc/mfc-desktop-applications - with Found to https://learn.microsoft.com/en-us/cpp/mfc/mfc-desktop-applications
(   using/windows: line  599) Doc/using/windows.rst:599: WARNING: redirect  https://learn.microsoft.com/powershell/module/appx/remove-appxpackage - with Found to https://learn.microsoft.com/en-us/powershell/module/appx/remove-appxpackage
(   using/windows: line  599) Doc/using/windows.rst:599: WARNING: redirect  https://learn.microsoft.com/powershell/module/appx/add-appxpackage - with Found to https://learn.microsoft.com/en-us/powershell/module/appx/add-appxpackage
(   using/windows: line  617) Doc/using/windows.rst:617: WARNING: redirect  https://learn.microsoft.com/powershell/module/dism/add-appxprovisionedpackage - with Found to https://learn.microsoft.com/en-us/powershell/module/dism/add-appxprovisionedpackage
(   using/windows: line  617) Doc/using/windows.rst:617: WARNING: redirect  https://learn.microsoft.com/uwp/api/windows.management.deployment.packagemanager - with Found to https://learn.microsoft.com/en-us/uwp/api/windows.management.deployment.packagemanager
(    library/time: line  407) Doc/library/time.rst:407: WARNING: redirect  https://learn.microsoft.com/windows-hardware/drivers/kernel/high-resolution-timers - with Found to https://learn.microsoft.com/en-us/windows-hardware/drivers/kernel/high-resolution-timers
(   using/windows: line 1231) Doc/using/windows.rst:1231: WARNING: redirect  https://learn.microsoft.com/windows/win32/com/component-object-model--com--portal - with Found to https://learn.microsoft.com/en-us/windows/win32/com/component-object-model--com--portal
( library/os.path: line  321) Doc/library/os.path.rst:321: WARNING: redirect  https://learn.microsoft.com/windows/dev-drive/ - with Found to https://learn.microsoft.com/en-us/windows/dev-drive/
(library/asyncio-eventloop: line 1891) Doc/library/asyncio-eventloop.rst:1891: WARNING: redirect  https://learn.microsoft.com/windows/win32/fileio/i-o-completion-ports - with Found to https://learn.microsoft.com/en-us/windows/win32/fileio/i-o-completion-ports
(     faq/general: line  210) Doc/faq/general.rst:210: WARNING: redirect  https://mail.python.org/mailman/listinfo/python-list - permanently to https://mail.python.org/mailman3/lists/python-list.python.org/
(     library/ast: line 2645) Doc/library/ast.rst:2645: WARNING: redirect  https://libcst.readthedocs.io/ - with Found to https://libcst.readthedocs.io/en/latest/
(whatsnew/changelog: line  739) Doc/whatsnew/changelog.rst:739: WARNING: redirect  https://manpages.debian.org/ERR_func_error_string - temporarily to https://manpages.debian.org/trixie/libssl-doc/ERR_func_error_string.3ssl.en.html
(whatsnew/changelog: line  739) Doc/whatsnew/changelog.rst:739: WARNING: redirect  https://manpages.debian.org/EVP_MD_CTX_md - temporarily to https://manpages.debian.org/trixie/libssl-doc/EVP_MD_CTX_md.3ssl.en.html
(whatsnew/changelog: line  285) Doc/whatsnew/changelog.rst:285: WARNING: redirect  https://manpages.debian.org/kill - temporarily to https://manpages.debian.org/trixie/procps/kill.1.en.html
(    whatsnew/2.7: line 1836) Doc/whatsnew/2.7.rst:1836: WARNING: redirect  https://nose.readthedocs.io/ - with Found to https://nose.readthedocs.io/en/latest/
(installing/index: line  109) Doc/installing/index.rst:109: WARNING: redirect  https://packaging.python.org - with Found to https://packaging.python.org/en/latest/
(distributing/index: line   14) Doc/distributing/index.rst:14: WARNING: redirect  https://packaging.python.org/ - with Found to https://packaging.python.org/en/latest/
(    library/venv: line   59) Doc/library/venv.rst:59: WARNING: redirect  https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/#create-and-use-virtual-environments - with Found to https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/
(     c-api/intro: line  852) Doc/c-api/intro.rst:852: WARNING: redirect  https://packaging.python.org/guides/packaging-binary-extensions/ - with Found to https://packaging.python.org/en/latest/guides/packaging-binary-extensions/
(installing/index: line  241) Doc/installing/index.rst:241: WARNING: redirect  https://packaging.python.org/extensions/ - with Found to https://packaging.python.org/en/latest/guides/packaging-binary-extensions/
(installing/index: line  118) Doc/installing/index.rst:118: WARNING: redirect  https://packaging.python.org/installing/ - with Found to https://packaging.python.org/en/latest/tutorials/installing-packages/
(installing/index: line  136) Doc/installing/index.rst:136: WARNING: redirect  https://packaging.python.org/installing/#requirements-for-installing-packages - with Found to https://packaging.python.org/en/latest/tutorials/installing-packages/
(installing/index: line   71) Doc/installing/index.rst:71: WARNING: redirect  https://packaging.python.org/installing/#creating-virtual-environments - with Found to https://packaging.python.org/en/latest/tutorials/installing-packages/
(     library/ast: line 2650) Doc/library/ast.rst:2650: WARNING: redirect  https://parso.readthedocs.io - with Found to https://parso.readthedocs.io/en/latest/
(    whatsnew/3.9: line  935) Doc/whatsnew/3.9.rst:935: WARNING: redirect  https://parso.readthedocs.io/ - with Found to https://parso.readthedocs.io/en/latest/
(installing/index: line  152) Doc/installing/index.rst:152: WARNING: redirect  https://packaging.python.org/science/ - with Found to https://packaging.python.org/en/latest/guides/installing-scientific-packages/
(library/__main__: line  167) Doc/library/__main__.rst:167: WARNING: redirect  https://pip.pypa.io/ - with Found to https://pip.pypa.io/en/stable/
( howto/pyporting: line   31) Doc/howto/pyporting.rst:31: WARNING: redirect  https://portingguide.readthedocs.io - with Found to https://portingguide.readthedocs.io/en/latest/
(howto/perf_profiling: line   11) Doc/howto/perf_profiling.rst:11: WARNING: redirect  https://perf.wiki.kernel.org - permanently to https://perfwiki.github.io/
(  c-api/perfmaps: line    8) Doc/c-api/perfmaps.rst:8: WARNING: redirect  https://perf.wiki.kernel.org/index.php/Main_Page - permanently to https://perfwiki.github.io/
( faq/programming: line  100) Doc/faq/programming.rst:100: WARNING: redirect  https://pyinstaller.org/ - with Found to https://pyinstaller.org/en/stable/
(     c-api/intro: line  834) Doc/c-api/intro.rst:834: WARNING: redirect  https://pybind11.readthedocs.io/ - with Found to https://pybind11.readthedocs.io/en/stable/
(library/unittest.mock-examples: line 1345) Doc/library/unittest.mock-examples.rst:1345: WARNING: redirect  https://pyhamcrest.readthedocs.io/ - with Found to https://pyhamcrest.readthedocs.io/en/latest/
(    whatsnew/2.5: line  333) Doc/whatsnew/2.5.rst:333: WARNING: redirect  https://pylib.readthedocs.io/ - with Found to https://pylib.readthedocs.io/en/latest/
(     c-api/intro: line  835) Doc/c-api/intro.rst:835: WARNING: redirect  https://pyo3.rs/ - with Found to https://pyo3.rs/v0.26.0/
(   library/intro: line   89) Doc/library/intro.rst:89: WARNING: redirect  https://pyodide.org/ - with Found to https://pyodide.org/en/stable/
(    whatsnew/2.7: line 1836) Doc/whatsnew/2.7.rst:1836: WARNING: redirect  https://pytest.org - with Found to https://docs.pytest.org/en/stable/
(library/urllib.request: line   21) Doc/library/urllib.request.rst:21: WARNING: redirect  https://requests.readthedocs.io/en/master/ - with Found to https://requests.readthedocs.io/en/latest/
(library/importlib.resources: line   36) Doc/library/importlib.resources.rst:36: WARNING: redirect  https://setuptools.readthedocs.io/en/latest/pkg_resources.html - with Found to https://setuptools.pypa.io/en/latest/pkg_resources.html
(library/importlib.resources: line   36) Doc/library/importlib.resources.rst:36: WARNING: redirect  https://setuptools.readthedocs.io/en/latest/pkg_resources.html#basic-resource-access - with Found to https://setuptools.pypa.io/en/latest/pkg_resources.html
(library/importlib.metadata: line   16) Doc/library/importlib.metadata.rst:16: WARNING: redirect  https://setuptools.readthedocs.io/en/latest/pkg_resources.html#entry-points - with Found to https://setuptools.pypa.io/en/latest/pkg_resources.html
(library/importlib.metadata: line   16) Doc/library/importlib.metadata.rst:16: WARNING: redirect  https://setuptools.readthedocs.io/en/latest/pkg_resources.html#metadata-api - with Found to https://setuptools.pypa.io/en/latest/pkg_resources.html
(whatsnew/changelog: line 16895) Doc/whatsnew/changelog.rst:16895: WARNING: redirect  https://sphinxext-opengraph.readthedocs.io/ - with Found to https://sphinxext-opengraph.readthedocs.io/en/latest/
(    library/math: line  830) Doc/library/math.rst:830: WARNING: redirect  https://tauday.com/ - permanently to https://www.tauday.com/
(       using/mac: line  110) Doc/using/mac.rst:110: WARNING: redirect  https://support.apple.com/en-us/HT201732 - permanently to https://support.apple.com/guide/mac-help/organize-your-files-in-the-finder-mchlp2605/mac
(       using/mac: line  240) Doc/using/mac.rst:240: WARNING: redirect  https://toga.readthedocs.io - with Found to https://toga.readthedocs.io/en/stable/
( library/tkinter: line   93) Doc/library/tkinter.rst:93: WARNING: redirect  https://wiki.tcl-lang.org/37432 - with Found to https://wiki.tcl-lang.org/page/Tcl+Package+User+Guide
( library/wsgiref: line   32) Doc/library/wsgiref.rst:32: WARNING: redirect  https://wsgi.readthedocs.io/ - with Found to https://wsgi.readthedocs.io/en/latest/
( faq/programming: line   51) Doc/faq/programming.rst:51: WARNING: redirect  https://www.activestate.com/products/komodo-ide/ - permanently to https://docs.activestate.com/komodo/12/
( faq/programming: line   32) Doc/faq/programming.rst:32: WARNING: redirect  https://www.activestate.com/products/python/ - permanently to https://www.activestate.com/platform/supported-languages/python/
(         license: line   13) Doc/license.rst:13: WARNING: redirect  https://www.cwi.nl - with Found to https://www.cwi.nl/en/
(library/platform: line  287) Doc/library/platform.rst:287: WARNING: redirect  https://www.freedesktop.org/software/systemd/man/os-release.html - with Found to https://www.freedesktop.org/software/systemd/man/latest/os-release.html
(    whatsnew/3.2: line 2522) Doc/whatsnew/3.2.rst:2522: WARNING: redirect  https://www.mercurial-scm.org/wiki/QuickStart - with Found to https://wiki.mercurial-scm.org/QuickStart
(    whatsnew/3.5: line 1254) Doc/whatsnew/3.5.rst:1254: WARNING: redirect  https://www.openexr.com - with Found to https://openexr.com/en/latest/
(installing/index: line   52) Doc/installing/index.rst:52: WARNING: redirect  https://www.pypa.io/ - with Found to https://www.pypa.io/en/latest/
(       using/mac: line  231) Doc/using/mac.rst:231: WARNING: redirect  https://www.qt.io/qt-for-python - permanently to https://www.qt.io/development/qt-framework/python-bindings
(     faq/library: line  181) Doc/faq/library.rst:181: WARNING: redirect  https://www.sphinx-doc.org - with Found to https://www.sphinx-doc.org/en/master/
(           about: line    6) Doc/about.rst:6: WARNING: redirect  https://www.sphinx-doc.org/ - with Found to https://www.sphinx-doc.org/en/master/
(         faq/gui: line   20) Doc/faq/gui.rst:20: WARNING: redirect  https://www.tcl.tk - permanently to https://www.tcl-lang.org/
(    whatsnew/2.7: line 1811) Doc/whatsnew/2.7.rst:1811: WARNING: redirect  https://www.tcl.tk/man/tcl8.5/TkCmd/ttk_intro.html - permanently to https://www.tcl-lang.org/man/tcl8.5/TkCmd/ttk_intro.html
( library/tkinter: line   50) Doc/library/tkinter.rst:50: WARNING: redirect  https://www.tcl.tk/man/tcl8.6/TkCmd/contents.htm - permanently to https://www.tcl-lang.org/man/tcl8.6/TkCmd/contents.htm
( library/tkinter: line  475) Doc/library/tkinter.rst:475: WARNING: redirect  https://www.tcl.tk/man/tcl8.6/TkCmd/grid.htm - permanently to https://www.tcl-lang.org/man/tcl8.6/TkCmd/grid.htm
( library/tkinter: line  488) Doc/library/tkinter.rst:488: WARNING: redirect  https://www.tcl.tk/man/tcl8.6/TkCmd/winfo.htm - permanently to https://www.tcl-lang.org/man/tcl8.6/TkCmd/winfo.htm
( library/tkinter: line  483) Doc/library/tkinter.rst:483: WARNING: redirect  https://www.tcl.tk/man/tcl8.6/TkCmd/options.htm - permanently to https://www.tcl-lang.org/man/tcl8.6/TkCmd/options.htm
( library/tkinter: line  483) Doc/library/tkinter.rst:483: WARNING: redirect  https://www.tcl.tk/man/tcl8.6/TkCmd/ttk_widget.htm - permanently to https://www.tcl-lang.org/man/tcl8.6/TkCmd/ttk_widget.htm
( library/tkinter: line  475) Doc/library/tkinter.rst:475: WARNING: redirect  https://www.tcl.tk/man/tcl8.6/TkCmd/ttk_button.htm - permanently to https://www.tcl-lang.org/man/tcl8.6/TkCmd/ttk_button.htm
( library/tkinter: line   45) Doc/library/tkinter.rst:45: WARNING: redirect  https://www.tkdocs.com/shipman/ - with Found to https://tkdocs.com/shipman/
(   howto/unicode: line   42) Doc/howto/unicode.rst:42: WARNING: redirect  https://www.unicode.org/versions/latest/#Summary - with Found to https://www.unicode.org/versions/Unicode17.0.0/
(howto/isolating-extensions: line  205) Doc/howto/isolating-extensions.rst:205: WARNING: redirect  https://github.com/python/cpython/blob/master/Modules/xxlimited.c - with Found to https://github.com/python/cpython/blob/main/Modules/xxlimited.c
( faq/programming: line   42) Doc/faq/programming.rst:42: WARNING: redirect  https://github.com/rocky/python3-trepan/ - permanently to https://github.com/Trepan-Debuggers/python3-trepan

Navigation Menu

Repository navigation

Sphinx linkcheck and broken/redirect occurrences in Python Docs #103484

Linked PRs

42 remaining items

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Sphinx linkcheck and broken/redirect occurrences in Python Docs #103484

Description

Linked PRs

Activity

merwok commented on Apr 12, 2023

hugovk commented on Apr 12, 2023

rffontenelle commented on Apr 13, 2023

hugovk commented on Apr 13, 2023

merwok commented on Apr 13, 2023

rffontenelle commented on Apr 13, 2023

rffontenelle commented on Apr 13, 2023

merwok commented on Apr 13, 2023

rffontenelle commented on Apr 15, 2023

rffontenelle commented on Apr 16, 2023

merwok commented on Apr 16, 2023

rffontenelle commented on Apr 16, 2023

42 remaining items

rffontenelle commented on Sep 17, 2024

StanFromIreland commented on Oct 12, 2025

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions