Re: [RFC suggestion] Generate manpage directly with Asciidoctor

From: Jeff King <peff@peff.net>
Date: May 8, 2021, 03:10 UTC
Message-ID: <YJYBOrm2cQkkVteb@coredump.intra.peff.net>
In-Reply-To: <YJXT7AaqCeCV4WcZ@camp.crustytoothpaste.net>

On Fri, May 07, 2021 at 11:57:32PM +0000, brian m. carlson wrote:

Show 10 quoted lines

> It's not quite that simple.  It requires changes to
> asciidoctor-extensions.rb and we also need to consider
> NO_MAN_BOLD_LITERAL and GNU_ROFF.  The latter especially is likely to be
> inconvenient, since according to the Makefile, it's impossible to write
> man output that works across troff versions.
> 
> We will also want to preserve the ability to use xmlto because we
> currently have doc-diff which helps us find divergences in the behavior
> of AsciiDoc and Asciidoctor, many of which affect all formats, and that
> will be completely useless if we use two different rendering toolchains.

Speaking of doc-diff: with that patch applied, try "./doc-diff --asciidoctor HEAD^ HEAD", which shows quite a few of the complications (another one seems to be that all of the linkgit macros are broken).

-Peff