diff --git a/tmac/an.tmac b/tmac/an.tmac index a00340573..4fa7451b2 100644 --- a/tmac/an.tmac +++ b/tmac/an.tmac @@ -1,6 +1,6 @@ .\" groff implementation of man(7) package .\" -.\" Copyright (C) 1989-2022 Free Software Foundation, Inc. +.\" Copyright (C) 1989-2023 Free Software Foundation, Inc. .\" Written by James Clark (jjc@jclark.com) .\" Enhanced by: Werner Lemberg .\" Larry Kollar @@ -1161,17 +1161,30 @@ contains unsupported escape sequence . rm an*prefix .. . +.\" There is no standardized scheme for man pages, but this is expected +.\" to work (or be harmlessly ignored) everywhere except macOS. +.\" Override in man.local if desired. +.nr an*MR-URL-format 1 +. .\" Set a man page cross reference. .\" .MR page-topic page-section [trailing-text] .de1 MR . if ((\\n[.$] < 2) : (\\n[.$] > 3)) \ . an-style-warn .\\$0 expects 2 or 3 arguments, got \\n[.$] +. if (\\n[an*MR-URL-format] = 1) \ +. ds an*url man:\\$1(\\$2)\" used everywhere but macOS +. if (\\n[an*MR-URL-format] = 2) \ +. ds an*url man:\\$1.\\$2\" Bwana (macOS) +. if (\\n[an*MR-URL-format] = 3) \ +. ds an*url x-man-doc://\\$2/\\$1(\\$2)\" ManOpen (macOS) +. if (\\n[an*MR-URL-format] = 4) \ +. ds an*url x-man-page://\\$2/\\$1\" Terminal.app (macOS) . nh . if \\n[an*do-hyperlink] \{\ . if \\n[an*is-output-html] \ -. nop \X^html:^\c +. nop \X^html:^\c . if \\n[an*is-output-terminal] \ -. nop \X^tty: link man:\\$1(\\$2)^\c +. nop \X^tty: link \\*[an*url]^\c . \} . nop \&\\*[an-lic]\f[\\*[MF]]\\$1\\*[an-ic]\f[R](\\$2)\c . if \\n[an*do-hyperlink] \{\ diff --git a/tmac/man.local b/tmac/man.local index ed5706b41..ff7159ac3 100644 --- a/tmac/man.local +++ b/tmac/man.local @@ -14,6 +14,16 @@ .\" might prefer to remap it to bold ("B") instead. .\" .if n .ftr CW R .\" +.\" A de facto standard URL format for man pages is recognized +.\" everywhere except Apple, where three different macOS applications +.\" each expect a different format. +.\" 1: man:groff(1) -- used everywhere but macOS +.\" 2: man:groff.1 -- Bwana (macOS) +.\" 3: x-man-doc://1/groff(1) -- ManOpen (macOS) +.\" 4: x-man-page://1/groff -- Terminal.app (macOS) +.\" Set this register to configure which the `MR` macro uses. +.\" .nr an*MR-URL-format 1 +.\" .\" Local Variables: .\" mode: nroff .\" fill-column: 72