Re: toolchain/54715: Support a two args Lk tmac directive with optimized html output

[Ingo Schwarze <schwarze%usta.de@localhost>]

The following reply was made to PR toolchain/54715; it has been noted by GNATS.

From: Ingo Schwarze <schwarze%usta.de@localhost>
To: gnats-bugs%netbsd.org@localhost
Cc: wiz%netbsd.org@localhost, martin%netbsd.org@localhost
Subject: Re: toolchain/54715: Support a two args Lk tmac directive with
 optimized html output
Date: Sun, 24 Nov 2019 15:27:47 +0100

 Hello Martin and Thomas,
 
 i'm not quite sure what you are asking for.  As far as i can see,
 mandoc(1) already does almost exactly what you want:
 
    $ cat tmp.txt                                                  
   Check the list of
   .Nx
   .Lk https://www.NetBSD.org/mirrors mirrors
   for details.
 
    $ mandoc -mdoc -Thtml tmp.txt 
   [...]
   <div class="manual-text">Check the list of <span class="Ux">NetBSD</span>
   <a class="Lk" href="https://www.NetBSD.org/mirrors";>mirrors</a> for
   details.</div>
 
    $ mandoc -mdoc -Tascii tmp.txt
   [...]
   Check the list of NetBSD mirrors: https://www.NetBSD.org/mirrors
   for details.
 
 What exactly is wrong with that?
 
 Note that for the example given above and for similar examples that
 don't go out of their way to uncover groff or mandoc bugs, mandoc
 and groff -T ascii output is byte-by-byte identical, so what you are
 asking for is even reasonably portable.
 
 I tested the above on OpenBSD-current and don't have a NetBSD system
 for comparison, but as far as i'm aware (http://mandoc.bsd.lv/ports.html),
 the NetBSD version of mandoc(1) is perfectly up-to-date (not so for
 apropos(1), but that doesn't matter in this case), so it ought to
 work in just the same way.  Does it?
 
 Yours,
   Ingo