[bug #63768] Configurable URL scheme for man page hyperlinks

[G. Branden Robinson]

Update of bug #63768 (project groff):

                  Status:                    None => In Progress            
             Assigned to:                    None => gbranden               
         Planned Release:                    None => 1.23.0                 

    _______________________________________________________

Follow-up Comment #1:

[comment #0 original submission:]
> On macOS, a non-standard URL scheme
<https://github.com/donmccaughey/ManOpen/blob/04cfb7567a8dd6c9ed286ab6a3dd1a69183d259d/Documentation/x-man-page_URL_Scheme.md>
exists to open man pages in Terminal.app
<https://en.wikipedia.org/wiki/Terminal_%28macOS%29>, the default terminal
emulator on macOS. This feature dates as far back as OS/X 10.3 (October 2003),
and is even present in touch-bars on recent MacBooks (watch a demo
<https://youtube.com/shorts/pJViyi3WtkA>). Apple's scheme uses the format
*"x-man-page://section/topic"*, whereas Groff uses the arguably-superior
*"man:name(section)"* format instead.
> 
> Ideally, the exact URL scheme should be configurable locally, such that any
of the following scheme formats can be used:
> 
> 
> man:printf.3
> man:printf(3)
> x-man-doc://3/printf(3)
> x-man-page://3/printf
> x-man://printf.3
> 
> 
> _(Follow-up to a mailing-list post
<https://lists.gnu.org/archive/html/groff/2023-02/msg00013.html> submitted
earlier today)_
> 

Thanks, John.

Let me go ahead and quote your email for posterity.

> It's indicative of a much larger issue — there's no formal, standardised
> scheme for man page URLs. I encountered many variants
>
<https://github.com/Alhadis/Roff.js/blob/ba9b904b944c028033b4b4f584521436a34a5d57/lib/utils/general.mjs#L15-L23>
> whilst working on Roff.js:
> 
> man:name.section          - Bwana        (macOS)
> man:name(section)         - GNOME, KDE   (Linux)
> x-man-doc://3/printf(3)   - ManOpen      (macOS)
> x-man-page://section/name - Terminal.app (macOS 10.3+)

It really looks to me like macOS doesn't have its story straight here.


    _______________________________________________________

Reply to this item at:

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

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