Re: [RFC suggestion] Generate manpage directly with Asciidoctor

From: Felipe Contreras <felipe.contreras@gmail.com>
Date: May 9, 2021, 18:46 UTC
Message-ID: <CAMP44s3wagd6pk-YfnYV3QoRbZ5cRA0MBU4=Mdxerbdx80J7hw@mail.gmail.com>
In-Reply-To: <CAN0heSpN_ieGc2HJCvSsmUuEqS-GGPDcZHz=v2Z3hJY=Or_HMw@mail.gmail.com>

On Sun, May 9, 2021 at 3:26 AM Martin Ågren <martin.agren@gmail.com> wrote:

Show 9 quoted lines

> I think what I'm arguing for is
>
>   1) switch the default to asciidoctor,
>   2) enable optionally using it without xmlto,
>   3) figure out what broke and fix it, and document which is the minimum
>      asciidoctor version we're going to bother with for (2),
>   4) lather, rinse, repeat (3),
>   5) switch the default to not using xmlto,
>   6) drop the xmlto way of generating the manpages(?).

Are there some minimal requirements to say; this documentation was built correctly (as far as we know)? If so, maybe we can add a checker, or perhaps add a test under t/.

Cheers.

-- 
Felipe Contreras