1 | # $Id: Makefile.kmk 94660 2022-04-21 08:38:34Z vboxsync $
|
---|
2 | ## @file
|
---|
3 | # Sub-Makefile for VBoxManage (the CLI frontend).
|
---|
4 | #
|
---|
5 |
|
---|
6 | #
|
---|
7 | # Copyright (C) 2006-2022 Oracle Corporation
|
---|
8 | #
|
---|
9 | # This file is part of VirtualBox Open Source Edition (OSE), as
|
---|
10 | # available from http://www.virtualbox.org. This file is free software;
|
---|
11 | # you can redistribute it and/or modify it under the terms of the GNU
|
---|
12 | # General Public License (GPL) as published by the Free Software
|
---|
13 | # Foundation, in version 2 as it comes in the "COPYING" file of the
|
---|
14 | # VirtualBox OSE distribution. VirtualBox OSE is distributed in the
|
---|
15 | # hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
|
---|
16 | #
|
---|
17 |
|
---|
18 | SUB_DEPTH = ../../../..
|
---|
19 | include $(KBUILD_PATH)/subheader.kmk
|
---|
20 |
|
---|
21 | include $(PATH_ROOT)/doc/manual/Config.kmk
|
---|
22 |
|
---|
23 |
|
---|
24 | ## @todo r=andy Sort this stuff alphabetically!
|
---|
25 | VBOX_COMMON_VBOXMANAGE_DEFS = \
|
---|
26 | $(if $(VBOX_WITH_AHCI), VBOX_WITH_AHCI) \
|
---|
27 | $(if $(VBOX_WITH_COPYTOGUEST),VBOX_WITH_COPYTOGUEST) \
|
---|
28 | $(if $(VBOX_WITH_E1000),VBOX_WITH_E1000) \
|
---|
29 | $(if $(VBOX_WITH_GUEST_CONTROL),VBOX_WITH_GUEST_CONTROL) \
|
---|
30 | $(if $(VBOX_WITH_GUEST_PROPS),VBOX_WITH_GUEST_PROPS) \
|
---|
31 | $(if $(VBOX_WITH_HEADLESS), VBOX_WITH_HEADLESS) \
|
---|
32 | $(if $(VBOX_WITH_HGCM), VBOX_WITH_HGCM) \
|
---|
33 | $(if $(VBOX_WITH_HOSTNETIF_API), VBOX_WITH_HOSTNETIF_API) \
|
---|
34 | $(if $(VBOX_WITH_NETFLT), VBOX_WITH_NETFLT) \
|
---|
35 | $(if-expr defined(VBOX_WITH_VMNET) && "$(KBUILD_TARGET)"=="darwin",VBOX_WITH_VMNET,) \
|
---|
36 | $(if $(VBOX_WITH_CLOUD_NET), VBOX_WITH_CLOUD_NET) \
|
---|
37 | $(if $(VBOX_WITH_AUDIO_OSS), VBOX_WITH_AUDIO_OSS) \
|
---|
38 | $(if $(VBOX_WITH_AUDIO_ALSA), VBOX_WITH_AUDIO_ALSA) \
|
---|
39 | $(if $(VBOX_WITH_AUDIO_PULSE),VBOX_WITH_AUDIO_PULSE) \
|
---|
40 | $(if $(VBOX_WITH_SCSI), VBOX_WITH_SCSI) \
|
---|
41 | $(if $(VBOX_WITH_VBOXSDL), VBOX_WITH_VBOXSDL) \
|
---|
42 | $(if $(VBOX_WITH_VIDEOHWACCEL), VBOX_WITH_VIDEOHWACCEL) \
|
---|
43 | $(if $(VBOX_WITH_VIRTIO),VBOX_WITH_VIRTIO) \
|
---|
44 | $(if $(VBOX_WITH_VIRTIO_NET_1_0),VBOX_WITH_VIRTIO_NET_1_0) \
|
---|
45 | $(if $(VBOX_WITH_USB_CARDREADER),VBOX_WITH_USB_CARDREADER) \
|
---|
46 | $(if $(VBOX_WITH_PCI_PASSTHROUGH),VBOX_WITH_PCI_PASSTHROUGH) \
|
---|
47 | $(if $(VBOX_WITH_RECORDING),VBOX_WITH_RECORDING) \
|
---|
48 | $(if $(VBOX_WITH_AUDIO_RECORDING),VBOX_WITH_AUDIO_RECORDING) \
|
---|
49 | $(if $(VBOX_WITH_NAT_SERVICE),VBOX_WITH_NAT_SERVICE) \
|
---|
50 | $(if $(VBOX_WITH_SHARED_CLIPBOARD),VBOX_WITH_SHARED_CLIPBOARD) \
|
---|
51 | $(if $(VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS),VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS) \
|
---|
52 | $(if $(VBOX_WITH_IOMMU_AMD),VBOX_WITH_IOMMU_AMD) \
|
---|
53 | $(if $(VBOX_WITH_IOMMU_INTEL),VBOX_WITH_IOMMU_INTEL) \
|
---|
54 | $(if $(VBOX_WITH_UPDATE_AGENT), VBOX_WITH_UPDATE_AGENT) \
|
---|
55 | $(if $(VBOX_WITH_VMSVGA),VBOX_WITH_VMSVGA) \
|
---|
56 | $(if $(VBOX_WITH_MAIN_NLS),VBOX_WITH_MAIN_NLS) \
|
---|
57 | $(if $(VBOX_WITH_TPM),VBOX_WITH_TPM) \
|
---|
58 | $(if $(VBOX_WITH_FULL_VM_ENCRYPTION),VBOX_WITH_FULL_VM_ENCRYPTION)
|
---|
59 |
|
---|
60 |
|
---|
61 | ifndef VBOX_ONLY_DOCS
|
---|
62 | PROGRAMS += VBoxManage
|
---|
63 | VBoxManage_TEMPLATE = VBOXMAINCLIENTEXE
|
---|
64 | VBoxManage_DEFS += $(VBOX_COMMON_VBOXMANAGE_DEFS)
|
---|
65 | VBoxManage_DEFS.win = _WIN32_WINNT=0x0500
|
---|
66 | VBoxManage_INCS = \
|
---|
67 | $(VBoxManage_0_OUTDIR) \
|
---|
68 | ../Common
|
---|
69 | VBoxManage_INTERMEDIATES = \
|
---|
70 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h
|
---|
71 | VBoxManage_SOURCES = \
|
---|
72 | VBoxManage.cpp \
|
---|
73 | VBoxManageUtils.cpp \
|
---|
74 | VBoxInternalManage.cpp \
|
---|
75 | VBoxManageAppliance.cpp \
|
---|
76 | VBoxManageBandwidthControl.cpp \
|
---|
77 | VBoxManageControlVM.cpp \
|
---|
78 | VBoxManageDebugVM.cpp \
|
---|
79 | VBoxManageDHCPServer.cpp \
|
---|
80 | VBoxManageDisk.cpp \
|
---|
81 | $(if $(VBOX_WITH_GUEST_CONTROL),VBoxManageGuestCtrl.cpp) \
|
---|
82 | $(if $(VBOX_WITH_GUEST_CONTROL),VBoxManageGuestCtrlListener.cpp) \
|
---|
83 | $(if $(VBOX_WITH_GUEST_PROPS),VBoxManageGuestProp.cpp) \
|
---|
84 | VBoxManageHelp.cpp \
|
---|
85 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp \
|
---|
86 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp_en_US.cpp \
|
---|
87 | VBoxManageHostonly.cpp \
|
---|
88 | VBoxManageInfo.cpp \
|
---|
89 | VBoxManageList.cpp \
|
---|
90 | VBoxManageMetrics.cpp \
|
---|
91 | VBoxManageMisc.cpp \
|
---|
92 | VBoxManageModifyVM.cpp \
|
---|
93 | VBoxManageModifyNvram.cpp \
|
---|
94 | VBoxManageSnapshot.cpp \
|
---|
95 | VBoxManageStorageController.cpp \
|
---|
96 | $(if $(VBOX_WITH_UPDATE_AGENT),VBoxManageUpdateCheck.cpp) \
|
---|
97 | VBoxManageUSB.cpp \
|
---|
98 | $(if $(VBOX_WITH_NAT_SERVICE),VBoxManageNATNetwork.cpp,) \
|
---|
99 | $(if $(VBOX_WITH_NAT_SERVICE),../../NetworkServices/NetLib/VBoxNetPortForwardString.cpp,) \
|
---|
100 | VBoxManageCloud.cpp \
|
---|
101 | VBoxManageCloudMachine.cpp \
|
---|
102 | ../Common/PasswordInput.cpp
|
---|
103 | VBoxManage_SOURCES.win = \
|
---|
104 | VBoxManage.rc
|
---|
105 | VBoxManage_LIBS += $(LIB_DDU)
|
---|
106 |
|
---|
107 | ifdef VBOX_WITH_VBOXMANAGE_NLS
|
---|
108 | VBOX_PATH_VBOXMANAGE_SRC := $(PATH_SUB_CURRENT)
|
---|
109 | include $(PATH_SUB_CURRENT)/nls/ApprovedLanguages.kmk
|
---|
110 |
|
---|
111 | VBoxManage_DEFS += VBOX_WITH_VBOXMANAGE_NLS
|
---|
112 | VBoxManage_INCS += \
|
---|
113 | $(PATH_ROOT)/src/VBox/Main/include
|
---|
114 | VBoxManage_SOURCES += \
|
---|
115 | $(PATH_ROOT)/src/VBox/Main/src-all/VirtualBoxTranslator.cpp \
|
---|
116 | $(PATH_ROOT)/src/VBox/Main/src-all/QMTranslatorImpl.cpp \
|
---|
117 | $(PATH_ROOT)/src/VBox/Main/src-all/GlobalStatusConversion.cpp \
|
---|
118 |
|
---|
119 | # $(addsuffix /VBoxManageBuiltInHelp.cpp,$(addprefix $(VBoxManage_0_OUTDIR)/,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES)))
|
---|
120 | #VBoxManage_INTERMEDIATES += \
|
---|
121 | # $(addsuffix /VBoxManageBuiltInHelp.h,$(addprefix $(VBoxManage_0_OUTDIR)/,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES)))
|
---|
122 |
|
---|
123 | # define qt5 tools for translation
|
---|
124 | USES += qt5
|
---|
125 |
|
---|
126 | PROGRAMS += VBoxManageNls
|
---|
127 | VBoxManageNls_TEMPLATE = VBoxNLS
|
---|
128 | VBoxManageNls_QT_TRANSLATIONS = $(addsuffix .ts,$(addprefix $(VBOX_PATH_VBOXMANAGE_SRC)/nls/VBoxManageNls_,$(VBOX_APPROVED_VBOXMANAGE_LANGUAGES)))
|
---|
129 | VBoxManageNls_VBOX_ALL_NLS_SOURCES = $(wildcard \
|
---|
130 | $(VBOX_PATH_VBOXMANAGE_SRC)/*.h\
|
---|
131 | $(VBOX_PATH_VBOXMANAGE_SRC)/*.cpp )
|
---|
132 |
|
---|
133 | updatenls:: makeallnls $(VBOX_PATH_VBOXMANAGE_SRC)/nls/VBoxManageNls_en.ts
|
---|
134 |
|
---|
135 | makeallnls:: $(VBoxManageNls_VBOX_ALL_NLS_SOURCES)
|
---|
136 | $(call MSG_L1,lupdate all languages (nls/*.ts))
|
---|
137 | $(QUIET)$(TOOL_QT5_LUPDATE) \
|
---|
138 | $^ \
|
---|
139 | -ts \
|
---|
140 | $(filter-out nls/VBoxManageNls_en.ts, $(VBoxManageNls_QT_TRANSLATIONS)) \
|
---|
141 | $(VBOX_PATH_VBOXMANAGE_SRC)/nls/VBoxManageNls_xx_YY.ts
|
---|
142 |
|
---|
143 | # fake-main-nls:
|
---|
144 | # $(foreach file, $(VBoxManageNls_QT_TRANSLATIONS) \
|
---|
145 | # ,$(NLTAB)$(SED) -i \
|
---|
146 | # -e '/<source>.*<\/source>/h' \
|
---|
147 | # -e '/<source>.*<\/source>/p' \
|
---|
148 | # -e '/<translation type="unfinished"><\/translation>/{' \
|
---|
149 | # -e 'x' \
|
---|
150 | # -e 's/<source>\(.*\)<\/source>/<translation type="unfinished">$(notdir $(file)): \1<\/translation>/' \
|
---|
151 | # -e '}' \
|
---|
152 | # $(file) )
|
---|
153 |
|
---|
154 |
|
---|
155 | # Create the English translation file. This is something special cause it will
|
---|
156 | # contain the plural forms only.
|
---|
157 | $(VBOX_PATH_VBOXMANAGE_SRC)/nls/VBoxManageNls_en.ts: $(VBoxManageNls_VBOX_ALL_NLS_SOURCES)
|
---|
158 | $(call MSG_L1,lupdate $@)
|
---|
159 | $(QUIET)$(TOOL_QT5_LUPDATE) \
|
---|
160 | $^ \
|
---|
161 | -ts \
|
---|
162 | "$@"
|
---|
163 | $(QUIET)$(SED) -n -i \
|
---|
164 | -e '/<context>/,/<\/context>/!p' \
|
---|
165 | -e '/<context>/h' \
|
---|
166 | -e '/<name>/H' \
|
---|
167 | -e '/<message numerus="yes">/,/<\/message>/H' \
|
---|
168 | -e '/<\/context>/{H;x;/<message/p}' \
|
---|
169 | "$@"
|
---|
170 |
|
---|
171 | endif # VBOX_WITH_VBOXMANAGE_NLS
|
---|
172 |
|
---|
173 |
|
---|
174 | # VBoxNetPortForwardString.h
|
---|
175 | VBoxManageNATNetwork.cpp_INCS += ../../NetworkServices/NetLib/
|
---|
176 |
|
---|
177 | endif # VBOX_ONLY_DOCS
|
---|
178 |
|
---|
179 | ifneq ($(KBUILD_TARGET),win)
|
---|
180 | # Workaround for buggy gcc-4.3 compilers, see
|
---|
181 | #
|
---|
182 | # http://gcc.gnu.org/bugzilla/show_bug.cgi?id=36474
|
---|
183 | #
|
---|
184 | # Some later revisions of version 4.3.1 are known to work so we assume
|
---|
185 | # that version 4.3.2 or later has this bug definitely fixed.
|
---|
186 | VBoxManage_CXXFLAGS.release += \
|
---|
187 | $(if $(VBOX_GCC_VERSION_CXX),$(if-expr $(VBOX_GCC_VERSION_CXX) < 40300 || $(VBOX_GCC_VERSION_CXX) > 40301,,--param max-fields-for-field-sensitive=0),)
|
---|
188 | VBoxManageHelp_CXXFLAGS.release = $(VBoxManage_CXXFLAGS.release)
|
---|
189 | endif
|
---|
190 |
|
---|
191 |
|
---|
192 | #
|
---|
193 | # VBoxManage built-in help from XML refentry in doc/manual/en_US/.
|
---|
194 | #
|
---|
195 | $(call KB_FN_DO_PASS0_ON_TARGET,VBoxManage)
|
---|
196 |
|
---|
197 | VBoxManage_CLEAN += \
|
---|
198 | $(VBOX_XML_CATALOG) \
|
---|
199 | $(VBOX_XML_CATALOG_DOCBOOK) \
|
---|
200 | $(VBOX_XML_CATALOG_MANUAL) \
|
---|
201 | $(VBOX_XML_ENTITIES) \
|
---|
202 | $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/en_US/, $(VBOX_XML_XREF_TO_TEXT) $(VBOX_XML_XREF_TO_TEXT).cat) \
|
---|
203 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp_en_US.cpp \
|
---|
204 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp_en_US.cpp.ts \
|
---|
205 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp \
|
---|
206 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp.ts \
|
---|
207 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h \
|
---|
208 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h.ts \
|
---|
209 | $(addprefix $(VBoxManage_0_OUTDIR)/,$(filter man_VBoxManage-%,$(VBOX_MANUAL_XML_REFENTRY_FILES)))
|
---|
210 |
|
---|
211 | # Preprocess the xml files, applying remarks.
|
---|
212 | $(foreach file,$(filter man_VBoxManage-%,$(VBOX_MANUAL_XML_REFENTRY_FILES)) \
|
---|
213 | , $(evalcall2 def_vbox_refentry_preprocess_for_manpage,$(VBoxManage_0_OUTDIR),$(file), \
|
---|
214 | $(VBOX_PATH_MANUAL_SRC)/en_US/$(file),replace-xrefs,en_US))
|
---|
215 |
|
---|
216 |
|
---|
217 | ##
|
---|
218 | # Emits rules for generating cpp files from man pages.
|
---|
219 | #
|
---|
220 | # $(evalcall2 def_vbox_man_generate_cpp_help)
|
---|
221 | # @param 1 Folder with preprocessed man_VBoxManage_* files
|
---|
222 | # @param 2 language code.
|
---|
223 | define def_vbox_man_generate_cpp_help
|
---|
224 | ifneq ($(2),en_US)
|
---|
225 | VBOX_DOCBOOK_REFENTRY_TO_C_HELP_$(2) = $(VBOX_PATH_MANUAL_SRC)/$(2)/docbook-refentry-to-C-help.xsl
|
---|
226 | else
|
---|
227 | VBOX_DOCBOOK_REFENTRY_TO_C_HELP_$(2) = $(VBOX_DOCBOOK_REFENTRY_TO_C_HELP)
|
---|
228 | endif
|
---|
229 | $$(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp_$(2).cpp.ts \
|
---|
230 | +| $$(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp_$(2).cpp: \
|
---|
231 | $$(VBOX_DOCBOOK_REFENTRY_TO_C_HELP_$(2)) \
|
---|
232 | $$(VBOX_DOCBOOK_REFENTRY_TO_C_HELP) \
|
---|
233 | $$(addprefix $(1)/,$$(filter man_VBoxManage-%,$$(VBOX_MANUAL_XML_REFENTRY_FILES))) \
|
---|
234 | $$(VBOX_XML_CATALOG) $$(VBOX_XML_CATALOG_DOCBOOK) $$(MAKEFILE) | $$$$(dir $$$$@)
|
---|
235 | $$(call MSG_TOOL,xsltproc $$(notdir $$(firstword $$(filter %.xsl,$$^))),,$$(filter %.xml,$$^),$$(patsubst %.ts,%,$$@))
|
---|
236 | $$(QUIET)$$(APPEND) -tn "$$@" \
|
---|
237 | '/* Autogenerated by $$<, do not edit! */' \
|
---|
238 | '' \
|
---|
239 | '#include "VBoxManageBuiltInHelp.h"' \
|
---|
240 | '' \
|
---|
241 | 'RT_C_DECLS_BEGIN' \
|
---|
242 | '/* make next variables visible outside the module */' \
|
---|
243 | 'extern PCRTMSGREFENTRY g_apHelpEntries_$(2)[];' \
|
---|
244 | 'extern const uint32_t g_cHelpEntries_$(2);' \
|
---|
245 | 'RT_C_DECLS_END' \
|
---|
246 | '' \
|
---|
247 | $$(foreach refentry,$$(filter %.xml,$$^) \
|
---|
248 | ,$$(NLTAB)$$(QUIET)$$(call VBOX_XSLTPROC_WITH_CAT, -a+to "$$@") \
|
---|
249 | --path '$(VBOX_PATH_MANUAL_SRC)/$(2) $(VBOX_PATH_MANUAL_SRC)/en_US' $$< $$(refentry))
|
---|
250 | $$(QUIET)$$(APPEND) -n "$$@" \
|
---|
251 | '' \
|
---|
252 | 'PCRTMSGREFENTRY g_apHelpEntries_$(2)[] =' \
|
---|
253 | '{'
|
---|
254 | $$(foreach refentry,$$(filter %.xml,$$^) \
|
---|
255 | ,$$(NLTAB)$$(QUIET)$$(APPEND) -n "$$@" \
|
---|
256 | ' &g_$$(subst -,_,$$(tolower $$(patsubst man_%,%,$$(notdir $$(basename $$(refentry)))))),')
|
---|
257 | $$(QUIET)$$(APPEND) -n "$$@" \
|
---|
258 | '};' \
|
---|
259 | '' \
|
---|
260 | 'const uint32_t g_cHelpEntries_$(2) = RT_ELEMENTS(g_apHelpEntries_$(2));' \
|
---|
261 | ''
|
---|
262 | $$(QUIET)$$(CP) --changed -- "$$@" "$$(patsubst %.ts,%,$$@)"
|
---|
263 | endef
|
---|
264 | # The above APPEND stuff trigger some kind of problem on some boxes when not split up...
|
---|
265 | # update: Fixed in SVN (strcpy -> memmove in new_job(), job.c - r2591). Just need to rebuild all platforms.
|
---|
266 |
|
---|
267 | # Generate the .cpp file.
|
---|
268 | $(evalcall2 def_vbox_man_generate_cpp_help, $(VBoxManage_0_OUTDIR),en_US)
|
---|
269 |
|
---|
270 |
|
---|
271 | # Generate built-in help for all languages (English is implicit).
|
---|
272 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp.ts \
|
---|
273 | +| $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.cpp: \
|
---|
274 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp_en_US.cpp \
|
---|
275 | $(foreach lang,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES), $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp_$(lang).cpp ) \
|
---|
276 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h
|
---|
277 | $(QUIET)$(APPEND) -tn "$@" \
|
---|
278 | '/* Autogenerated, do not edit! */' \
|
---|
279 | '' \
|
---|
280 | '#include "VBoxManageBuiltInHelp.h"' \
|
---|
281 | '' \
|
---|
282 | 'RT_C_DECLS_BEGIN' \
|
---|
283 | '' \
|
---|
284 | 'extern PCRTMSGREFENTRY g_apHelpEntries_en_US[];' \
|
---|
285 | 'extern const uint32_t g_cHelpEntries_en_US;'
|
---|
286 | ifdef VBOX_WITH_VBOXMANAGE_NLS
|
---|
287 | $(foreach lang,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES) \
|
---|
288 | ,$(NLTAB)$(QUIET)$(APPEND) -n "$@" \
|
---|
289 | '' \
|
---|
290 | 'extern PCRTMSGREFENTRY g_apHelpEntries_$(lang)[];' \
|
---|
291 | 'extern const uint32_t g_cHelpEntries_$(lang);')
|
---|
292 | endif
|
---|
293 | $(QUIET)$(APPEND) -n "$@" \
|
---|
294 | '' \
|
---|
295 | 'RT_C_DECLS_END' \
|
---|
296 | '' \
|
---|
297 | 'HELP_LANG_ENTRY_T const g_aHelpLangEntries[] = ' \
|
---|
298 | '{' \
|
---|
299 | ' { "en_US", 5, &g_apHelpEntries_en_US[0], &g_cHelpEntries_en_US },'
|
---|
300 | ifdef VBOX_WITH_VBOXMANAGE_NLS
|
---|
301 | $(foreach lang,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES) \
|
---|
302 | ,$(NLTAB)$(QUIET)$(APPEND) "$@" ' { "$(lang)", $(length $(lang)), &g_apHelpEntries_$(lang)[0], &g_cHelpEntries_$(lang) },' )
|
---|
303 | endif
|
---|
304 | $(QUIET)$(APPEND) -n "$@" \
|
---|
305 | '};' \
|
---|
306 | '' \
|
---|
307 | 'uint32_t const g_cHelpLangEntries = RT_ELEMENTS(g_aHelpLangEntries);' \
|
---|
308 | '' \
|
---|
309 | 'PCHELP_LANG_ENTRY_T volatile g_pHelpLangEntry = &g_aHelpLangEntries[0];'\
|
---|
310 | ''
|
---|
311 | $(QUIET)$(CP) --changed -- "$@" "$(patsubst %.ts,%,$@)"
|
---|
312 |
|
---|
313 |
|
---|
314 | $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h.ts \
|
---|
315 | +| $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp.h: \
|
---|
316 | $(VBOX_DOCBOOK_REFENTRY_TO_H_HELP) \
|
---|
317 | $(addprefix $(VBoxManage_0_OUTDIR)/,$(filter man_VBoxManage-%,$(VBOX_MANUAL_XML_REFENTRY_FILES))) \
|
---|
318 | $(VBOX_XML_CATALOG) $(VBOX_XML_CATALOG_DOCBOOK) $(MAKEFILE) | $$(dir $$@)
|
---|
319 | $(call MSG_TOOL,xsltproc $(notdir $(firstword $(filter %.xsl,$^))),,$(filter %.xml,$^),$(patsubst %.ts,%,$@))
|
---|
320 | $(QUIET)$(APPEND) -tn "$@" \
|
---|
321 | '/* Autogenerated by $<, do not edit! */' \
|
---|
322 | '' \
|
---|
323 | '#ifndef ___VBoxManageBuiltInHelp_h___' \
|
---|
324 | '#define ___VBoxManageBuiltInHelp_h___' \
|
---|
325 | '' \
|
---|
326 | '#include <iprt/message.h>' \
|
---|
327 | '#include <iprt/assertcompile.h>' \
|
---|
328 | '' \
|
---|
329 | 'RT_C_DECLS_BEGIN' \
|
---|
330 | '' \
|
---|
331 | 'typedef enum HELP_CMD_VBOXMANAGE' \
|
---|
332 | '{' \
|
---|
333 | ' HELP_CMD_VBOXMANAGE_INVALID = 0,'
|
---|
334 | $(foreach refentry,$(filter %.xml,$^) \
|
---|
335 | ,$(NLTAB)$(QUIET)$(call VBOX_XSLTPROC_WITH_CAT, -a+to "$@") \
|
---|
336 | --stringparam 'g_sMode' 'cmd' $< $(refentry))
|
---|
337 | $(QUIET)$(APPEND) -n "$@" \
|
---|
338 | ' HELP_CMD_VBOXMANAGE_END' \
|
---|
339 | '} HELP_CMD_VBOXMANAGE;'
|
---|
340 | $(foreach refentry,$(filter %.xml,$^) \
|
---|
341 | ,$(NLTAB)$(QUIET)$(call VBOX_XSLTPROC_WITH_CAT, -a+to "$@") \
|
---|
342 | --stringparam 'g_sMode' 'subcmd' $< $(refentry))
|
---|
343 | $(QUIET)$(APPEND) -n "$@" \
|
---|
344 | '' \
|
---|
345 | 'typedef struct HELP_LANG_ENTRY_T' \
|
---|
346 | '{' \
|
---|
347 | ' const char *pszLang;' \
|
---|
348 | ' size_t cchLang;' \
|
---|
349 | ' PCRTMSGREFENTRY *papHelpEntries;' \
|
---|
350 | ' uint32_t const *pcHelpEntries;' \
|
---|
351 | '} HELP_LANG_ENTRY_T;' \
|
---|
352 | 'typedef HELP_LANG_ENTRY_T const *PCHELP_LANG_ENTRY_T;' \
|
---|
353 | '' \
|
---|
354 | 'extern HELP_LANG_ENTRY_T const g_aHelpLangEntries[];' \
|
---|
355 | 'extern const uint32_t g_cHelpLangEntries;' \
|
---|
356 | '' \
|
---|
357 | 'extern PCHELP_LANG_ENTRY_T volatile g_pHelpLangEntry;' \
|
---|
358 | '' \
|
---|
359 | 'RT_C_DECLS_END' \
|
---|
360 | '' \
|
---|
361 | '#endif' \
|
---|
362 | ''
|
---|
363 | $(QUIET)$(CP) --changed -- "$@" "$(patsubst %.ts,%,$@)"
|
---|
364 |
|
---|
365 | ifdef VBOX_WITH_VBOXMANAGE_NLS
|
---|
366 | VBoxManage_BLDDIRS += \
|
---|
367 | $(addprefix $(VBoxManage_0_OUTDIR)/,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES))
|
---|
368 |
|
---|
369 | VBoxManage_SOURCES += \
|
---|
370 | $(foreach lang, $(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES) \
|
---|
371 | , $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp_$(lang).cpp)
|
---|
372 |
|
---|
373 | VBoxManage_CLEAN += \
|
---|
374 | $(foreach lang,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES), \
|
---|
375 | $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/$(lang)/, \
|
---|
376 | $(VBOX_XML_XREF_TO_TEXT) \
|
---|
377 | $(VBOX_XML_XREF_TO_TEXT).cat \
|
---|
378 | )) \
|
---|
379 | $(addsuffix .cpp,$(addprefix $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp_,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES))) \
|
---|
380 | $(addsuffix .cpp.ts,$(addprefix $(VBoxManage_0_OUTDIR)/VBoxManageBuiltInHelp_,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES))) \
|
---|
381 | $(foreach file, $(filter man_VBoxManage-%,$(VBOX_MANUAL_XML_REFENTRY_FILES)) \
|
---|
382 | , $(addsuffix /$(file),$(addprefix $(VBoxManage_0_OUTDIR)/,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES))))
|
---|
383 |
|
---|
384 | # Preprocess the xml files, applying remarks.
|
---|
385 | $(foreach lang, $(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES) \
|
---|
386 | , $(foreach file,$(filter man_VBoxManage-%,$(VBOX_MANUAL_XML_REFENTRY_FILES)) \
|
---|
387 | , $(evalcall2 def_vbox_refentry_preprocess_for_manpage,$(VBoxManage_0_OUTDIR)/$(lang),$(file) \
|
---|
388 | ,$(VBOX_PATH_MANUAL_SRC)/$(lang)/$(file),replace-xrefs,$(lang))))
|
---|
389 |
|
---|
390 | # Generate the .cpp file.
|
---|
391 | $(foreach lang, $(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES) \
|
---|
392 | , $(evalcall2 def_vbox_man_generate_cpp_help,$(VBoxManage_0_OUTDIR)/$(lang),$(lang)))
|
---|
393 |
|
---|
394 | # Ensure $(lang) subfolder in the $(VBOX_PATH_MANUAL_OUTBASE) is created (for section names file)
|
---|
395 | BLDDIRS += $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/,$(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES))
|
---|
396 |
|
---|
397 | # Generate sections names file for $(lang)
|
---|
398 | $(foreach lang, $(VBOX_APPROVED_VBOXMANAGE_DOCBOOK_LANGUAGES) \
|
---|
399 | , $(evalcall2 def_vbox_xref_to_text,$(lang)))
|
---|
400 |
|
---|
401 | endif
|
---|
402 |
|
---|
403 | include $(FILE_KBUILD_SUB_FOOTER)
|
---|