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: Martin Husemann <martin%duskware.de@localhost>
Cc: gnats-bugs%netbsd.org@localhost, wiz%netbsd.org@localhost
Subject: Re: toolchain/54715: Support a two args Lk tmac directive with
 optimized html output
Date: Sun, 24 Nov 2019 17:01:00 +0100

 Hi Martin,
 
 Martin Husemann wrote on Sun, Nov 24, 2019 at 03:59:01PM +0100:
 > On Sun, Nov 24, 2019 at 03:27:47PM +0100, Ingo Schwarze wrote:
 
 >> 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:
 
 > Yeah, but we do not use mandoc for our release notes
 
 Why not?  What do you use instead?
 
 > (which is where I'd like to use it).
 > 
 > I expected that kind of output from the 2-args invocation of .Lk, but
 > it uses the first arg for the anchor text.
 
 What does "it" in "it uses" refer to?
 Mandoc certainly does not use the first arg for the anchor text:
 
    $ echo .Lk first second | mandoc -mdoc -Thtml | grep href
   <div class="manual-text"><a class="Lk" href="first">second</a></div>
 
 Mandoc uses the first arg as the URI and the second as the displayed
 text that the user is supposed to click on.
 
 I'm trying to figure out what needs to be improved in mandoc(1),
 or what kind of help you need for using or integrating it...
 
 Yours,
   Ingo