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

[Alejandro Colomar <alx@kernel.org>]

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

On Mon, Jan 12, 2026 at 12:29:15AM +0100, Petr Vorel wrote:
> > 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?
> 
> IMHO these xyzzy(2), xyzzyat(2), fxyzzy(3) are examples for new syscalls
> (like "foo" and "bar" or example.org). I don't think it'd be good to create a
> real man page for them. Instead I just remove :manpage: from them.

Ahh, okay.  Makes sense.


Cheers,
Alex

> 
> Kind regards,
> Petr
> 
> 
> > Have a lovely night!
> > Alex
> 
> 
> > > Kind regards,
> > > Petr

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

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