[Top][All Lists]

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

Re: man(7) .TH font change, was: groff man(7) `B` macro...

From: Steffen Nurpmeso
Subject: Re: man(7) .TH font change, was: groff man(7) `B` macro...
Date: Mon, 20 Jun 2022 14:23:58 +0200
User-agent: s-nail v14.9.24-259-ge9cf982228

Ingo Schwarze wrote in
 |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).


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.


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.

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

reply via email to

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