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

[martin%NetBSD.org@localhost]

>Number:         54715
>Category:       toolchain
>Synopsis:       Support a two args Lk tmac directive with optimized html output
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    toolchain-manager
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Sun Nov 24 09:35:00 +0000 2019
>Originator:     Martin Husemann
>Release:        NetBSD 9.99.18
>Organization:
The NetBSD Foundation, Inc.
>Environment:
System: NetBSD seven-days-to-the-wolves.aprisoft.de 9.99.18 NetBSD 9.99.18 (GENERIC) #318: Fri Nov 22 11:38:50 CET 2019 martin%seven-days-to-the-wolves.aprisoft.de@localhost:/work/src/sys/arch/amd64/compile/GENERIC amd64
Architecture: x86_64
Machine: amd64
>Description:

To improve the quality of our release notes, especially in the HTML version,
it would be great to have a variant of the Lk (link) macro that could
generate short links for html output but still create readable ascii/more
output.

Example current code:

Check the list of
.Nx
mirrors at
.Lk https://www.NetBSD.org/mirrors
for details.
.Pp

This creates:

  Check the list of
  NetBSD
  mirrrors at
  <a href="https://www.NetBSD.org/mirrors";>https://www.NetBSD.org/mirrors</a>
  for details.

which (in a browser) is unpleasant to read. Better would be somethink like:


Check the list of
.Nx
.Lk https://www.NetBSD.org/mirrors mirrors
for details.
.Pp

that could generate in html:

  Check the list of
  NetBSD
  <a href="https://www.NetBSD.org/mirrors";>mirrors</a>
  for details.

or in ascii:

  Check the list of NetBSD mirrors [https://www.NetBSD.org/mirrors]
  for details.


>How-To-Repeat:
s/a

>Fix:
n/a