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 vzdump.conf
.5-opts.adoc \
45 ${PVE_COMMON_DOC_SOURCES}
47 PVESUBSCRIPTION_MAN1_SOURCES
= \
48 pvesubscription.adoc \
49 pvesubscription
.1-synopsis.adoc \
50 ${PVE_COMMON_DOC_SOURCES}
52 PVECEPH_MAN1_SOURCES
= \
54 pveceph
.1-synopsis.adoc \
55 ${PVE_COMMON_DOC_SOURCES}
60 ${PVE_COMMON_DOC_SOURCES}
62 PCT_CONF_MAN5_SOURCES
= \
64 pct.conf
.5-opts.adoc \
65 ${PVE_COMMON_DOC_SOURCES}
67 DATACENTER_CONF_MAN5_SOURCES
= \
69 datacenter.cfg
.5-opts.adoc \
70 ${PVE_COMMON_DOC_SOURCES}
75 ${PVE_COMMON_DOC_SOURCES}
77 QM_CONF_MAN5_SOURCES
= \
80 ${PVE_COMMON_DOC_SOURCES}
82 QMRESTORE_MAN1_SOURCES
= \
84 qmrestore
.1-synopsis.adoc \
85 ${PVE_COMMON_DOC_SOURCES}
89 pveum
.1-synopsis.adoc \
90 ${PVE_COMMON_DOC_SOURCES}
94 pveam
.1-synopsis.adoc \
95 ${PVE_COMMON_DOC_SOURCES}
97 HA_MANAGER_MAN1_SOURCES
= \
99 ha-manager
.1-synopsis.adoc \
100 ${PVE_COMMON_DOC_SOURCES}
102 PVE_HA_CRM_MAN8_SOURCES
= \
104 pve-ha-crm
.8-synopsis.adoc \
105 ${PVE_COMMON_DOC_SOURCES}
107 PVE_HA_LRM_MAN8_SOURCES
= \
109 pve-ha-lrm
.8-synopsis.adoc \
110 ${PVE_COMMON_DOC_SOURCES}
112 PVESTATD_MAN8_SOURCES
= \
114 pvestatd
.8-synopsis.adoc \
115 ${PVE_COMMON_DOC_SOURCES}
117 PVEDAEMON_MAN8_SOURCES
= \
119 pvedaemon
.8-synopsis.adoc \
120 ${PVE_COMMON_DOC_SOURCES}
122 PVEPROXY_MAN8_SOURCES
= \
124 pveproxy
.8-synopsis.adoc \
125 ${PVE_COMMON_DOC_SOURCES}
127 SPICEPROXY_MAN8_SOURCES
= \
129 spiceproxy
.8-synopsis.adoc \
130 ${PVE_COMMON_DOC_SOURCES}
132 PMXCFS_MAN8_SOURCES
= \
135 ${PVE_COMMON_DOC_SOURCES}
137 attributes.txt docinfo.xml
:
138 cp
${DGDIR}/$@
$@.tmp
141 %-opts.adoc
: ${DGDIR}/gen-
%-opts.pl
142 ${DGDIR}/gen-
$*-opts.pl
>$@.tmp
145 %.adoc
: ${DGDIR}/gen-
%-adoc.pl
146 ${DGDIR}/gen-
$*-adoc.pl
>$@.tmp
150 perl
-I.
-e
"use PVE::CLI::$(subst -,_,$*);print PVE::CLI::$(subst -,_,$*)->generate_asciidoc_synopsys();" > $@.tmp
154 perl
-I.
-e
"use PVE::Service::$(subst -,_,$*);print PVE::Service::$(subst -,_,$*)->generate_asciidoc_synopsys();" > $@.tmp
158 %.adoc
: ${DGDIR}/%.adoc
163 A2X_MAN_COMMON_OPTIONS
=-a docinfo1
-a
"manversion=Release ${DOCRELEASE}" -f manpage
164 A2X_MAN1_OPTIONS
=${A2X_MAN_COMMON_OPTIONS} -a
"manvolnum=1"
165 A2X_MAN5_OPTIONS
=${A2X_MAN_COMMON_OPTIONS} -a
"manvolnum=5"
166 A2X_MAN8_OPTIONS
=${A2X_MAN_COMMON_OPTIONS} -a
"manvolnum=8"
168 pve-firewall
.8: ${PVE_FIREWALL_MAN8_SOURCES}
169 a2x
${A2X_MAN8_OPTIONS} pve-firewall.adoc
170 test -n
"$${NOVIEW}" || man
-l
$@
172 pvesm
.1: ${PVESM_MAN1_SOURCES}
173 a2x
${A2X_MAN1_OPTIONS} pvesm.adoc
174 test -n
"$${NOVIEW}" || man
-l
$@
176 pveceph
.1: ${PVECEPH_MAN1_SOURCES}
177 a2x
${A2X_MAN1_OPTIONS} pveceph.adoc
178 test -n
"$${NOVIEW}" || man
-l
$@
180 pct
.1: ${PCT_MAN1_SOURCES}
181 a2x
${A2X_MAN1_OPTIONS} pct.adoc
182 test -n
"$${NOVIEW}" || man
-l
$@
184 vzdump
.1: ${VZDUMP_MAN1_SOURCES}
185 a2x
${A2X_MAN1_OPTIONS} vzdump.adoc
186 test -n
"$${NOVIEW}" || man
-l
$@
188 pvesubscription
.1: ${PVESUBSCRIPTION_MAN1_SOURCES}
189 a2x
${A2X_MAN1_OPTIONS} pvesubscription.adoc
190 test -n
"$${NOVIEW}" || man
-l
$@
192 qm
.1: ${QM_MAN1_SOURCES}
193 a2x
${A2X_MAN1_OPTIONS} qm.adoc
194 test -n
"$${NOVIEW}" || man
-l
$@
196 qmrestore
.1: ${QMRESTORE_MAN1_SOURCES}
197 a2x
${A2X_MAN1_OPTIONS} qmrestore.adoc
198 test -n
"$${NOVIEW}" || man
-l
$@
200 pvecm
.1: ${PVECM_MAN1_SOURCES}
201 a2x
${A2X_MAN1_OPTIONS} pvecm.adoc
202 test -n
"$${NOVIEW}" || man
-l
$@
204 pveum
.1: ${PVEUM_MAN1_SOURCES}
205 a2x
${A2X_MAN1_OPTIONS} pveum.adoc
206 test -n
"$${NOVIEW}" || man
-l
$@
208 pveam
.1: ${PVEAM_MAN1_SOURCES}
209 a2x
${A2X_MAN1_OPTIONS} pveam.adoc
210 test -n
"$${NOVIEW}" || man
-l
$@
212 ha-manager
.1: ${HA_MANAGER_MAN1_SOURCES}
213 a2x
${A2X_MAN1_OPTIONS} ha-manager.adoc
214 test -n
"$${NOVIEW}" || man
-l
$@
216 pve-ha-crm
.8: ${PVE_HA_CRM_MAN8_SOURCES}
217 a2x
${A2X_MAN8_OPTIONS} pve-ha-crm.adoc
218 test -n
"$${NOVIEW}" || man
-l
$@
220 pve-ha-lrm
.8: ${PVE_HA_LRM_MAN8_SOURCES}
221 a2x
${A2X_MAN8_OPTIONS} pve-ha-lrm.adoc
222 test -n
"$${NOVIEW}" || man
-l
$@
224 pvestatd
.8: ${PVESTATD_MAN8_SOURCES}
225 a2x
${A2X_MAN8_OPTIONS} pvestatd.adoc
226 test -n
"$${NOVIEW}" || man
-l
$@
228 pvedaemon
.8: ${PVEDAEMON_MAN8_SOURCES}
229 a2x
${A2X_MAN8_OPTIONS} pvedaemon.adoc
230 test -n
"$${NOVIEW}" || man
-l
$@
232 pveproxy
.8: ${PVEPROXY_MAN8_SOURCES}
233 a2x
${A2X_MAN8_OPTIONS} pveproxy.adoc
234 test -n
"$${NOVIEW}" || man
-l
$@
236 spiceproxy
.8: ${SPICEPROXY_MAN8_SOURCES}
237 a2x
${A2X_MAN8_OPTIONS} spiceproxy.adoc
238 test -n
"$${NOVIEW}" || man
-l
$@
240 pmxcfs
.8: ${PMXCFS_MAN8_SOURCES}
241 a2x
${A2X_MAN8_OPTIONS} pmxcfs.adoc
242 test -n
"$${NOVIEW}" || man
-l
$@
244 qm.conf
.5: ${QM_CONF_MAN5_SOURCES}
246 pct.conf
.5: ${PCT_CONF_MAN5_SOURCES}
248 datacenter.cfg
.5: ${DATACENTER_CONF_MAN5_SOURCES}
250 %.5: %.adoc
%.5-opts.adoc
${PVE_COMMON_DOC_SOURCES}
251 a2x
${A2X_MAN5_OPTIONS} $*.adoc
252 test -n
"$${NOVIEW}" || man
-l
$@
254 .PHONY
: cleanup-docgen
256 rm -f
*.1 *.5 *.8 *.adoc attributes.txt docinfo.xml