Hello Branden,
On Sun, Mar 12, 2023 at 12:11:15PM -0500, G. Branden Robinson wrote:
> At 2023-03-12T06:23:33+0100, Helge Kreutzmann wrote:
> > Hello Alex,
> > On Sun, Mar 12, 2023 at 12:31:05AM +0100, Alejandro Colomar wrote:
> > > On 3/11/23 18:13, Helge Kreutzmann wrote:
> > > > Without further ado, the following was found:
> > > >
> > > > Issue: mountd(8) → B<mountd>(8)
> > >
> > > We don't use that formatting in example code.
> >
> > I think I saw it elsewhere, but then probably from one of our ~ 100
> > other projects.
> >
> > (And again, for hyperlinking etc. I think it can be helpful; I just
> > checked, even with formatting I can simply copy that code out - so
> > there is not disadvantage?)
>
> I don't have anything quantitative for you, but my impression from my
> own readings in software is that generally, in typeset material, code
> comments don't indulge in much style variation. They might be set
> uniformly in a slanted face, or in proportional typeface where the code
> proper is monospaced, but not much beyond that.
No, the code does not show any URL.
When HTML output is generated, the tools detect the man page reference
and turn it into a hyperlink.
I think Mario (in CC) knows more about it.
So the only idea is to have those tools detect the man page reference.
Greetings
Helge
--
Dr. Helge Kreutzmann debian@xxxxxxxxxxxxx
Dipl.-Phys. http://www.helgefjell.de/debian.php
64bit GNU powered gpg signed mail preferred
Help keep free software "libre": http://www.ffii.de/
Attachment:
signature.asc
Description: PGP signature
