Fixes invalid links reported by linkcheck in docs

[rkratky]

Fixes FR-5664

See $subj.

[Chris-Peterson444]

So the link checker doesn't follow redirects? Good to know!

[rkratky]

So the link checker doesn't follow redirects? Good to know!

@Chris-Peterson444 It does. The man pages at manpages.ubuntu.com don't use HTTP redirects. AFAICT, they're JS redirects, which aren't recognized by most agents. See:

$ curl --head --location https://manpages.ubuntu.com/manpages/passwd.1.html
HTTP/2 404 
server: nginx/1.14.0 (Ubuntu)
date: Fri, 13 Oct 2023 10:04:34 GMT
content-type: text/html

[rkratky]

AFAICT, they're JS redirects

Scratch that. They pbbly use nginx rewrite.

[ogayot]

Thanks for the update!

[dbungert]

I would like you to explore linkcheck_allowed_redirects (if it works, I assume it won't) and linkcheck_ignore for the manpage problem. Or if that's not an option, we might as well bump the series to mantic at this point.

[dbungert]

https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-linkcheck_ignore

[rkratky]

I would like you to explore linkcheck_allowed_redirects (if it works, I assume it won't) and linkcheck_ignore for the manpage problem.

Thanks for the suggestion. Looking into it.

[rkratky]

Introduced the extlinks extension to handle manpage links.

[dbungert]

Very happy for the linkcheck test. Please update series, RTD doesn't like extlinks at the moment, and rebase to drop the merge commit. Thanks!

[rkratky]

RTD doesn't like extlinks at the moment

Yeah, silly me :) I'm still learning how RTD and Sphinx works. I added the 'extlinks' extension where I shouldn't. I fixed it, and now it builds fine with the extension.