Mirrors/criu
1
0
Fork 0
mirror of https://github.com/checkpoint-restore/criu.git synced 2026-01-23 02:14:37 +00:00
Code Issues Projects Releases Wiki Activity

Documentation: Allow to use asciidoctor for formatting man pages

Browse source 
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@suse.de>
Signed-off-by: Andrei Vagin <avagin@gmail.com>
This commit is contained in:
Takashi Iwai 2019-01-16 17:14:37 +01:00 • committed by Andrei Vagin
parent f73e5d181b
commit 0493724c8e
3 changed files with 31 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

9
scripts/nmk/Documentation/Makefile
View file

@ -1,5 +1,10 @@
ifneq ($(USE_ASCIIDOCTOR),)
ASCIIDOC := asciidoctor
XMLTO :=
else
ASCIIDOC := asciidoc
XMLTO := xmlto
endif
PS2PDF := ps2pdf
SRC += nmk.txt
@ -25,8 +30,12 @@ check:
%.8: %.txt
$(call msg-gen, $@)
ifneq ($(USE_ASCIIDOCTOR),)
$(Q) $(ASCIIDOC) -b manpage -d manpage -o $@ $<
else
$(Q) $(ASCIIDOC) -b docbook -d manpage -o $(patsubst %.8,%.xml,$@) $<
$(Q) $(XMLTO) man --skip-validation $(patsubst %.8,%.xml,$@) 2>/dev/null
endif
%.ps: %.8
$(call msg-gen, $@)