Re: [PATCH 1/1] Documentation: Link man pages to https://man7.org/

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 968 bytes --]

Hi Petr,

On Mon, Jan 12, 2026 at 12:06:39AM +0100, Petr Vorel wrote:
> > I wonder if this could be implemented in a way that wouldn't need
> > changing any lines of documentation.
> 
> Good point. Yes, there is sphinx way to do it as one liner (no need for any
> python scripting):
> https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-manpages_url
> 
> But the problem is that it creates links also for non-existing man pages
> (xyzzy(2), xyzzyat(2), fxyzzy(3)) in adding-syscalls.rst. I'll convert them not
> being man pages.

Maybe we could solve that.  Do you have a list of undocumented syscalls?
We could quickly add small manual pages for all of them, documenting
only the SYNOPSIS.

The rest of the documentation could come later, but some documentation
would be better than no documentation.

What do you think?


Have a lovely night!
Alex

> 
> Kind regards,
> Petr

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]