Re: [PATCH v3 0/3] Documentation: Link man pages to https://man7.org/

[Petr Vorel <pvorel@suse.cz>]

> Hi Jon,

> On Fri, Jan 16, 2026 at 11:29:16AM -0700, Jonathan Corbet wrote:
> > Petr Vorel <pvorel@suse.cz> writes:

> > > Changes v1->v2:
> > > * Remove `...` (italic) from non-existing man pages (Jonathan).
> > > * Squash fix for sp_SP to following commit (Jonathan).
> > > * Remove :manpage: also from fxyzzy(3) (non-existing man page).
> > > * Add CSS for man page.

> > > Link to v2:
> > > https://lore.kernel.org/linux-doc/20260111233534.183272-1-pvorel@suse.cz/

> > > Link to v1:
> > > https://lore.kernel.org/linux-doc/20260109183012.114372-1-pvorel@suse.cz/

> > > Petr Vorel (3):
> > >   Documentation: Remove :manpage: from non-existing man pages
> > >   Documentation: Link man pages to https://man7.org/
> > >   Documentation: CSS: Improve man page font

> > >  Documentation/conf.py                            |  3 +++
> > >  Documentation/process/adding-syscalls.rst        | 16 ++++++++--------
> > >  Documentation/sphinx-static/custom.css           |  8 +++++++-
> > >  .../it_IT/process/adding-syscalls.rst            | 16 ++++++++--------
> > >  .../sp_SP/process/adding-syscalls.rst            | 16 ++++++++--------
> > >  5 files changed, 34 insertions(+), 25 deletions(-)

> > I have applied this set, thanks.

> > Even nicer, of course, would be to have automarkup recognize man-page
> > references and add the links automatically so we wouldn't need the
> > :manpage: noise.  Something for another day, I guess...

> We had some old scripts within the manual pages, which did something
> similar, and they had false positives.  For example, 'exit(1)' is
> ambiguous, since a script can't know if it refers to calling exit(3)
> with value 1, or if it's a reference to the shell builtin.

Ah, so there are false positives.

Kind regards,
Petr

> I'd recommend being cautious about it.  :)


> Have a lovely night!
> Alex