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

[Alejandro Colomar <alx@kernel.org>]

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

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.

I'd recommend being cautious about it.  :)


Have a lovely night!
Alex

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

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