Re: [RFC suggestion] Generate manpage directly with Asciidoctor

[Bagas Sanjaya <bagasdotme@gmail.com>]

On 07/05/21 19.27, Đoàn Trần Công Danh wrote:
> I'm pretty sure xmlto doesn't depend on dblatex and/or texlive.
> 
> I'm building Git and Git's documentation on different Linux boxes with
> asciidoc, most of them don't have dblatex and/or texlive.
> In fact, I only have texlive installed in my laptop.
> 
> I guess you're using Debian or one of its derived distribution?
> Debian puts dblatex as xmlto's rec. [2]
> 
> I think you can use:
> 
> 	apt install --no-install-recommends xmlto
> 
> to avoid those recommendations.
>

Yes, I'm using Ubuntu (derived from Debian).

> Hm, I'm pretty sure Ruby (asciidoctor's language) is very hard to port.
> Last I heard, it's buggy on some platforms.
> 
> I think we're better to do like this:
> 
> * If we're using asciidoc, we will use xmlto
> * If we're using asciidoctor, we will generate man-pages with
>    asciidoctor directly
> 

Nice for your suggestion.

But will the resulting manpage from asciidoc+xmlto and from asciidoctor
syntatically and semantically same?

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