Package: asciidoctor
Version: 2.0.10-2
Severity: normal
Tags: upstream

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>
....

Attachment: signature.asc
Description: PGP signature

Reply via email to