RE: [RFC suggestion] Generate manpage directly with Asciidoctor

From: Randall S. Becker <rsbecker@nexbridge.com>
Date: May 7, 2021, 12:02 UTC
Message-ID: <00db01d74338$d45615c0$7d024140$@nexbridge.com>
In-Reply-To: <3461c7b0-594d-989e-3048-2fc6583084ad@gmail.com>

On May 7, 2021 2:07 AM, Bagas Sanjaya wrote:

Show 14 quoted lines

>To: Git Users <git@vger.kernel.org>
>Subject: [RFC suggestion] Generate manpage directly with Asciidoctor
>Asciidoctor has support for directly generating manpage, see [1].
>
>We support using Asciidoctor as drop-in replacement for original Asciidoc, but
>currently we need to use xmlto together with Asciidoc(tor) to produce
>manpages. However, most users don't inclined to install xmlto toolchain, partly
>because they had to download more than 300 MB of data just to install xmlto
>and its dependencies (including dblatex and texlive).
>
>So completely migrating to Asciidoctor can eliminate xmlto requirement for
>generating manpage.
>
>What do you think about above?

Our toolchain does not support asciidoctor itself because of porting issues. I am not sure it is available everywhere.

-Randall

-- Brief whoami: NonStop developer since approximately 211288444200000000 UNIX developer since approximately 421664400 -- In my real life, I talk too much.