Re: [RFC suggestion] Generate manpage directly with Asciidoctor

From: Bagas Sanjaya <bagasdotme@gmail.com>
Date: May 8, 2021, 04:27 UTC
Message-ID: <5130bb11-002c-9aa9-ac6d-11bfd6f85f3f@gmail.com>
In-Reply-To: <6095c74993f19_cfc72085d@natae.notmuch>

On 08/05/21 06.03, Felipe Contreras wrote:
  >> I think we're better to do like this:

Show 10 quoted lines

>>
>> * If we're using asciidoc, we will use xmlto
>> * If we're using asciidoctor, we will generate man-pages with
>>    asciidoctor directly
> 
> This certainly is the way to go.
> 
> I'm not sure if Bagas suggested to make USE_ASCIIDOCTOR=YesPlease the
> default, but first we would need to make sure the output without xmlto
> is desirable, which we don't at the moment.

I'm not aiming for defaulting to AsciiDoctor, but I agree that we would like to migrate away from xmlto by making sure the output sans it is desirable.

> So, even if we were to consider this, *first* the option to use pure
> asciidoctor needs to be in place.

Don't you know there is USE_ASCIIDOCTOR=YesPlease flag which do the job?

-- 
An old man doll... just what I always wanted! - Clara