[Top][All Lists]

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

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

From: G. Branden Robinson
Subject: [bug #63768] Configurable URL scheme for man page hyperlinks
Date: Mon, 6 Feb 2023 13:00:46 -0500 (EST)

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


Message sent via Savannah

reply via email to

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