docs/man/asciidoc.conf, NEWS.adoc: fix generation of links to external manual pages [follow-up to #2797]

Signed-off-by: Jim Klimov <jimklimov+nut@gmail.com>

Author: jimklimov

NEWS.adoc

@@ -299,6 +299,10 @@ https://github.com/networkupstools/nut/milestone/9
    build times. Default activity for developer builds should remain as
    it was -- to try each such "axis" sequentially. [#2973]
 
+ - Revised generation of links to external manual pages in HTML rendering
+   of NUT manual pages (previous recipe iterations left DocBook XML `ulink`
+   tag "as is", which was not understood by web browsers).
+
  - Revised `make install-as-root` to fall back to legacy ways of enabling
    services, if `systemctl preset-all` fails (assumed due to a systemd 252
    bug). [#3022]

docs/man/asciidoc.conf

@@ -4,14 +4,16 @@
 # Usage: linkman:command[manpage-section]
 # Usage: linkman2:command-page[displayed-command,manpage-section]
 #
-# Note:
+# Notes:
 # - in linkman, {0} is the manpage section, while {target} is the command.
 # - in linkman2, {0} is the whole list of attributes, {1} is the command to be
 #   shown, {2} is the manpage section, while {target} is the command page.
 # - linkmanext and linkmanext2 macros repeat the behavior of the default ones.
 #   These macros are intended for system man pages (e.g. HTML links might lead
 #   to a generic internet site, or possibly to a distro-provided library
 #   online or locally).
+# - UNLIKE docs/asciidoc.conf we should not use "ulink" here, otherwise it
+#   goes "as is" into the generated HTML (and is not understood by browsers)!
 
 #
 # Show NUT link as: <command>(<section>); if section is defined, else just show
@@ -54,9 +56,11 @@ ifdef::backend-xhtml11[]
 # FIXME: Allow to define external man page URL structure and whether
 #  sections should change via configure script options:
 [linkmanext-inlinemacro]
-<ulink url="https://linux.die.net/man/{0}/{target}">{target}{0?({0})}</ulink>
+<a href="https://linux.die.net/man/{0}/{target}">{target}{0?({0})}</a>
+#<ulink url="https://linux.die.net/man/{0}/{target}">{target}{0?({0})}</ulink>
 [linkmanext2-inlinemacro]
-<ulink url="https://linux.die.net/man/{2}/{target}">{1={target}}{2?({2})}</ulink>
+<a href="https://linux.die.net/man/{2}/{target}">{1={target}}{2?({2})}</a>
+#<ulink url="https://linux.die.net/man/{2}/{target}">{1={target}}{2?({2})}</ulink>
 # Override HTML footer, to include NUT version
 [footer-text]
 Last updated {docdate} {doctime} -- Network UPS Tools {nutversion}

docs/nut.dict

@@ -1,4 +1,4 @@
-personal_ws-1.1 en 3530 utf-8
+personal_ws-1.1 en 3531 utf-8
 AAC
 AAS
 ABI
@@ -3293,6 +3293,7 @@ uid
 uint
 ukUNV
 ul
+ulink
 un
 uname
 uncomment