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

[John Gardner]

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

                 Summary: Configurable URL scheme for man page hyperlinks
                 Project: GNU roff
               Submitter: alhadis
               Submitted: Mon 06 Feb 2023 07:36:59 PM AEDT
                Category: Driver grotty
                Severity: 3 - Normal
              Item Group: Feature change
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None


    _______________________________________________________

Follow-up Comments:


-------------------------------------------------------
Date: Mon 06 Feb 2023 07:36:59 PM AEDT By: John Gardner <alhadis>
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)_








    _______________________________________________________

Reply to this item at:

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

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