Re: [RFC suggestion] Generate manpage directly with Asciidoctor

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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

> 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



[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux