Re: [PATCH v2 2/3] Documentation: Remove :manpage: from non-existing man pages

[Alejandro Colomar <alx@kernel.org>]

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

Hi Petr,

On Tue, Jan 13, 2026 at 12:00:53PM +0100, Petr Vorel wrote:
[...]
> > > -If your new :manpage:`xyzzy(2)` system call does return a new file descriptor,
> > > +If your new `xyzzy(2)` system call does return a new file descriptor,
> 
> > Here, once again, you're retaining the backticks.  If we need to mark up
> > those references at all, they should be ``literal``.
> 
> I'm sorry to keep the same mistake. BTW I did not notice because both real man
> pages a) without manpages_url:
> 
> <em class="manpage">read(2)</em>
> 
> b) with manpages_url:
> 
> <em class="manpage">
> <a class="manpage reference external" href="https://man7.org/linux/man-pages/man8/auditctl.8.html">auditctl(8)</a>
> </em>
> 
> don't have specified CSS. And because my browser default has font-style: italic
> for <em>, I don't see any difference for :manpage:`read(2)` and `read(2)`.
> 
> BTW I'll add in v3 CSS font-family: ..., monospace for manpages.

FWIW, in the Linux man-pages project, we currently use bold with
proportional font for manual page references, and will soon change to
italics with proportional font.  We don't use monospace (when formatting
in PDF, of course).


Have a lovely day!
Alex

> > (If you simply remove the backticks, you might run into conflict with
> > automarkup, though I *think* that the section number will evade its
> > regexp).
> 
> In my local build plain fxyzzy(3) without backticks works. I slightly prefer to
> not use double ``.
> 
> Kind regards,
> Petr
> 
> > Thanks,
> 
> > jon

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

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