]>
git.proxmox.com Git - pmg-docs.git/blob - pmg-doc-generator.mk.in
1 # also update debian/changelog
4 DGDIR?
=/usr
/share
/pmg-doc-generator
6 ASCIIDOC_PMG?
=/usr
/bin
/asciidoc-pmg
8 PERL_DOC_ENV
=PMG_GENERATING_DOCS
=1
10 PMG_COMMON_DOC_SOURCES
= \
17 pmgsh
.1-synopsis.adoc
:
18 @echo
'Interactive session:' >$@.tmp
20 @echo
'*pmgsh*' >>$@.tmp
22 @echo
'Directly call API functions:' >>$@.tmp
24 @echo
'*pmgsh* `(get|set|create|help)` `<path>` `[OPTIONS]`' >>$@.tmp
27 pmg-smtp-filter
.8-synopsis.adoc
:
28 @echo
'Please use systemd tools to manage this service.' >$@.tmp
30 @echo
'*systemctl* `(start|stop|restart|reload|status)` `pmg-smtp-filter`' >>$@.tmp
33 pmgpolicy
.8-synopsis.adoc
:
34 @echo
'Please use systemd tools to manage this service.' >$@.tmp
36 @echo
'*systemctl* `(start|stop|restart|reload|status)` `pmgpolicy`' >>$@.tmp
43 %-opts.adoc
: ${DGDIR}/gen-
%-opts.pl
44 $(PERL_DOC_ENV
) perl
-I.
${DGDIR}/gen-
$*-opts.pl
>$@.tmp
47 %.adoc
: ${DGDIR}/gen-
%-adoc.pl
48 $(PERL_DOC_ENV
) perl
-I.
${DGDIR}/gen-
$*-adoc.pl
>$@.tmp
52 $(PERL_DOC_ENV
) perl
-I.
-e
"use PMG::CLI::$(subst -,_,$*);print PMG::CLI::$(subst -,_,$*)->generate_asciidoc_synopsis();" > $@.tmp
56 $(PERL_DOC_ENV
) perl
-I.
-e
"use PMG::Service::$(subst -,_,$*);print PMG::Service::$(subst -,_,$*)->generate_asciidoc_synopsis();" > $@.tmp
60 %.adoc
: ${DGDIR}/%.adoc
66 %-plain.html
: %.adoc
${PMG_COMMON_DOC_SOURCES}
67 ${ASCIIDOC_PMG} compile-wiki
-o
$@
$*.adoc
69 chapter-
%.html
: %.adoc
${PMG_COMMON_DOC_SOURCES}
70 ${ASCIIDOC_PMG} compile-chapter
-o
$@
$*.adoc
72 %.1: %.adoc
%.1-synopsis.adoc
${PMG_COMMON_DOC_SOURCES}
73 ${ASCIIDOC_PMG} compile-man
-o
$@
$*.adoc
74 test -n
"$${NOVIEW}" || man
-l
$@
76 %.1.html
: %.adoc
%.1-synopsis.adoc
${PMG_COMMON_DOC_SOURCES}
77 ${ASCIIDOC_PMG} compile-man-html
-o
$@
$*.adoc
79 %.8: %.adoc
%.8-synopsis.adoc
${PMG_COMMON_DOC_SOURCES}
80 ${ASCIIDOC_PMG} compile-man
-o
$@
$*.adoc
81 test -n
"$${NOVIEW}" || man
-l
$@
83 %.8.html
: %.adoc
%.8-synopsis.adoc
${PMG_COMMON_DOC_SOURCES}
84 ${ASCIIDOC_PMG} compile-man-html
-o
$@
$*.adoc
86 %.5: %.adoc
%.5-opts.adoc
${PMG_COMMON_DOC_SOURCES}
87 ${ASCIIDOC_PMG} compile-man
-o
$@
$*.adoc
88 test -n
"$${NOVIEW}" || man
-l
$@
90 %.5.html
: %.adoc
%.5-opts.adoc
${PMG_COMMON_DOC_SOURCES}
91 ${ASCIIDOC_PMG} compile-man-html
-o
$@
$*.adoc
93 %.5-plain.html
: %.adoc
%.5-opts.adoc
${PMG_COMMON_DOC_SOURCES}
94 ${ASCIIDOC_PMG} compile-man-wiki
-o
$@
$*.adoc
97 .PHONY
: cleanup-docgen
99 rm -f
*.xml.tmp
*.1 *.5 *.8 *.adoc docinfo.xml