Ingo Schwarze wrote in
<yq9curagz9ksh...@asta-kit.de>:
|Alejandro Colomar wrote on Sun, Jun 19, 2022 at 04:11:49PM +0200:
|> On 6/19/22 16:00, Ralph Corderoy wrote:
...
|That makes compatibility in man(7) significantly more of a concern
|than in mdoc(7). All the same, i would certainly not consider
|adding anything as disruptive as .MR to mdoc(7).
Just to mention that since 2014 my .Mx mdoc(7) extension is
distributed for the things i use, and i never have heard about an
incompatibility. (Except some Debian manual checker is
complaining on an unknown command.)
It offers table of contents, index, additional free-form anchors,
local and inter-manual page references. It is only restricted due
to the way mdoc(7) is implemented in groff(7), which could be
overcome. Unfortunately the new groff maintainer made the mdoc
macros incompatible with how they were before, so that i did not
port it to >1.22.3 (especially to avoid being trapped in a spiral
of changes needed to follow upstream).
Shall OSC-8 search be accepted in less(1) upstream [1] then
looking at a .Mx enabled manual page in less(1) will be an
interactive experience as if viewing a HTML page in a text-mode
web browser like lynx(1):
. ^O^I text - will search for the OSC 8 id= "text".
. ^O^N - searches for the next OSC 8 link aka URI.
. ^O^P - searches for the previous OSC 8 link aka URI.
. ^O^O - opens the currently selected OSC 8 link aka URI with
the shell command given in the environment variable
LESSOSC8OPEN; it will be passed as a properly quoted single
argument. If LESSOSC8OPEN is not set, "man:NAME((.*))?" style
links are still understood and opened via man(1).
[1] https://github.com/gwsw/less/pull/251
Different to 2014 when i used an incompatible approach to
implement this in less(1), basic OSC-8 support (understand and
ignore) has already been accepted upstream without my assistance.
The manual of mdocmx is at [2], a very (too) large manual using
its powers is [3]. Table of content and all anchors and
references solely come via mdocmx.
[2] https://www.sdaoden.eu/code-mdocmx.html
[3] https://www.sdaoden.eu/code-nail.html
Shall you have my S-nail as your mailx(1), you could do this even
immediately with the local manual page if grotty and less could.
.Mx could be renamed to .Mr it seems. .Mr sounds a bit weird tho.
--steffen
|
|Der Kragenbaer, The moon bear,
|der holt sich munter he cheerfully and one by one
|einen nach dem anderen runter wa.ks himself off
|(By Robert Gernhardt)
