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

[G. Branden Robinson]

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
correct?
 
> 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
necessary.


.\" 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
it.

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

  <https://savannah.gnu.org/bugs/?63768>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/