1 # also update debian/changelog
4 DGDIR?
=/usr
/share
/pve-doc-generator
6 ASCIIDOC_PVE?
=/usr
/bin
/asciidoc-pve
8 PERL_DOC_ENV
=PVE_GENERATING_DOCS
=1
9 PERL_DOC_INC_DIRS
:=${PERL_DOC_INC_DIRS} .
10 PERL_DOC_INC
=$(foreach dir,${PERL_DOC_INC_DIRS},-I
${dir})
12 PVE_COMMON_DOC_SOURCES
= \
19 attributes.txt docinfo.xml pmxcfs
.8-synopsis.adoc
:
23 %-opts.adoc
: ${DGDIR}/gen-
%-opts.pl
24 $(PERL_DOC_ENV
) perl
${PERL_DOC_INC} ${DGDIR}/gen-
$*-opts.pl
>$@.tmp
27 %.adoc
: ${DGDIR}/gen-
%-adoc.pl
28 $(PERL_DOC_ENV
) perl
${PERL_DOC_INC} ${DGDIR}/gen-
$*-adoc.pl
>$@.tmp
31 pveperf
.1-synopsis.adoc
:
32 echo
'*pveperf* `[PATH]`' > pveperf
.1-synopsis.adoc
35 $(PERL_DOC_ENV
) perl
${PERL_DOC_INC} -e
"use PVE::CLI::$(subst -,_,$*);print PVE::CLI::$(subst -,_,$*)->generate_asciidoc_synopsis();" > $@.tmp
39 $(PERL_DOC_ENV
) perl
${PERL_DOC_INC} -e
"use PVE::Service::$(subst -,_,$*);print PVE::Service::$(subst -,_,$*)->generate_asciidoc_synopsis();" > $@.tmp
43 %.adoc
: ${DGDIR}/%.adoc
49 %-plain.html
: %.adoc
${PVE_COMMON_DOC_SOURCES}
50 ${ASCIIDOC_PVE} compile-wiki
-o
$@
$*.adoc
52 chapter-
%.html
: %.adoc
${PVE_COMMON_DOC_SOURCES}
53 ${ASCIIDOC_PVE} compile-chapter
-o
$@
$*.adoc
55 %.1: %.adoc
%.1-synopsis.adoc
${PVE_COMMON_DOC_SOURCES}
56 ${ASCIIDOC_PVE} compile-man
-o
$@
$*.adoc
57 test -n
"$${NOVIEW}" || man
-l
$@
59 %.1.html
: %.adoc
%.1-synopsis.adoc
${PVE_COMMON_DOC_SOURCES}
60 ${ASCIIDOC_PVE} compile-man-html
-o
$@
$*.adoc
62 %.8: %.adoc
%.8-synopsis.adoc
${PVE_COMMON_DOC_SOURCES}
63 ${ASCIIDOC_PVE} compile-man
-o
$@
$*.adoc
64 test -n
"$${NOVIEW}" || man
-l
$@
66 %.8.html
: %.adoc
%.8-synopsis.adoc
${PVE_COMMON_DOC_SOURCES}
67 ${ASCIIDOC_PVE} compile-man-html
-o
$@
$*.adoc
69 %.5: %.adoc
%.5-opts.adoc
${PVE_COMMON_DOC_SOURCES}
70 ${ASCIIDOC_PVE} compile-man
-o
$@
$*.adoc
71 test -n
"$${NOVIEW}" || man
-l
$@
73 %.5.html
: %.adoc
%.5-opts.adoc
${PVE_COMMON_DOC_SOURCES}
74 ${ASCIIDOC_PVE} compile-man-html
-o
$@
$*.adoc
76 %.5-plain.html
: %.adoc
%.5-opts.adoc
${PVE_COMMON_DOC_SOURCES}
77 ${ASCIIDOC_PVE} compile-man-wiki
-o
$@
$*.adoc
80 .PHONY
: cleanup-docgen
82 rm -f
*.xml.tmp
*.1 *.5 *.8 *.adoc docinfo.xml