[CRIU] [PATCH 2/2] Documentation: Allow to use asciidoctor for formatting man pages

Takashi Iwai tiwai at suse.de
Wed Jan 16 13:35:20 MSK 2019


On Wed, 16 Jan 2019 11:05:29 +0100,
Radostin Stoyanov wrote:
> 
> On 16/01/2019 09:27, Takashi Iwai wrote:
> > Since asciidoc is based on Phyton 2, we want to move to alternative,
> > and a promising one is asciidoctor.  This patch allows to use
> > asciidoctor for formatting man pages instead of asiidoc, by passing
> > a make option, USE_ASCIIDOCTOR=yes.
> >
> > Although asciidoctor is almost compatible with asciidoc, it can
> > produce a man page directly from a text file without XML, which is
> > more efficiently.  So in asciidoctor mode, we don't require xmlto.
> >
> > Signed-off-by: Takashi Iwai <tiwai at suse.de>
> > ---
> >  Documentation/Makefile | 13 +++++++++++++
> >  1 file changed, 13 insertions(+)
> This is a very good idea!
> 
> Could you also update the following files to use/install 'asciidoctor'
> instead of 'asciidoc'?
> 
> - test/others/bers/Makefile
> - scripts/travis/travis-tests
> - scripts/nmk/Documentation/Makefile
> - scripts/build/Dockerfile.centos
> - scripts/build/Dockerfile.alpine
> - scripts/build/Dockerfile.fedora.tmpl

OK, I'm going to add the changes to these Makefiles that were
overlooked, but somehow hesitate to change the default behavior, as
I'm not sure how well asciidoctor is supported on each distro at all.

I'll leave travis and docker stuff as is for now, while will resend v2
patches soon later.


thanks,

Takashi


More information about the CRIU mailing list