[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[bug #63768] want configurable URL format for man page hyperlinks

From: G. Branden Robinson
Subject: [bug #63768] want configurable URL format for man page hyperlinks
Date: Fri, 17 Feb 2023 03:49:01 -0500 (EST)

Follow-up Comment #13, bug #63768 (project groff):

[comment #12 comment #12:]
> If you're adamant about keeping the current approach,

I wouldn't say "adamant"...but pretty resolved on letting groff 
1.23.0 gather some feedback on the feature.

Keep in mind that 'an*MR-URL-format' is not documented and, I hope, fairly
obviously internal since it looks nothing like the strings and registers
documented in groff_man(7).

> then I recommend that you enumerate the supported URL formats in their order
of priority:
> * man:grep(1)
> * x-man-page://1/grep
> * man:grep.1
> * x-man-doc://1/grep

This is a good suggestion.  I'm happy to do this.  Some questions.

A. Can you clarify that both Terminal.app and iTerm support the second one?

B. That last one--in email you documented it as "x-man-doc://1/groff(1)"
(ManOpen), complete with the redundant parenthesized suffix.  Which is
> Moreover, I'd begin counting from 0 instead of 1, so that we're not reliant
on the existence of the \n[an*MR-URL-format] register.

The macro package defines it unconditionally anyway, so I don't see why that's

.\" There is no standardized format for man page URLs, but the default
.\" is expected to work (or be harmlessly ignored) everywhere except
.\" macOS.  Override in man.local if desired.                            
.nr an*MR-URL-format 1

It seems useful to let a value of 0 mean "I don't know what the F you're
talking about", which will be true of other implementations, particularly
since the zero-interpolation-for-undefined-registers language rule suggests

> I'm still uncomfortable with this approach, however.

I would love for Apple's terminal emulators to support "man:page(section)".  I
would then happily rip this feature out entirely and never miss it.


Reply to this item at:


Message sent via Savannah

reply via email to

[Prev in Thread] Current Thread [Next in Thread]