From: Eric Sunshine <sunshine@sunshineco.com>
Date: Wed, 12 May 2021 19:53:09 GMT
Subject: Re: [PATCH 1/2] doc: add an option to have Asciidoctor build man pages directly
Message-ID: <CAPig+cQ6xw_RDmStExWGjmwuQQP+q5F5wCMtrMvtDt4GaAKXUg@mail.gmail.com>
In-Reply-To: <YJt1/DO1cXNTRNxK@coredump.intra.peff.net>

On Wed, May 12, 2021 at 2:30 AM Jeff King <peff@peff.net> wrote:
> The new option enables both asciidoctor as well as its direct-to-manpage
> mode that skips xmlto. This lets you view the rendered difference
> between the two pipelines with something like:
>
>   ./doc-diff --from-asciidoctor --to-asciidoctor-direct HEAD HEAD
>
> Note that we have to add quotes when passing around $makemanflags, as it
> now may contain whitespace due to multiple arguments (but the deference

I suppose you meant s/deference/dereference/ ?

> inside render_tree must remain unquoted, because it wants to perform
> whitespace splitting to get the individual arguments back).
>
> Signed-off-by: Jeff King <peff@peff.net>