1 # also update debian/changelog
4 DGDIR?
=/usr
/share
/pve-doc-generator
8 PVE_COMMON_DOC_SOURCES
= \
15 pvecm
.1-synopsis.adoc \
16 ${PVE_COMMON_DOC_SOURCES}
18 PVE_FIREWALL_MAN8_SOURCES
= \
20 pve-firewall
.8-synopsis.adoc \
21 pve-firewall-cluster-opts.adoc \
22 pve-firewall-host-opts.adoc \
23 pve-firewall-vm-opts.adoc \
24 pve-firewall-rules-opts.adoc \
25 pve-firewall-macros.adoc \
26 ${PVE_COMMON_DOC_SOURCES}
30 pvesm
.1-synopsis.adoc \
31 pve-storage-dir.adoc \
32 pve-storage-glusterfs.adoc \
33 pve-storage-iscsi.adoc \
34 pve-storage-iscsidirect.adoc \
35 pve-storage-lvm.adoc \
36 pve-storage-nfs.adoc \
37 pve-storage-rbd.adoc \
38 pve-storage-zfspool.adoc \
39 ${PVE_COMMON_DOC_SOURCES}
41 VZDUMP_MAN1_SOURCES
= \
43 vzdump
.1-synopsis.adoc \
44 ${PVE_COMMON_DOC_SOURCES}
46 PVESUBSCRIPTION_MAN1_SOURCES
= \
47 pvesubscription.adoc \
48 pvesubscription
.1-synopsis.adoc \
49 ${PVE_COMMON_DOC_SOURCES}
54 ${PVE_COMMON_DOC_SOURCES}
56 PCT_CONF_MAN5_SOURCES
= \
58 pct.conf
.5-opts.adoc \
59 ${PVE_COMMON_DOC_SOURCES}
61 DATACENTER_CONF_MAN5_SOURCES
= \
63 datacenter.cfg
.5-opts.adoc \
64 ${PVE_COMMON_DOC_SOURCES}
69 ${PVE_COMMON_DOC_SOURCES}
71 QM_CONF_MAN5_SOURCES
= \
74 ${PVE_COMMON_DOC_SOURCES}
76 QMRESTORE_MAN1_SOURCES
= \
78 qmrestore
.1-synopsis.adoc \
79 ${PVE_COMMON_DOC_SOURCES}
83 pveum
.1-synopsis.adoc \
84 ${PVE_COMMON_DOC_SOURCES}
88 pveam
.1-synopsis.adoc \
89 ${PVE_COMMON_DOC_SOURCES}
91 HA_MANAGER_MAN1_SOURCES
= \
93 ha-manager
.1-synopsis.adoc \
94 ${PVE_COMMON_DOC_SOURCES}
96 PVE_HA_CRM_MAN8_SOURCES
= \
98 pve-ha-crm
.8-synopsis.adoc \
99 ${PVE_COMMON_DOC_SOURCES}
101 PVE_HA_LRM_MAN8_SOURCES
= \
103 pve-ha-lrm
.8-synopsis.adoc \
104 ${PVE_COMMON_DOC_SOURCES}
106 PVESTATD_MAN8_SOURCES
= \
108 pvestatd
.8-synopsis.adoc \
109 ${PVE_COMMON_DOC_SOURCES}
111 PVEDAEMON_MAN8_SOURCES
= \
113 pvedaemon
.8-synopsis.adoc \
114 ${PVE_COMMON_DOC_SOURCES}
116 PVEPROXY_MAN8_SOURCES
= \
118 pveproxy
.8-synopsis.adoc \
119 ${PVE_COMMON_DOC_SOURCES}
121 SPICEPROXY_MAN8_SOURCES
= \
123 spiceproxy
.8-synopsis.adoc \
124 ${PVE_COMMON_DOC_SOURCES}
126 PMXCFS_MAN8_SOURCES
= \
129 ${PVE_COMMON_DOC_SOURCES}
131 attributes.txt docinfo.xml
:
132 cp
${DGDIR}/$@
$@.tmp
135 %-opts.adoc
: ${DGDIR}/gen-
%-opts.pl
136 ${DGDIR}/gen-
$*-opts.pl
>$@.tmp
139 %.adoc
: ${DGDIR}/gen-
%-adoc.pl
140 ${DGDIR}/gen-
$*-adoc.pl
>$@.tmp
144 perl
-I.
-e
"use PVE::CLI::$(subst -,_,$*);print PVE::CLI::$(subst -,_,$*)->generate_asciidoc_synopsys();" > $@.tmp
148 perl
-I.
-e
"use PVE::Service::$(subst -,_,$*);print PVE::Service::$(subst -,_,$*)->generate_asciidoc_synopsys();" > $@.tmp
152 %.adoc
: ${DGDIR}/%.adoc
157 A2X_MAN_COMMON_OPTIONS
=-a docinfo1
-a
"manversion=Release ${DOCRELEASE}" -f manpage
158 A2X_MAN1_OPTIONS
=${A2X_MAN_COMMON_OPTIONS} -a
"manvolnum=1"
159 A2X_MAN5_OPTIONS
=${A2X_MAN_COMMON_OPTIONS} -a
"manvolnum=5"
160 A2X_MAN8_OPTIONS
=${A2X_MAN_COMMON_OPTIONS} -a
"manvolnum=8"
162 pve-firewall
.8: ${PVE_FIREWALL_MAN8_SOURCES}
163 a2x
${A2X_MAN8_OPTIONS} pve-firewall.adoc
164 test -n
"$${NOVIEW}" || man
-l
$@
166 pvesm
.1: ${PVESM_MAN1_SOURCES}
167 a2x
${A2X_MAN1_OPTIONS} pvesm.adoc
168 test -n
"$${NOVIEW}" || man
-l
$@
170 pct
.1: ${PCT_MAN1_SOURCES}
171 a2x
${A2X_MAN1_OPTIONS} pct.adoc
172 test -n
"$${NOVIEW}" || man
-l
$@
174 vzdump
.1: ${VZDUMP_MAN1_SOURCES}
175 a2x
${A2X_MAN1_OPTIONS} vzdump.adoc
176 test -n
"$${NOVIEW}" || man
-l
$@
178 pvesubscription
.1: ${PVESUBSCRIPTION_MAN1_SOURCES}
179 a2x
${A2X_MAN1_OPTIONS} pvesubscription.adoc
180 test -n
"$${NOVIEW}" || man
-l
$@
182 qm
.1: ${QM_MAN1_SOURCES}
183 a2x
${A2X_MAN1_OPTIONS} qm.adoc
184 test -n
"$${NOVIEW}" || man
-l
$@
186 qmrestore
.1: ${QMRESTORE_MAN1_SOURCES}
187 a2x
${A2X_MAN1_OPTIONS} qmrestore.adoc
188 test -n
"$${NOVIEW}" || man
-l
$@
190 pvecm
.1: ${PVECM_MAN1_SOURCES}
191 a2x
${A2X_MAN1_OPTIONS} pvecm.adoc
192 test -n
"$${NOVIEW}" || man
-l
$@
194 pveum
.1: ${PVEUM_MAN1_SOURCES}
195 a2x
${A2X_MAN1_OPTIONS} pveum.adoc
196 test -n
"$${NOVIEW}" || man
-l
$@
198 pveam
.1: ${PVEAM_MAN1_SOURCES}
199 a2x
${A2X_MAN1_OPTIONS} pveam.adoc
200 test -n
"$${NOVIEW}" || man
-l
$@
202 ha-manager
.1: ${HA_MANAGER_MAN1_SOURCES}
203 a2x
${A2X_MAN1_OPTIONS} ha-manager.adoc
204 test -n
"$${NOVIEW}" || man
-l
$@
206 pve-ha-crm
.8: ${PVE_HA_CRM_MAN8_SOURCES}
207 a2x
${A2X_MAN8_OPTIONS} manpage pve-ha-crm.adoc
208 test -n
"$${NOVIEW}" || man
-l
$@
210 pve-ha-lrm
.8: ${PVE_HA_LRM_MAN8_SOURCES}
211 a2x
${A2X_MAN8_OPTIONS} pve-ha-lrm.adoc
212 test -n
"$${NOVIEW}" || man
-l
$@
214 pvestatd
.8: ${PVESTATD_MAN8_SOURCES}
215 a2x
${A2X_MAN8_OPTIONS} pvestatd.adoc
216 test -n
"$${NOVIEW}" || man
-l
$@
218 pvedaemon
.8: ${PVEDAEMON_MAN8_SOURCES}
219 a2x
${A2X_MAN8_OPTIONS} pvedaemon.adoc
220 test -n
"$${NOVIEW}" || man
-l
$@
222 pveproxy
.8: ${PVEPROXY_MAN8_SOURCES}
223 a2x
${A2X_MAN8_OPTIONS} pveproxy.adoc
224 test -n
"$${NOVIEW}" || man
-l
$@
226 spiceproxy
.8: ${SPICEPROXY_MAN8_SOURCES}
227 a2x
${A2X_MAN8_OPTIONS} spiceproxy.adoc
228 test -n
"$${NOVIEW}" || man
-l
$@
230 pmxcfs
.8: ${PMXCFS_MAN8_SOURCES}
231 a2x
${A2X_MAN8_OPTIONS} pmxcfs.adoc
232 test -n
"$${NOVIEW}" || man
-l
$@
234 qm.conf
.5: ${QM_CONF_MAN5_SOURCES}
236 pct.conf
.5: ${PCT_CONF_MAN5_SOURCES}
238 datacenter.cfg
.5: ${DATACENTER_CONF_MAN5_SOURCES}
240 %.5: %.adoc
%.5-opts.adoc
${PVE_COMMON_DOC_SOURCES}
241 a2x
${A2X_MAN5_OPTIONS} $*.adoc
242 test -n
"$${NOVIEW}" || man
-l
$@
244 .PHONY
: cleanup-docgen
246 rm -f
*.1 *.5 *.8 *.adoc attributes.txt docinfo.xml