Re: ⟨ vs < in hostname man page of hostname

["G. Branden Robinson" <g.branden.robinson@gmail.com>]

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

Hi Alex & Jonny,

At 2023-08-09T12:16:12+0200, Alejandro Colomar wrote:
> > other times '⟨⟩' .
> 
> When you see that, the page was written properly in man(7) (or
> mdoc(7)? I expect both produce the same glyph; Branden?).

https://git.savannah.gnu.org/cgit/groff.git/tree/tmac/an.tmac?h=1.23.0#n1121

At present, mdoc(7) hyperlinks don't render similarly, but I plan to
make them do so for groff 1.24.

Here's an example.

$ cat EXPERIMENTS/use-Lk.mdoc
.Dd 2023-08-09
.Dt use\-Lk 1
.Os
.Sh Name
.Nm use\-Lk
.Nd demonstrate a hyperlink
.Sh Description
What do man pages look like with
.Lk http://example.com hyperlinks ?

use-Lk(1)                   General Commands Manual                  use-Lk(1)

Name
     use-Lk — demonstrate a hyperlink

Description
     What do man pages look like with hyperlinks: http://example.com?

GNU                               2023‐08‐09                         use-Lk(1)

Except for font styling differences, mandoc(1) renders it the same.

At 2023-08-09T11:39:32+0100, Jonny Grant wrote:
> I'd change the groff configuration to generate the web version of
> those UR on man7.org to be <>. Maybe that's just my preference :)

You can express your preference in groff man(7)'s site-local
configuration.  Its installation location for your system is documented
in groff_man(7).

On my Debian system, it's in /etc/groff/man.local.

Adding the following should do the trick:

.if '\*[.T]'utf8' \{\
.  char \[la] <
.  char \[ra] >
.\}

Regards,
Branden

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