VirtualBox

Changeset 34802 in vbox


Ignore:
Timestamp:
Dec 7, 2010 4:27:50 PM (14 years ago)
Author:
vboxsync
Message:

Manual: use sed magic instead of XInclude to cobble together the translateable changelog implementation and still have it work with PDF and CHM

Location:
trunk/doc/manual
Files:
3 edited
1 copied

Legend:

Unmodified
Added
Removed

  • trunk/doc/manual/Makefile.kmk

    r34798 r34802  
    140140        user_Networking.xml
    141141
     142 VBOX_MANUAL_XML_FILES_INCL_CHANGELOG = $(VBOX_MANUAL_XML_FILES) \
     143        user_ChangeLog.xml
     144
    142145 VBOX_SDKREF_XML_FILES = \
    143146        SDKRef.xml
    … …  
    172175
    173176 OTHER_CLEAN += \
    174         $(foreach f,$(VBOX_MANUAL_LANGUAGES), $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/$f/,$(VBOX_MANUAL_XML_FILES))) \
     177        $(foreach f,$(VBOX_MANUAL_LANGUAGES), $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/$f/,$(VBOX_MANUAL_XML_FILES_INCL_CHANGELOG))) \
    175178        $(foreach f,en_US,                    $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/$f/,$(VBOX_SDKREF_XML_FILES))) \
    176179        $(foreach f,$(VBOX_MANUAL_LANGUAGES), $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/$f/,$(VBOX_MANUAL_LATEX_FILES_TARGET))) \
    … …  
    271274
    272275# Only one changelog for all languages
    273 $(VBOX_PATH_MANUAL_OUTBASE)/$(VBOX_MANUAL_XML_CHANGELOG): $(VBOX_PATH_MANUAL_SRC)/$(VBOX_MANUAL_XML_CHANGELOG) | $$(dir $$@)
    274         $(QUIET)$(INSTALL) -m 0644 $< $@
     276# $(VBOX_PATH_MANUAL_OUTBASE)/$(VBOX_MANUAL_XML_CHANGELOG): $(VBOX_PATH_MANUAL_SRC)/$(VBOX_MANUAL_XML_CHANGELOG) | $$(dir $$@)
     277#       $(QUIET)$(INSTALL) -m 0644 $< $@
    275278
    276279# intermediate step to do some variable replacement in the document
    … …  
    288291                       --output [email protected] $<
    289292        $(QUIET)$(MV) -f [email protected] $@
     293
     294$(foreach f,$(VBOX_MANUAL_LANGUAGES),$(VBOX_PATH_MANUAL_OUTBASE)/$f/user_ChangeLog.xml): \
     295                $(VBOX_PATH_MANUAL_OUTBASE)/% : \
     296                $(VBOX_PATH_MANUAL_SRC)/% $(VBOX_PATH_MANUAL_SRC)/user_ChangeLogImpl.xml | $$(dir $$@)
     297        $(call MSG_L1,Pre-processing [3] $(@F) to $@)
     298        $(QUIET)$(RM) -f $@ [email protected] [email protected]
     299        $(QUIET)$(SED) -e 's/\$$VBOX_VERSION_MAJOR/$(VBOX_VERSION_MAJOR)/g' \
     300                       -e 's/\$$VBOX_VERSION_MINOR/$(VBOX_VERSION_MINOR)/g' \
     301                       -e 's/\$$VBOX_VERSION_BUILD/$(VBOX_VERSION_BUILD)/g' \
     302                       -e 's/\$$VBOX_VERSION_STRING/$(VBOX_VERSION_STRING)/g' \
     303                       -e 's/\$$VBOX_VENDOR/$(VBOX_VENDOR)/g' \
     304                       -e 's/\$$VBOX_PRODUCT/$(VBOX_PRODUCT)/g' \
     305                       -e 's/\$$VBOX_C_YEAR/$(VBOX_C_YEAR)/g' \
     306                       --output [email protected] $<
     307        $(QUIET)$(SED) -e '1,/<!--\$$VIRTUALBOX_CHANGELOG_IMPL-->/!d' \
     308                       -e 's/<!--\$$VIRTUALBOX_CHANGELOG_IMPL-->//' \
     309                       --output $@ [email protected]
     310        $(QUIET)$(SED) -e 's/<?xml version=\"1.0\" encoding=\"UTF-8\"?>//g' --append $@ $(VBOX_PATH_MANUAL_SRC)/user_ChangeLogImpl.xml
     311        $(QUIET)$(SED) -e '/<!--\$$VIRTUALBOX_CHANGELOG_IMPL-->/,$$!d' \
     312                       -e 's/<!--\$$VIRTUALBOX_CHANGELOG_IMPL-->//' --append $@ [email protected]
    290313
    291314$(foreach f,$(VBOX_MANUAL_LANGUAGES),$(VBOX_PATH_MANUAL_OUTBASE)/$f/user_VBoxManage.xml): \
    … …  
    495518$(foreach f,$(VBOX_MANUAL_LANGUAGES),$(VBOX_PATH_MANUAL_OUTBASE)/$f/UserManual.tex): \
    496519                                $(VBOX_PATH_MANUAL_OUTBASE)/%/UserManual.tex : \
    497                                 $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/%/,$(VBOX_MANUAL_XML_FILES)) \
     520                                $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/%/,$(VBOX_MANUAL_XML_FILES_INCL_CHANGELOG)) \
    498521                                $(VBOX_PATH_MANUAL_OUTBASE)/$(VBOX_MANUAL_XML_CHANGELOG) \
    499522                                $(VBOX_PATH_MANUAL_SRC)/docbook2latex.xsl \
    … …  
    583606$(foreach f,$(VBOX_MANUAL_LANGUAGES),$(VBOX_PATH_MANUAL_OUTBASE)/$f/HTMLHelp/htmlhelp.hhp): \
    584607                $(VBOX_PATH_MANUAL_OUTBASE)/%/HTMLHelp/htmlhelp.hhp: \
    585                 $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/%/,$(VBOX_MANUAL_XML_FILES)) \
     608                $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/%/,$(VBOX_MANUAL_XML_FILES_INCL_CHANGELOG)) \
    586609                $(VBOX_PATH_MANUAL_OUTBASE)/$(VBOX_MANUAL_XML_CHANGELOG) \
    587610                $(VBOX_PATH_MANUAL_OUTBASE)/%/docbook-htmlhelp-formatcfg.xsl \
    … …  
    646669                $(VBOX_PATH_MANUAL_OUTBASE)/en_US/docbook-html-one-page-formatcfg.xsl \
    647670                $(VBOX_PATH_MANUAL_OUTBASE)/en_US/UserManual.xml \
    648                 $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/en_US/,$(VBOX_MANUAL_XML_FILES)) \
     671                $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/en_US/,$(VBOX_MANUAL_XML_FILES_INCL_CHANGELOG)) \
    649672                $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/en_US/,$(VBOX_MANUAL_PNG_FILES_en_US)) \
    650673                $(VBOX_PATH_MANUAL_OUTBASE)/$(VBOX_MANUAL_XML_CHANGELOG)
    … …  
    658681                $(VBOX_PATH_MANUAL_OUTBASE)/en_US/docbook-html-chunks-formatcfg.xsl \
    659682                $(VBOX_PATH_MANUAL_OUTBASE)/en_US/UserManual.xml \
    660                 $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/en_US/,$(VBOX_MANUAL_XML_FILES)) \
     683                $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/en_US/,$(VBOX_MANUAL_XML_FILES_INCL_CHANGELOG)) \
    661684                $(addprefix $(VBOX_PATH_MANUAL_OUTBASE)/en_US/,$(VBOX_MANUAL_PNG_FILES_en_US)) \
    662685                $(VBOX_PATH_MANUAL_OUTBASE)/$(VBOX_MANUAL_XML_CHANGELOG)

  • trunk/doc/manual/en_US/UserManual.xml

    r34797 r34802  
    22<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
    33  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
    4 <book xmlns:xi="http://www.w3.org/2001/XInclude">
     4<book>
    55  <bookinfo>
    66    <title>$VBOX_PRODUCT<superscript>®</superscript></title>
    … …  
    6161    xmlns:xi="http://www.w3.org/2001/XInclude" />
    6262
    63   <xi:include href="../user_ChangeLogImpl.xml"
     63  <xi:include href="user_ChangeLog.xml" xpointer="element(/1)"
    6464    xmlns:xi="http://www.w3.org/2001/XInclude" />
    6565

  • trunk/doc/manual/en_US/user_ChangeLog.xml

    r34796 r34802  
    1414  In addition, each build contains a revision number.</para>
    1515
    16   <xi:include href="../user_ChangeLogImpl.xml" xpointer="element(/1)"
    17     xmlns:xi="http://www.w3.org/2001/XInclude" />
     16<!--$VIRTUALBOX_CHANGELOG_IMPL-->
    1817
    1918</chapter>

  • trunk/doc/manual/user_ChangeLogImpl.xml

    r34797 r34802  
    11<?xml version="1.0" encoding="UTF-8"?>
    2 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
    3   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
    4 <chapter xmlns:xi="http://www.w3.org/2001/XInclude">
    5   <title>Change log</title>
    6 
    7   <para>This section summarizes the changes between VirtualBox versions. Note
    8     that this change log is not exhaustive; not all changes are listed.</para>
    9 
    10   <para>VirtualBox version numbers consist of three numbers separated by dots
    11     where the first and second number represent the major version and the 3rd number
    12     the minor version. Minor version numbers of official releases are always even.
    13     An odd minor version number represents an internal development or test build.
    14     In addition, each build contains a revision number.</para>
    152
    163  <sect1>
    … …  
    58145801  </sect1>
    58155802
    5816   <para>With VirtualBox 3.2, changelog information for versions before 2.0 were removed in order to save space.
    5817     To access this information, please consult the user manual of VirtualBox 3.1 or earlier.</para>
    5818 
    5819 </chapter>
     5803  <para>In VirtualBox 3.2, changelog information for versions before 2.0 were removed in order to save space.
     5804  To access this information, please consult the user manual of VirtualBox 3.1 or earlier.</para>
     5805
     5806
Note: See TracChangeset for help on using the changeset viewer.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette