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

[Petr Vorel <pvorel@suse.cz>]

> 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.

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...

Ah, you don't like :manpage: in the rst sources. I try to look into it later.

It looked to me safer than regexp, but hopefully any word following by \([1-8]\)
should be a man page.

Advantage would be that other man pages yet declared would be matched [1],
although some [2] would require to remove code formatting (``...``).

Kind regards,
Petr

[1] https://docs.kernel.org/admin-guide/LSM/Smack.html#file-system-interfaces
[2] https://docs.kernel.org/bpf/prog_cgroup_sysctl.html#context

> Thanks,

> jon