#961384 asciidoctor: manpage links in a manpage are rendered in a weird way

Package:
asciidoctor
Source:
asciidoctor
Submitter:
Christoph Biedl
Date:
2023-10-26 17:36:04 UTC
Severity:
normal
Tags:
#961384#5
Date:
2020-05-23 20:28:03 UTC
From:
To:
Dear Maintainer,

ASCIIPATIENT(1)
===============

NAME
----
asciipatient - manpage links in a manpage are rendered in a weird way


DESCRIPTION
-----------

Observed in one of the packages I maintain: The links to other manpages
in the adoc provided by upstream are rendered in a unsual and
irritating way.

It is possible upstream did a bad job here - but all I can tell is
using the old a2x yields a sound result. In case this is just bad
adoc style - I could use a pointer to the documentation where this is
described. Read: While asciidoctor has a lot of documentation, I
constantly fail to find the bits I need to got something done.


HOW TO REPEAT
-------------

Run this document through "asciidoctor --backend manpage", then execute
"man ./asciipatient.1". Compare with the result of "a2x -f manpage".


SEE ALSO
--------

link:asciidoctor.1.adoc[*asciidoctor*(1)]


EXPECTED
--------

....
SEE ALSO
       asciidoctor(1)
....


GOT
---

....
SEE ALSO
       asciidoctor(1) <asciidoctor.1.adoc>
....