Changeset 98932 in vbox for trunk/doc

Timestamp:

Mar 13, 2023 1:04:22 PM (2 years ago)

Author:

vboxsync

Message:

Docs: Removing CHM related bits.

File:

• trunk/doc/manual/Makefile.kmk (modified) (5 diffs)

trunk/doc/manual/Makefile.kmk

@@ -32 +32 @@
 #   -- UserManual.pdf, generated by LaTex
 #
-#   -- VirtualBox.chm
 #
 #   Both files end up in PATH_STAGE_BIN.
@@ -51 +50 @@
 #      generate PDF.
 #
-#   -- CHM file: again, pre-process the XML files in PATH_TARGET, then use
-#      xsltproc to create a .HHP file for the Microsoft Help Compiler, then
-#      feed that file to it.
 #
 
@@ -155 +151 @@
  endif
 
- ifdef VBOX_WITH_DOCS_CHM
-  INSTALLS += VBox-docs-usermanual-chm
-  VBOX_PATH_BIN_CHM = $(PATH_STAGE_BIN)/VirtualBox.chm
- else  # Do not build chm.
-  VBOX_PATH_BIN_CHM =
- endif
-
  ifdef VBOX_WITH_DOCS_QHELP
   INSTALLS += VBox-docs-usermanual-qhc
@@ -198 +187 @@
    VBOX_MANUAL_PACK += \
         $(foreach f,$(VBOX_MANUAL_ADD_LANGUAGES),$(PATH_STAGE_BIN)/UserManual_$(f).pdf)
-   ifdef VBOX_WITH_DOCS_CHM
-    INSTALLS += VBox-docs-usermanual-l10n-chm
-    VBOX_MANUAL_PACK += \
-        $(foreach f,$(VBOX_MANUAL_ADD_LANGUAGES),$(PATH_STAGE_BIN)/VirtualBox_$(f).chm)
-   endif
   endif
  endif # !VBOX_ONLY_SDK
@@ -723 +707 @@
         $(QUIET)$(MV) -f [email protected] $@
 
-
- ifdef VBOX_WITH_DOCS_CHM
-  #
-  # VirtualBox.chm
-  #
-  # We first generate a .hhp help source file from the preprocessed
-  # DocBook XML files, as defined above, then feed that into the
-  # Microsoft Help Compiler.
-
-  # Generate CHM from HHP
-  # Note: out_dir needs to be referenced with an escaped $ so it doesn't expand as eval expands it input.
-  define def_vbox_usermanual_hhp_to_chm
-   local out_dir := $(VBOX_PATH_MANUAL_OUTBASE)/$(lang)
-   $$(out_dir)/VirtualBox.chm: \
-                $$(out_dir)/HTMLHelp/htmlhelp.hhp \
-                $$(addprefix $$(out_dir)/HTMLHelp/,$$(VBOX_MANUAL_PNG_FILES_$(lang))) \
-                | $$$$(dir $$$$@)
-        $$(call MSG_L1,hhc $$<,=> $$@)
-        $$(QUIET)$$(RM) -f $$@
-        $$(QUIET)$$(VBOX_HHC) $$(subst /,\\,$$<)
-        $$(call MSG_L1,Fresh CHM is now at $$@)
-  endef
-  $(foreach lang,$(VBOX_MANUAL_LANGUAGES),$(evalcall2 def_vbox_usermanual_hhp_to_chm))
-
-  # Generate HHP from XML
-  # Note: out_dir needs to be referenced with an escaped $ so it doesn't expand as eval expands it input.
-  define def_vbox_usermanual_xml_to_hhp
-   local out_dir := $(VBOX_PATH_MANUAL_OUTBASE)/$(lang)
-   $$(out_dir)/HTMLHelp/htmlhelp.hhp: \
-                $$(addprefix $$(VBOX_PATH_MANUAL_SRC)/$(lang)/,$$(VBOX_MANUAL_XML_FILES)) \
-                $$(VBOX_MANUAL_XML_FILES_COMMON) \
-                $$(VBOX_MANUAL_XML_FILES_GENERATED_$(lang)) \
-                $$(VBOX_DOCBOOK_HTMLHELP_FORMATCFG) \
-                $$(VBOX_PATH_MANUAL_OUTBASE)/titlepage-htmlhelp.xsl \
-                $$(if $$(VBOX_HAVE_XMLLINT),$$(out_dir)/validatemanual.run,) \
-                $$(VBOX_XML_CATALOG) $$(VBOX_XML_CATALOG_DOCBOOK) $$(VBOX_XML_CATALOG_MANUAL) \
-                $$(VBOX_XML_ENTITIES) | $$$$(dir $$$$@)
-        $$(call MSG_TOOL,xsltproc $$(notdir $$(firstword $$(filter %.xsl,$$^))),,$$(firstword $$(filter %.xml,$$^)),$$@)
-        $$(QUIET)$$(RM) -f $$@
-        $$(QUIET)$$(call VBOX_XSLTPROC_WITH_CAT) --output $$(@D)/ \
-                --stringparam htmlhelp.chm \
-                $$(subst /,\\,$$(VBOX_PATH_MANUAL_OUTBASE)/$(lang)/VirtualBox.chm) \
-                $$(HTMLHELPOPTS) $$(VBOX_PATH_MANUAL_SRC)/docbook-htmlhelp-formatcfg.xsl \
-                $$<
-  endef
-  $(foreach lang,$(VBOX_MANUAL_LANGUAGES),$(evalcall2 def_vbox_usermanual_xml_to_hhp))
-
-  # copy the PNG files.
-  # Note: out_dir needs to be referenced with an escaped $ so it doesn't expand as eval expands it input.
-  define def_vbox_cp_images_htmlhelp
-   local out_dir := $(VBOX_PATH_MANUAL_OUTBASE)/$(lang)/HTMLHelp
-   $(addprefix $$(out_dir)/,$(VBOX_MANUAL_PNG_FILES_$(lang))): \
-                $$(out_dir)/% : $(VBOX_PATH_MANUAL_SRC)/$(lang)/% | $$$$(dir $$$$@)
-        $$(call MSG_L1,Copying temporary $$< => $$@)
-        $$(QUIET)$$(INSTALL_STAGING) -m0644 -- '$$<' '$$(@D)'
-  endef
-  $(foreach lang,$(VBOX_MANUAL_LANGUAGES),$(eval $(def_vbox_cp_images_htmlhelp)))
-
- endif # VBOX_WITH_DOCS_CHM
-
-
  # Packing the docs into a zip file
  $(PATH_STAGE_BIN)/VBoxDocumentation.zip: $(VBOX_MANUAL_PACK)