VirtualBox

Changeset 99497 in vbox


Ignore:
Timestamp:
Apr 21, 2023 1:55:02 AM (20 months ago)
Author:
vboxsync
Message:

manual: Split out the topics of converted manpages into separate files and generate ditamap files for each manpage to avoid needing to hardcode anything in UserManual.xml. This means that the topics inside a manpage can be supressed from the toc, but otoh, they get numbered (with 4.x). The per-topic files are named by refentry/refsect1/refsect2 @id and are currently not cleaned up by 'kmk clean'. bugref:10302

Location:
trunk/doc/manual
Files:
3 added
57 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/manual/Makefile.kmk

    r99268 r99497  
    111111 # DITA-OT related globals.
    112112 #
     113 VBOX_DITA_TECHNICAL_CONTENT_DTD_PATH = $(VBOX_DITA_ORIGINAL_PATH)/dtd/technicalContent/dtd
    113114
    114115 ##
    … …  
    146147  VBOX_JAVA_HOME          := C:/Program Files/Java/jdk-17/
    147148  VBOX_DITA_ORIGINAL_PATH := D:/Tmp/dita/dita-ot-4.0.2
     149  VBOX_DITA_TECHNICAL_CONTENT_DTD_PATH = $(VBOX_DITA_ORIGINAL_PATH)/plugins/org.oasis-open.dita.v1_2/dtd/technicalContent/dtd
    148150  VBOX_DITA_CLASSPATH = \
    149151        $(subst $(SP),;,$(strip \
    … …  
    637639                | $$$$(dir $$$$@)
    638640        $$(call MSG_L1, $$<)
    639         $$(APPEND) -nt "[email protected]" $$(filter-out %.py,$$^)
     641        $$(QUIET)$$(APPEND) -nt "[email protected]" $$(filter-out %.py,$$^)
    640642        $$(QUIET)$$(VBOX_BLD_PYTHON) "$$<" --output "$$@" @"[email protected]"
    641643
    … …  
    650652 # @param 2    Filename w/o extension.
    651653 # @param 3    Alternative fallback filename (for isomakercmd-man.xml).
     654 # @note This produces more files that listed in the output, but we currently let kmk be ignorant of that.
    652655 define def_vbox_refentry_file_to_dita
    653   VBOX_USER_MANUAL_CONVERTED_REFENTRY_DITA_FILES_$1 += $$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/$(2).dita
    654   $$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/$(2).dita \
    655   + $$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/$(2).xml: \
     656  VBOX_USER_MANUAL_CONVERTED_REFENTRY_DITA_FILES_$1 += $$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/$(2).ditamap
     657  $$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/$(2).ditamap \
     658  + $$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/flat-$(2).dita \
     659  + $$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/flat-$(2).xml: \
    656660                $$(VBOX_PATH_MANUAL_SRC)/docbook-refentry-to-manual-dita-pre.xsl \
    657661                $$(VBOX_PATH_MANUAL_SRC)/docbook-refentry-to-manual-dita.xsl \
     662                $$(VBOX_PATH_MANUAL_SRC)/dita-refentry-flat-to-single-topic.sh \
     663                $$(VBOX_PATH_MANUAL_SRC)/dita-refentry-flat-to-single-topic.xsl \
     664                $$(VBOX_PATH_MANUAL_SRC)/dita-refentry-flat-topic-ids.xsl \
    658665                $$(VBOX_PATH_MANUAL_SRC)/add_file_to_id_only_references.py \
    659666                $$(VBOX_USER_MANUAL_ID_MAPPING_FILE_$1) \
    … …  
    666673                | $$$$(dir $$$$@)
    667674        $$(call MSG_TOOL,xsltproc docbook-refentry-to-manual-dita[-pre].xsl,,$$(firstword $$(filter %.xml,$$^)),$$@)
    668         $$(QUIET)$$(RM) -f -- "$$@" "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/$(2).xml"
     675        $$(QUIET)$$(RM) -f -- "$$@" \
     676                "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/flat-$(2).xml" \
     677                "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/flat-$(2).dita"
    669678        $$(QUIET)$$(call VBOX_XSLTPROC_WITH_CAT) \
    670                 --output "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/$(2).xml" \
     679                --output "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/flat-$(2).xml" \
    671680                $$(VBOX_PATH_MANUAL_SRC)/docbook-refentry-to-manual-dita-pre.xsl \
    672681                $$(qfirstfile , $$(qwildcard , $$(VBOX_PATH_MANUAL_SRC)/$(1)/$(2).xml) $(3) $$(VBOX_PATH_MANUAL_SRC)/en_US/$(2).xml)
    673682        $$(QUIET)$$(call VBOX_XSLTPROC_WITH_CAT) \
    674683                $(if-expr defined(VBOX_DITA_USING_LATEST),--stringparam "g_fReplaceHypens" "true",) \
    675                 --output "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/$(2).dita" \
     684                --output "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/flat-$(2).dita" \
    676685                $$(VBOX_PATH_MANUAL_SRC)/docbook-refentry-to-manual-dita.xsl \
    677                 "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/$(2).xml"
     686                "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/flat-$(2).xml"
    678687        $$(QUIET)$$(VBOX_BLD_PYTHON) $$(VBOX_PATH_MANUAL_SRC)/add_file_to_id_only_references.py \
    679                 --mapping-file "$$(VBOX_USER_MANUAL_ID_MAPPING_FILE_$1)" "$$@"
     688                --mapping-file "$$(VBOX_USER_MANUAL_ID_MAPPING_FILE_$1)" \
     689                "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/flat-$(2).dita"
     690        $$(QUIET)$$(ASH) \
     691                "$$(VBOX_PATH_MANUAL_SRC)/dita-refentry-flat-to-single-topic.sh" \
     692                "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/flat-$(2).dita" \
     693                "$$(VBOX_PATH_MANUAL_SRC)/dita-refentry-flat-topic-ids.xsl" \
     694                "$$(VBOX_PATH_MANUAL_SRC)/dita-refentry-flat-to-single-topic.xsl" \
     695                "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics" \
     696                -- $$(subst $$(REDIRECT),$$(REDIRECT_EXT),$$(call VBOX_XSLTPROC_WITH_CAT)) \
     697                --path "$$(VBOX_DITA_TECHNICAL_CONTENT_DTD_PATH)"
     698        $$(QUIET)$$(call VBOX_XSLTPROC_WITH_CAT) \
     699                --path "$$(VBOX_DITA_TECHNICAL_CONTENT_DTD_PATH)" \
     700                --stringparam g_sMode map \
     701                --output "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/$(2).ditamap" \
     702                $$(VBOX_PATH_MANUAL_SRC)/dita-refentry-flat-to-single-topic.xsl \
     703                "$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/topics/flat-$(2).dita"
     704
    680705 endef # def_vbox_refentry_file_to_dita
    681706
    … …  
    733758                "/tempdir:$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/temp_pdf" \
    734759                , \
    735                $(if-expr defined(VBOX_DITA_DEBUG),"/cleantemp:no",) \
     760               "/grammarcache:yes" \
     761               $(if-expr defined(VBOX_DITA_DEBUG),"/cleantemp:no" "/debug:yes",) \
    736762                , \
    737763                "--theme=$$(VBOX_PATH_MANUAL_SRC)/pdf-theme-UserManual.yaml" \
    … …  
    741767
    742768  ditamap-to-pdf: $$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/UserManual.pdf
     769  .PRECIOUS: $$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/UserManual_pdf.log
    743770 endef
    744771 $(foreach lang,$(VBOX_MANUAL_ALL_LANGUAGES),$(evalcall2 def_ditamap_to_pdf,$(lang)))
    … …  
    769796                "/outdir:$(@D)" \
    770797                "/tempdir:$(VBOX_PATH_MANUAL_OUTBASE)/en_US/dita/temp_xhtml_chunks" \
    771                 ,,"--logfile=$(@D)/UserManual_xhtml.log")
     798                , \
     799               "/grammarcache:yes" \
     800               , \
     801               "--logfile=$(@D)/UserManual_xhtml.log")
    772802
    773803 html:: $(VBOX_PATH_MANUAL_OUTBASE)/en_US/html-chunks/index.html
    … …  
    795825                "/outdir:$(@D)" \
    796826                "/tempdir:$(VBOX_PATH_MANUAL_OUTBASE)/en_US/dita/temp_xhtml_single" \
    797                 ,,"--logfile=$(@D)/UserManual-Single_xhtml.log")
     827                , \
     828               "/grammarcache:yes" \
     829               , \
     830               "--logfile=$(@D)/UserManual-Single_xhtml.log")
    798831        $(SED) -ne '1,/<body>/{p}' \
    799832                --output "$@" "$(@D)/UserManual-Single.html"
    … …  
    888921                "/outdir:$(2)" \
    889922                "/tempdir:$$(VBOX_PATH_MANUAL_OUTBASE)/$(1)/dita/temp_qhelp" \
    890                 ,,"--logfile=$(2)/UserManual_htmlhelp.log")
     923                , \
     924               "/grammarcache:yes" \
     925               , \
     926               "--logfile=$(2)/UserManual_htmlhelp.log")
    891927
    892928

  • trunk/doc/manual/build_id_to_file_mapping.py

    r99059 r99497  
    6262        sId = oMatch.group(2)[1:-1];
    6363        if sId:
    64             dIdToFile[sId] = sFile;
     64            #dIdToFile[sId] = sFile;
     65            dIdToFile[sId] = '%s.dita' % (sId,);
    6566
    6667def isDocbook(sContent):

  • trunk/doc/manual/docbook-refentry-to-manual-dita.xsl

    r99272 r99497  
    204204          <xsl:choose>
    205205            <xsl:when test="@id"><xsl:value-of select="@id"/></xsl:when>
    206             <xsl:otherwise><xsl:value-of select="concat(generate-id(),'-',/@id)"/></xsl:otherwise>
     206            <xsl:otherwise><xsl:value-of select="concat(../@id, '-no', count(./preceding-sibling::refsect1))"/></xsl:otherwise>
    207207          </xsl:choose>
    208208        </xsl:attribute>
    … …  
    261261          <xsl:choose>
    262262            <xsl:when test="@id"><xsl:value-of select="@id"/></xsl:when>
    263             <xsl:otherwise><xsl:value-of select="concat(generate-id(),'-',/@id)"/></xsl:otherwise>
     263            <xsl:otherwise>
     264              <xsl:if test="not(../@id)">
     265                <xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>both refsect2 and parent refsect1 are missing an @id attribute! Please fix add at least one of these to facilitate proper dita topic splitting.</xsl:message>
     266              </xsl:if>
     267              <xsl:value-of select="concat(../@id, '-no', count(./preceding-sibling::refsect2))"/>
     268            </xsl:otherwise>
    264269          </xsl:choose>
    265270        </xsl:attribute>

  • trunk/doc/manual/en_US/dita/UserManual.ditamap

    r99408 r99497  
    368368      </topicref>
    369369      <topicref href="topics/teleporting.dita"/>
    370       <topicref href="topics/man_VBoxHeadless.dita"/>
     370      <topicref format="ditamap" href="topics/man_VBoxHeadless.ditamap"/>
    371371   </chapter>
    372372
    … …  
    377377      <!--  <topicref href="topics/vboxmanage-cmd-overview.dita"/> -->
    378378      <topicref href="topics/vboxmanage-general.dita"/>
    379       <topicref href="topics/man_VBoxManage-common.dita"/>
     379      <!-- The remainder of the topics in this chapter are generated from docbook XML files.-->
     380      <topicref  format="ditamap" href="topics/man_VBoxManage-common.ditamap"/>
    380381      <!-- Note! We sort these alphabetical unless someone can define a
    381382                 maintainable ordering (previously it seemed to be total
    382383                 random and included several duplicates). -->
    383       <topicref href="topics/man_VBoxManage-adoptstate.dita"/>
    384       <topicref href="topics/man_VBoxManage-bandwidthctl.dita"/>
    385       <topicref href="topics/man_VBoxManage-checkmediumpwd.dita"/>
    386       <topicref href="topics/man_VBoxManage-clonemedium.dita"/>
    387       <topicref href="topics/man_VBoxManage-clonevm.dita"/>
    388       <topicref href="topics/man_VBoxManage-closemedium.dita"/>
    389       <topicref href="topics/man_VBoxManage-cloud.dita"/>
    390       <topicref href="topics/man_VBoxManage-cloudprofile.dita"/>
    391       <topicref href="topics/man_VBoxManage-controlvm.dita"/>
    392       <topicref href="topics/man_VBoxManage-convertfromraw.dita"/>
    393       <topicref href="topics/man_VBoxManage-createmedium.dita"/>
    394       <topicref href="topics/man_VBoxManage-createvm.dita"/>
    395       <topicref href="topics/man_VBoxManage-debugvm.dita"/>
    396       <topicref href="topics/man_VBoxManage-dhcpserver.dita"/>
    397       <topicref href="topics/man_VBoxManage-discardstate.dita"/>
    398       <topicref href="topics/man_VBoxManage-encryptmedium.dita"/>
    399       <topicref href="topics/man_VBoxManage-encryptvm.dita"/>
    400       <topicref href="topics/man_VBoxManage-export.dita"/>
    401       <topicref href="topics/man_VBoxManage-extpack.dita"/>
    402       <topicref href="topics/man_VBoxManage-getextradata.dita"/>
    403       <topicref href="topics/man_VBoxManage-guestcontrol.dita"/>
    404       <topicref href="topics/man_VBoxManage-guestproperty.dita"/>
    405       <topicref href="topics/man_VBoxManage-hostonlyif.dita"/>
    406       <topicref href="topics/man_VBoxManage-hostonlynet.dita"/>
    407       <topicref href="topics/man_VBoxManage-import.dita"/>
    408       <topicref href="topics/man_VBoxManage-list.dita"/>
    409       <topicref href="topics/man_VBoxManage-mediumio.dita"/>
    410       <topicref href="topics/man_VBoxManage-mediumproperty.dita"/>
    411       <topicref href="topics/man_VBoxManage-metrics.dita"/>
    412       <topicref href="topics/man_VBoxManage-modifymedium.dita"/>
    413       <topicref href="topics/man_VBoxManage-modifynvram.dita"/>
    414       <topicref href="topics/man_VBoxManage-modifyvm.dita"/>
    415       <topicref href="topics/man_VBoxManage-movevm.dita"/>
    416       <topicref href="topics/man_VBoxManage-natnetwork.dita"/>
    417       <topicref href="topics/man_VBoxManage-registervm.dita"/>
    418       <topicref href="topics/man_VBoxManage-setextradata.dita"/>
    419       <topicref href="topics/man_VBoxManage-setproperty.dita"/>
    420       <topicref href="topics/man_VBoxManage-sharedfolder.dita"/>
    421       <topicref href="topics/man_VBoxManage-showmediuminfo.dita"/>
    422       <topicref href="topics/man_VBoxManage-showvminfo.dita"/>
    423       <topicref href="topics/man_VBoxManage-signova.dita"/>
    424       <topicref href="topics/man_VBoxManage-snapshot.dita"/>
    425       <topicref href="topics/man_VBoxManage-startvm.dita"/>
    426       <topicref href="topics/man_VBoxManage-storageattach.dita"/>
    427       <topicref href="topics/man_VBoxManage-storagectl.dita"/>
    428       <topicref href="topics/man_VBoxManage-unattended.dita"/>
    429       <topicref href="topics/man_VBoxManage-unregistervm.dita"/>
    430       <topicref href="topics/man_VBoxManage-updatecheck.dita"/>
    431       <topicref href="topics/man_VBoxManage-usbdevsource.dita"/>
    432       <topicref href="topics/man_VBoxManage-usbfilter.dita"/>
     384      <topicref format="ditamap" href="topics/man_VBoxManage-adoptstate.ditamap"/>
     385      <topicref format="ditamap" href="topics/man_VBoxManage-bandwidthctl.ditamap"/>
     386      <topicref format="ditamap" href="topics/man_VBoxManage-checkmediumpwd.ditamap"/>
     387      <topicref format="ditamap" href="topics/man_VBoxManage-clonemedium.ditamap"/>
     388      <topicref format="ditamap" href="topics/man_VBoxManage-clonevm.ditamap"/>
     389      <topicref format="ditamap" href="topics/man_VBoxManage-closemedium.ditamap"/>
     390      <topicref format="ditamap" href="topics/man_VBoxManage-cloud.ditamap"/>
     391      <topicref format="ditamap" href="topics/man_VBoxManage-cloudprofile.ditamap"/>
     392      <topicref format="ditamap" href="topics/man_VBoxManage-controlvm.ditamap"/>
     393      <topicref format="ditamap" href="topics/man_VBoxManage-convertfromraw.ditamap"/>
     394      <topicref format="ditamap" href="topics/man_VBoxManage-createmedium.ditamap"/>
     395      <topicref format="ditamap" href="topics/man_VBoxManage-createvm.ditamap"/>
     396      <topicref format="ditamap" href="topics/man_VBoxManage-debugvm.ditamap"/>
     397      <topicref format="ditamap" href="topics/man_VBoxManage-dhcpserver.ditamap"/>
     398      <topicref format="ditamap" href="topics/man_VBoxManage-discardstate.ditamap"/>
     399      <topicref format="ditamap" href="topics/man_VBoxManage-encryptmedium.ditamap"/>
     400      <topicref format="ditamap" href="topics/man_VBoxManage-encryptvm.ditamap"/>
     401      <topicref format="ditamap" href="topics/man_VBoxManage-export.ditamap"/>
     402      <topicref format="ditamap" href="topics/man_VBoxManage-extpack.ditamap"/>
     403      <topicref format="ditamap" href="topics/man_VBoxManage-getextradata.ditamap"/>
     404      <topicref format="ditamap" href="topics/man_VBoxManage-guestcontrol.ditamap"/>
     405      <topicref format="ditamap" href="topics/man_VBoxManage-guestproperty.ditamap"/>
     406      <topicref format="ditamap" href="topics/man_VBoxManage-hostonlyif.ditamap"/>
     407      <topicref format="ditamap" href="topics/man_VBoxManage-hostonlynet.ditamap"/>
     408      <topicref format="ditamap" href="topics/man_VBoxManage-import.ditamap"/>
     409      <topicref format="ditamap" href="topics/man_VBoxManage-list.ditamap"/>
     410      <topicref format="ditamap" href="topics/man_VBoxManage-mediumio.ditamap"/>
     411      <topicref format="ditamap" href="topics/man_VBoxManage-mediumproperty.ditamap"/>
     412      <topicref format="ditamap" href="topics/man_VBoxManage-metrics.ditamap"/>
     413      <topicref format="ditamap" href="topics/man_VBoxManage-modifymedium.ditamap"/>
     414      <topicref format="ditamap" href="topics/man_VBoxManage-modifynvram.ditamap"/>
     415      <topicref format="ditamap" href="topics/man_VBoxManage-modifyvm.ditamap"/>
     416      <topicref format="ditamap" href="topics/man_VBoxManage-movevm.ditamap"/>
     417      <topicref format="ditamap" href="topics/man_VBoxManage-natnetwork.ditamap"/>
     418      <topicref format="ditamap" href="topics/man_VBoxManage-registervm.ditamap"/>
     419      <topicref format="ditamap" href="topics/man_VBoxManage-setextradata.ditamap"/>
     420      <topicref format="ditamap" href="topics/man_VBoxManage-setproperty.ditamap"/>
     421      <topicref format="ditamap" href="topics/man_VBoxManage-sharedfolder.ditamap"/>
     422      <topicref format="ditamap" href="topics/man_VBoxManage-showmediuminfo.ditamap"/>
     423      <topicref format="ditamap" href="topics/man_VBoxManage-showvminfo.ditamap"/>
     424      <topicref format="ditamap" href="topics/man_VBoxManage-signova.ditamap"/>
     425      <topicref format="ditamap" href="topics/man_VBoxManage-snapshot.ditamap"/>
     426      <topicref format="ditamap" href="topics/man_VBoxManage-startvm.ditamap"/>
     427      <topicref format="ditamap" href="topics/man_VBoxManage-storageattach.ditamap"/>
     428      <topicref format="ditamap" href="topics/man_VBoxManage-storagectl.ditamap"/>
     429      <topicref format="ditamap" href="topics/man_VBoxManage-unattended.ditamap"/>
     430      <topicref format="ditamap" href="topics/man_VBoxManage-unregistervm.ditamap"/>
     431      <topicref format="ditamap" href="topics/man_VBoxManage-updatecheck.ditamap"/>
     432      <topicref format="ditamap" href="topics/man_VBoxManage-usbdevsource.ditamap"/>
     433      <topicref format="ditamap" href="topics/man_VBoxManage-usbfilter.ditamap"/>
    433434      <!-- End sorted manpage topics. -->
    434       <topicref href="topics/man_vboximg-mount.dita"/>
     435      <topicref format="ditamap" href="topics/man_vboximg-mount.ditamap"/>
    435436   </chapter>
    436437
    … …  
    559560         <topicref href="topics/vboxsvc-session-0-known-issues.dita"/>
    560561      </topicref>
    561       <topicref href="topics/user_isomakercmd-man.dita"/>
     562      <topicref format="ditamap" href="topics/user_isomakercmd-man.ditamap"/>
    562563   </chapter>
    563564   <chapter href="topics/TechnicalBackground.dita">

  • trunk/doc/manual/en_US/dita/topics/auth-config-using.dita

    r98549 r99497  
    2121            configuration and is therefore potentially readable on the
    2222            host. See <xref href="storage-iscsi.dita">iSCSI Servers</xref> and
    23             <xref href="man_VBoxManage-storageattach.dita">VBoxManage storageattach</xref>.
     23            <xref href="vboxmanage-storageattach.dita">VBoxManage storageattach</xref>.
    2424          </p>
    2525      </li>

  • trunk/doc/manual/en_US/dita/topics/clone.dita

    r99182 r99497  
    182182    <p>
    183183      You can also use the <userinput>VBoxManage clonevm</userinput> command
    184       to clone a VM. See <xref href="man_VBoxManage-clonevm.dita#vboxmanage-clonevm"/>.
     184      to clone a VM. See <xref href="vboxmanage-clonevm.dita"/>.
    185185    </p>
    186186  </body>

  • trunk/doc/manual/en_US/dita/topics/cloningvdis.dita

    r98549 r99497  
    1010      However, you should <i>only</i> make copies of
    1111      virtual disk images using the utility supplied with
    12       Oracle VM VirtualBox. See <xref href="man_VBoxManage-clonemedium.dita#vboxmanage-clonemedium"/>.
     12      Oracle VM VirtualBox. See <xref href="vboxmanage-clonemedium.dita"/>.
    1313      This is because Oracle VM VirtualBox assigns a UUID to each disk image,
    1414      which is also stored inside the image, and Oracle VM VirtualBox will

  • trunk/doc/manual/en_US/dita/topics/cloud-create-cloud-profile.dita

    r98549 r99497  
    9090            Automatically, by using the <userinput>VBoxManage
    9191            cloudprofile</userinput> command. See
    92             <xref href="man_VBoxManage-cloudprofile.dita#vboxmanage-cloudprofile"/>.
     92            <xref href="vboxmanage-cloudprofile.dita"/>.
    9393          </p>
    9494      </li>

  • trunk/doc/manual/en_US/dita/topics/cloud-export-oci.dita

    r99182 r99497  
    153153        You can also use the <userinput>VBoxManage export</userinput>
    154154        command to export a VM to Oracle Cloud Infrastructure. See
    155         <xref href="man_VBoxManage-export.dita"/>.
     155        <xref href="vboxmanage-export.dita"/>.
    156156      </p>
    157157  </body>

  • trunk/doc/manual/en_US/dita/topics/cloud-import-oci.dita

    r99182 r99497  
    6767        You can also use the <userinput>VBoxManage import</userinput>
    6868        command to import an instance from Oracle Cloud Infrastructure. See
    69         <xref href="man_VBoxManage-import.dita"/>.
     69        <xref href="vboxmanage-import.dita"/>.
    7070      </p>
    7171  </body>

  • trunk/doc/manual/en_US/dita/topics/cloud-using-cli.dita

    r98549 r99497  
    8181    <p>
    8282        For more details about the available commands for cloud
    83         operations, see <xref href="man_VBoxManage-cloud.dita#vboxmanage-cloud"/>.
     83        operations, see <xref href="vboxmanage-cloud.dita"/>.
    8484      </p>
    8585  </body>

  • trunk/doc/manual/en_US/dita/topics/cloud-using-cloud-networks.dita

    r98549 r99497  
    4646                gateway instance and the IP address range used by the
    4747                tunneling network. See
    48                 <xref href="man_VBoxManage-cloud.dita#vboxmanage-cloud"/>.
     48                <xref href="vboxmanage-cloud.dita"/>.
    4949              </p>
    5050            <p>

  • trunk/doc/manual/en_US/dita/topics/collect-debug-info.dita

    r98549 r99497  
    5959        You can also use <userinput>VBoxManage debugvm</userinput> to create
    6060        a dump of a complete virtual machine. See
    61         <xref href="man_VBoxManage-debugvm.dita">VBoxManage debugvm</xref>.
     61        <xref href="vboxmanage-debugvm.dita">VBoxManage debugvm</xref>.
    6262      </p>
    6363    <p>

  • trunk/doc/manual/en_US/dita/topics/cpuhotplug.dita

    r98549 r99497  
    5454$ VBoxManage controlvm <varname>VM-name</varname> unplugcpu 3</pre>
    5555    <p>
    56       See <xref href="man_VBoxManage-modifyvm.dita">VBoxManage modifyvm</xref> and
    57       <xref href="man_VBoxManage-controlvm.dita">VBoxManage controlvm</xref> for details.
     56      See <xref href="vboxmanage-modifyvm.dita">VBoxManage modifyvm</xref> and
     57      <xref href="vboxmanage-controlvm.dita">VBoxManage controlvm</xref> for details.
    5858    </p>
    5959    <p>

  • trunk/doc/manual/en_US/dita/topics/create-vm-wizard-virtual-hard-disk.dita

    r99182 r99497  
    120120        or Linux guest, you will probably need several gigabytes for any
    121121        serious use. The limit of the image file size can be changed
    122         later, see <xref href="man_VBoxManage-modifymedium.dita#vboxmanage-modifymedium"/>.
     122        later, see <xref href="vboxmanage-modifymedium.dita"/>.
    123123      </p>
    124124    <note>

  • trunk/doc/manual/en_US/dita/topics/guestadd-balloon.dita

    r98549 r99497  
    7171        the virtual machine in question and <varname>n</varname>
    7272        is the amount of memory to allocate from the guest in megabytes.
    73         See <xref href="man_VBoxManage-controlvm.dita#vboxmanage-controlvm"/>.
     73        See <xref href="vboxmanage-controlvm.dita"/>.
    7474      </p>
    7575    <p>
    … …  
    8383        setting, like other <userinput>modifyvm</userinput> settings, and
    8484        therefore can only be set while the machine is shut down. See
    85         <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>.
     85        <xref href="vboxmanage-modifyvm.dita"/>.
    8686      </p>
    8787  </body>

  • trunk/doc/manual/en_US/dita/topics/guestadd-guestcontrol.dita

    r98549 r99497  
    2626    <p>
    2727      To use these features, use the Oracle VM VirtualBox command line. See
    28       <xref href="man_VBoxManage-guestcontrol.dita#vboxmanage-guestcontrol"/>.
     28      <xref href="vboxmanage-guestcontrol.dita"/>.
    2929    </p>
    3030  </body>

  • trunk/doc/manual/en_US/dita/topics/guestadd-guestprops.dita

    r98549 r99497  
    5454      A more flexible way to use this channel is with the
    5555      <userinput>VBoxManage guestproperty</userinput> command. See
    56       <xref href="man_VBoxManage-guestproperty.dita#vboxmanage-guestproperty"/>. For example, to have
     56      <xref href="vboxmanage-guestproperty.dita"/>. For example, to have
    5757      <i>all</i> the available guest properties for a
    5858      given running VM listed with their respective values, use this

  • trunk/doc/manual/en_US/dita/topics/guestadd-pagefusion.dita

    r98549 r99497  
    9292        <codeph>Guest/RAM/Usage/Shared</codeph> will return the amount
    9393        of fused memory for a given VM. See
    94         <xref href="man_VBoxManage-metrics.dita#vboxmanage-metrics"/> for information on how to
     94        <xref href="vboxmanage-metrics.dita"/> for information on how to
    9595        query metrics.
    9696      </p>

  • trunk/doc/manual/en_US/dita/topics/harddiskcontrollers.dita

    r98549 r99497  
    115115        <p>
    116116          To change the IDE compatibility mode settings for the SATA
    117           controller, see <xref href="man_VBoxManage-storagectl.dita#vboxmanage-storagectl"/>.
     117          controller, see <xref href="vboxmanage-storagectl.dita"/>.
    118118        </p>
    119119      </li>

  • trunk/doc/manual/en_US/dita/topics/hdimagewrites.dita

    r98549 r99497  
    1717      mark an existing image with one of the non-standard modes listed
    1818      below, use <userinput>VBoxManage modifymedium</userinput>. See
    19       <xref href="man_VBoxManage-modifymedium.dita#vboxmanage-modifymedium"/>. Alternatively, use
     19      <xref href="vboxmanage-modifymedium.dita"/>. Alternatively, use
    2020      <userinput>VBoxManage storageattach</userinput> to attach the image to
    2121      a VM and specify the <codeph>--mtype</codeph> argument. See
    22       <xref href="man_VBoxManage-storageattach.dita#vboxmanage-storageattach"/>.
     22      <xref href="vboxmanage-storageattach.dita"/>.
    2323    </p>
    2424    <p>
    … …  
    136136          <codeph>autoreset</codeph> parameter of <userinput>VBoxManage
    137137          modifymedium</userinput>. See
    138           <xref href="man_VBoxManage-modifymedium.dita#vboxmanage-modifymedium"/>.
     138          <xref href="vboxmanage-modifymedium.dita"/>.
    139139        </p>
    140140      </li>

  • trunk/doc/manual/en_US/dita/topics/install-ext-pack-manager.dita

    r98549 r99497  
    5252        Alternatively, you can use the <userinput>VBoxManage</userinput>
    5353        command line to install and manage Oracle VM VirtualBox extension
    54         packs. See <xref href="man_VBoxManage-extpack.dita#vboxmanage-extpack"/>.
     54        packs. See <xref href="vboxmanage-extpack.dita"/>.
    5555      </p>
    5656  </body>

  • trunk/doc/manual/en_US/dita/topics/intro-removing.dita

    r98549 r99497  
    4646        <p>
    4747          You can also use the <userinput>VBoxManage movevm</userinput>
    48           command to move a VM. See <xref href="man_VBoxManage-movevm.dita#vboxmanage-movevm"/>.
     48          command to move a VM. See <xref href="vboxmanage-movevm.dita"/>.
    4949        </p>
    5050      </li>

  • trunk/doc/manual/en_US/dita/topics/iocaching.dita

    r98549 r99497  
    8989    <pre xml:space="preserve">VBoxManage storagectl "VM name" --name &lt;controllername&gt; --hostiocache off</pre>
    9090    <p>
    91       See <xref href="man_VBoxManage-storagectl.dita#vboxmanage-storagectl"/>.
     91      See <xref href="vboxmanage-storagectl.dita"/>.
    9292    </p>
    9393    <p>

  • trunk/doc/manual/en_US/dita/topics/iscsi-intnet.dita

    r98549 r99497  
    1111        <xref href="storage-iscsi.dita">iSCSI Servers</xref>,
    1212        <xref href="network_internal.dita">Internal Networking</xref>, and
    13         <xref href="man_VBoxManage-storageattach.dita">VBoxManage storageattach</xref>.
     13        <xref href="vboxmanage-storageattach.dita">VBoxManage storageattach</xref>.
    1414      </p>
    1515    <p>

  • trunk/doc/manual/en_US/dita/topics/natforward.dita

    r98549 r99497  
    3838        Alternatively, the command line tool
    3939        <userinput>VBoxManage</userinput> can be used. See
    40         <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>.
     40        <xref href="vboxmanage-modifyvm.dita"/>.
    4141      </p>
    4242    <p>
    … …  
    9090    <p>
    9191        It is possible to configure incoming NAT connections while the
    92         VM is running, see <xref href="man_VBoxManage-controlvm.dita#vboxmanage-controlvm"/>.
     92        VM is running, see <xref href="vboxmanage-controlvm.dita"/>.
    9393      </p>
    9494  </body>

  • trunk/doc/manual/en_US/dita/topics/nested-virt.dita

    r98549 r99497  
    3636          <userinput>VBoxManage modifyvm</userinput> command to enable or
    3737          disable nested virtualization. See
    38           <xref href="man_VBoxManage-modifyvm.dita">VBoxManage modifyvm</xref>.
     38          <xref href="vboxmanage-modifyvm.dita">VBoxManage modifyvm</xref>.
    3939        </p>
    4040      </li>

  • trunk/doc/manual/en_US/dita/topics/nestedpaging.dita

    r98549 r99497  
    4747          to 5%. To enable this feature for a VM, you use the
    4848          <userinput>VBoxManage modifyvm --large-pages</userinput> command.
    49           See <xref href="man_VBoxManage-modifyvm.dita">VBoxManage modifyvm</xref>.
     49          See <xref href="vboxmanage-modifyvm.dita">VBoxManage modifyvm</xref>.
    5050        </p>
    5151        <p>
    … …  
    6666          <userinput>VBoxManage modifyvm --vtx-vpid</userinput> and
    6767          <userinput>VBoxManage modifyvm --large-pages</userinput> commands.
    68           See <xref href="man_VBoxManage-modifyvm.dita">VBoxManage modifyvm</xref>.
     68          See <xref href="vboxmanage-modifyvm.dita">VBoxManage modifyvm</xref>.
    6969        </p>
    7070      </li>

  • trunk/doc/manual/en_US/dita/topics/network_cloud.dita

    r98549 r99497  
    3232          On the command line, use <userinput>VBoxManage modifyvm
    3333          vmname --nic <varname>x</varname> cloud</userinput>. See
    34           <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>.
     34          <xref href="vboxmanage-modifyvm.dita"/>.
    3535        </p>
    3636      </li>

  • trunk/doc/manual/en_US/dita/topics/network_hostonly.dita

    r98549 r99497  
    7676          On the command line, use <userinput>VBoxManage modifyvm
    7777         vmname --nic <varname>x</varname> hostonly</userinput>. See
    78           <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>.
     78          <xref href="vboxmanage-modifyvm.dita"/>.
    7979        </p>
    8080      </li>
    … …  
    104104          Alternatively, you can use the <userinput>VBoxManage
    105105          dhcpserver</userinput> command. See
    106           <xref href="man_VBoxManage-dhcpserver.dita#vboxmanage-dhcpserver"/>.
     106          <xref href="vboxmanage-dhcpserver.dita"/>.
    107107        </p>
    108108      </li>

  • trunk/doc/manual/en_US/dita/topics/network_internal.dita

    r98549 r99497  
    7171      to use static IP addresses, you may want to use the DHCP server
    7272      that is built into Oracle VM VirtualBox to manage IP addresses for the
    73       internal network. See <xref href="man_VBoxManage-dhcpserver.dita#vboxmanage-dhcpserver"/>.
     73      internal network. See <xref href="vboxmanage-dhcpserver.dita"/>.
    7474    </p>
    7575    <p>

  • trunk/doc/manual/en_US/dita/topics/network_performance.dita

    r99016 r99497  
    7979          Settings</b> dialog for the network adaptor or use the
    8080          command line tool <userinput>VBoxManage</userinput>. See
    81           <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>.
     81          <xref href="vboxmanage-modifyvm.dita"/>.
    8282        </p>
    8383                     <p>

  • trunk/doc/manual/en_US/dita/topics/networkingdetails.dita

    r98549 r99497  
    3030    can configure all eight network cards on the command line using
    3131    <userinput>VBoxManage modifyvm</userinput>. See
    32     <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>.
     32    <xref href="vboxmanage-modifyvm.dita"/>.
    3333  </p>
    3434    <p>

  • trunk/doc/manual/en_US/dita/topics/ovf-export-appliance.dita

    r98549 r99497  
    9494    <p>
    9595        You can use the <userinput>VBoxManage export</userinput> command to
    96         export an appliance. See <xref href="man_VBoxManage-export.dita#vboxmanage-export"/>.
     96        export an appliance. See <xref href="vboxmanage-export.dita"/>.
    9797      </p>
    9898  </body>

  • trunk/doc/manual/en_US/dita/topics/ovf-import-appliance.dita

    r99182 r99497  
    104104    <p>
    105105        You can use the <userinput>VBoxManage import</userinput> command to
    106         import an appliance. See <xref href="man_VBoxManage-import.dita#vboxmanage-import"/>.
     106        import an appliance. See <xref href="vboxmanage-import.dita"/>.
    107107      </p>
    108108  </body>

  • trunk/doc/manual/en_US/dita/topics/serialports.dita

    r99016 r99497  
    3838      You can use either the Settings tabs or the
    3939      <userinput>VBoxManage</userinput> command to set up virtual serial
    40       ports. For the latter, see <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>
     40      ports. For the latter, see <xref href="vboxmanage-modifyvm.dita"/>
    4141      for information on the <codeph>--uart</codeph>,
    4242      <codeph>--uart-mode</codeph> and <codeph>--uart-type</codeph>

  • trunk/doc/manual/en_US/dita/topics/settings-acceleration.dita

    r99016 r99497  
    1717            available are documented under the
    1818           <codeph>--paravirt-provider</codeph> option in
    19             <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>. For further details
     19            <xref href="vboxmanage-modifyvm.dita"/>. For further details
    2020            on the paravirtualization providers, see
    2121            <xref href="gimproviders.dita">Paravirtualization Providers</xref>.

  • trunk/doc/manual/en_US/dita/topics/settings-motherboard.dita

    r99016 r99497  
    4141            VM will attempt to boot from a network using the PXE
    4242            mechanism. This needs to be configured in detail on the
    43             command line. See <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>.
     43            command line. See <xref href="vboxmanage-modifyvm.dita"/>.
    4444          </p>
    4545      </li>
    … …  
    154154        Linux support ACPI, it is also enabled by default in
    155155        Oracle VM VirtualBox. ACPI can only be turned off using the command
    156         line. See <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>.
     156        line. See <xref href="vboxmanage-modifyvm.dita"/>.
    157157      </p>
    158158    <note type="attention">

  • trunk/doc/manual/en_US/dita/topics/sharedfolders.dita

    r99016 r99497  
    5858                     <pre xml:space="preserve">VBoxManage sharedfolder add "VM name" --name "sharename" --hostpath "C:\test"</pre>
    5959                     <p>
    60           See <xref href="man_VBoxManage-sharedfolder.dita#vboxmanage-sharedfolder"/>.
     60          See <xref href="vboxmanage-sharedfolder.dita"/>.
    6161        </p>
    6262                  </li>

  • trunk/doc/manual/en_US/dita/topics/storage-cds.dita

    r99016 r99497  
    8989      <codeph>--passthrough</codeph> option of the <userinput>VBoxManage
    9090      storageattach</userinput> command. See
    91       <xref href="man_VBoxManage-storageattach.dita#vboxmanage-storageattach"/>.
     91      <xref href="vboxmanage-storageattach.dita"/>.
    9292    </p>
    9393               <p>

  • trunk/doc/manual/en_US/dita/topics/storage-iscsi.dita

    r99016 r99497  
    2828      iSCSI standard and should work with all standard-conforming iSCSI
    2929      targets. To use an iSCSI target with Oracle VM VirtualBox, you must use
    30       the command line. See <xref href="man_VBoxManage-storageattach.dita#vboxmanage-storageattach"/>.
     30      the command line. See <xref href="vboxmanage-storageattach.dita"/>.
    3131    </p>
    3232            </body>

  • trunk/doc/manual/en_US/dita/topics/teleporting.dita

    r99016 r99497  
    7676          <varname>port</varname> is a TCP/IP port number to be
    7777          used on both the source and the target hosts. For example, use
    78           6000. See <xref href="man_VBoxManage-modifyvm.dita">VBoxManage modifyvm</xref>.
     78          6000. See <xref href="vboxmanage-modifyvm.dita">VBoxManage modifyvm</xref>.
    7979        </p>
    8080      </li>
    … …  
    102102          teleport request, and <varname>port</varname> must be
    103103          the same number as specified in the command on the target
    104           host. See <xref href="man_VBoxManage-controlvm.dita">VBoxManage controlvm</xref>.
     104          host. See <xref href="vboxmanage-controlvm.dita">VBoxManage controlvm</xref>.
    105105        </p>
    106106      </li>
    … …  
    123123        capabilities with the <userinput>VBoxManage modifyvm
    124124        --cpuid-portability-level</userinput> command. See
    125         <xref href="man_VBoxManage-modifyvm.dita">VBoxManage modifyvm</xref>.
     125        <xref href="vboxmanage-modifyvm.dita">VBoxManage modifyvm</xref>.
    126126      </p>
    127127    </note>

  • trunk/doc/manual/en_US/dita/topics/ts_guest-core-format.dita

    r99016 r99497  
    88        Oracle VM VirtualBox uses the 64-bit ELF format for its VM core files
    99        created by <userinput>VBoxManage debugvm</userinput>, see
    10         <xref href="man_VBoxManage-debugvm.dita">VBoxManage debugvm</xref>. The VM core file contain
     10        <xref href="vboxmanage-debugvm.dita">VBoxManage debugvm</xref>. The VM core file contain
    1111        the memory and CPU dumps of the VM and can be useful for
    1212        debugging your guest OS. The 64-bit ELF object format

  • trunk/doc/manual/en_US/dita/topics/vbox-auth.dita

    r99016 r99497  
    1111        modifyvm</userinput> command with the
    1212        <codeph>--vrde-auth-type</codeph> option. See
    13         <xref href="man_VBoxManage-modifyvm.dita">VBoxManage modifyvm</xref>. The following methods of
     13        <xref href="vboxmanage-modifyvm.dita">VBoxManage modifyvm</xref>. The following methods of
    1414        authentication are available:
    1515      </p>

  • trunk/doc/manual/en_US/dita/topics/vboxconfigdata-machine-folder.dita

    r99016 r99497  
    9898        <b outputclass="bold">General</b> tab. Alternatively, use
    9999        the <userinput>VBoxManage setproperty machinefolder</userinput>
    100         command. See <xref href="man_VBoxManage-setproperty.dita">VBoxManage setproperty</xref>.
     100        command. See <xref href="vboxmanage-setproperty.dita">VBoxManage setproperty</xref>.
    101101      </p>
    102102  </body>

  • trunk/doc/manual/en_US/dita/topics/vboxmanage-general.dita

    r99016 r99497  
    3535      be stored in encrypted form for security reasons. At the moment,
    3636      the only encrypted setting is the iSCSI initiator secret, see
    37       <xref href="man_VBoxManage-storageattach.dita"/>. As long as no
     37      <xref href="vboxmanage-storageattach.dita"/>. As long as no
    3838      settings password is specified, this information is stored in
    3939      <i>plain text</i>. After using the

  • trunk/doc/manual/en_US/dita/topics/vboxmanage-intro.dita

    r99016 r99497  
    102102                     <p>
    103103          For more details, see
    104           <xref href="man_VBoxManage-createvm.dita#vboxmanage-createvm"/>.
     104          <xref href="vboxmanage-createvm.dita"/>.
    105105        </p>
    106106                  </li>
    … …  
    109109          To show the configuration of a particular VM, use
    110110          <userinput>VBoxManage showvminfo</userinput>. See
    111           <xref href="man_VBoxManage-showvminfo.dita#vboxmanage-showvminfo"/> for details
     111          <xref href="vboxmanage-showvminfo.dita"/> for details
    112112          and an example.
    113113        </p>
    … …  
    120120                     <pre xml:space="preserve">VBoxManage modifyvm "Windows XP" --memory 512</pre>
    121121                     <p>
    122           See also <xref href="man_VBoxManage-modifyvm.dita#vboxmanage-modifyvm"/>.
     122          See also <xref href="vboxmanage-modifyvm.dita"/>.
    123123        </p>
    124124                  </li>
    … …  
    129129          storagectl</userinput> and <userinput>VBoxManage
    130130          storageattach</userinput>. See
    131           <xref href="man_VBoxManage-storagectl.dita#vboxmanage-storagectl"/> and
    132           <xref href="man_VBoxManage-storageattach.dita#vboxmanage-storageattach"/>.
     131          <xref href="vboxmanage-storagectl.dita"/> and
     132          <xref href="vboxmanage-storageattach.dita"/>.
    133133        </p>
    134134                  </li>
    … …  
    142142              To start a VM that is currently powered off, use
    143143              <userinput>VBoxManage startvm</userinput>. See
    144               <xref href="man_VBoxManage-startvm.dita#vboxmanage-startvm"/>.
     144              <xref href="vboxmanage-startvm.dita"/>.
    145145            </p>
    146146                        </li>
    … …  
    150150              some of its settings, use <userinput>VBoxManage
    151151              controlvm</userinput>. See
    152               <xref href="man_VBoxManage-controlvm.dita#vboxmanage-controlvm"/>.
     152              <xref href="vboxmanage-controlvm.dita"/>.
    153153            </p>
    154154                        </li>

  • trunk/doc/manual/en_US/dita/topics/vdidetails.dita

    r99016 r99497  
    1717      to a physical disk however, Oracle VM VirtualBox enables you to expand
    1818      an image file after creation, even if it has data already. See
    19       <xref href="man_VBoxManage-modifymedium.dita#vboxmanage-modifymedium"/>.
     19      <xref href="vboxmanage-modifymedium.dita"/>.
    2020    </p>
    2121               <p>

  • trunk/doc/manual/en_US/dita/topics/vrde.dita

    r99016 r99497  
    6060      5000,5010-5012</userinput> configures the server to bind to one of
    6161      the ports 5000, 5010, 5011, or 5012. See
    62       <xref href="man_VBoxManage-modifyvm.dita">VBoxManage modifyvm</xref>.
     62      <xref href="vboxmanage-modifyvm.dita">VBoxManage modifyvm</xref>.
    6363    </p>
    6464    <p>

  • trunk/doc/manual/en_US/man_VBoxManage-guestcontrol.xml

    r99266 r99497  
    369369  </refsynopsisdiv>
    370370
    371   <refsect1>
     371  <refsect1 id="vboxmange-guestcontrol-description">
    372372    <title>Description</title>
    373373    <para>
    … …  
    376376      <xref linkend="guestadd-guestcontrol" />.
    377377    </para>
    378     <refsect2>
     378    <refsect2 id="vboxmanage-guestcontrol-common">
    379379      <title>Common Options and Operands</title>
    380380      <para>
    … …  
    466466      </variablelist>
    467467    </refsect2>
    468     <refsect2>
     468    <refsect2 id="vboxmanage-guestcontrol-process-restrictions">
    469469      <title>Guest Process Restrictions</title>
    470470      <para>
    … …  
    12891289  </refsect1>
    12901290
    1291   <refsect1>
     1291  <refsect1 id="vboxmanage-guestcontrol-examples">
    12921292    <title>Examples</title>
    12931293    <remark role="help-scope" condition="GLOBAL"/>

  • trunk/doc/manual/en_US/man_VBoxManage-guestproperty.xml

    r99154 r99497  
    102102  </refsynopsisdiv>
    103103
    104   <refsect1>
     104  <refsect1 id="vboxmanage-guestproperty-description">
    105105    <title>Description</title>
    106106    <para>
    … …  
    116116      <literal>/VirtualBox/</literal>.
    117117    </para>
    118     <refsect2>
     118    <refsect2 id="vboxmanage-guestproperty-common">
    119119      <title>General Command Operand</title>
    120120      <variablelist>
    … …  
    342342  </refsect1>
    343343
    344   <refsect1>
     344  <refsect1 id="vboxmanage-guestproperty-examples">
    345345    <title>Examples</title>
    346346    <remark role="help-scope" condition="GLOBAL" />

  • trunk/doc/manual/en_US/man_VBoxManage-import.xml

    r98103 r99497  
    102102  </refsynopsisdiv>
    103103
    104   <refsect1>
     104  <refsect1 id="vboxmanage-import-description">
    105105    <title>Description</title>
    106106    <para>
    … …  
    132132      VM instance. The temporary file is deleted after successful import.
    133133    </para>
    134     <refsect2>
     134    <refsect2 id="vboxmanage-import-common-options">
    135135      <title>Common Options</title>
    136136      <variablelist>
    … …  
    364364  </refsect1>
    365365
    366   <refsect1>
     366  <refsect1  id="vboxmanage-import-examples">
    367367    <title>Examples</title>
    368368    <remark role="help-scope" condition="GLOBAL"/>

  • trunk/doc/manual/en_US/man_VBoxManage-metrics.xml

    r98103 r99497  
    111111  </refsynopsisdiv>
    112112
    113   <refsect1>
     113  <refsect1 id="vboxmanage-metrics-description">
    114114    <title>Description</title>
    115115    <para>
    … …  
    138138      the VM shuts down.
    139139    </para>
    140     <refsect2>
     140    <refsect2 id="vboxmange-metrics-description-metrics">
    141141      <title>Metrics</title>
    142142      <para>
    … …  
    399399  </refsect1>
    400400
    401   <refsect1>
     401  <refsect1 id="vboxmange-metrics-examples">
    402402    <title>Examples</title>
    403403    <remark role="help-scope" condition="GLOBAL"/>

  • trunk/doc/manual/en_US/man_VBoxManage-modifyvm.xml

    r99192 r99497  
    674674  </refsynopsisdiv>
    675675
    676   <refsect1>
     676  <refsect1 id="vboxmanage-modifyvm-description">
    677677    <title>Description</title>
    678678    <para>
    … …  
    27892789  </refsect1>
    27902790
    2791   <refsect1>
     2791  <refsect1 id="vboxmanage-modifyvm-examples">
    27922792    <title>Examples</title>
    27932793    <remark role="help-scope" condition="GLOBAL" />
    … …  
    28042804  </refsect1>
    28052805
    2806   <refsect1>
     2806  <refsect1 id="vboxmanage-modifyvm-see-also">
    28072807    <title>See Also</title>
    28082808    <para>

  • trunk/doc/manual/en_US/man_VBoxManage-snapshot.xml

    r99154 r99497  
    155155  </refsynopsisdiv>
    156156
    157   <refsect1>
     157  <refsect1 id="vboxmanage-snapshot-description">
    158158    <title>Description</title>
    159159    <para>
    … …  
    183183      VM for which you want to take a snapshot.
    184184    </para>
    185     <refsect2>
     185    <refsect2 id="vboxmanage-snapshot-common-args">
    186186      <title>General Command Operand</title>
    187187      <variablelist>
    … …  
    379379  </refsect1>
    380380
    381   <refsect1>
     381  <refsect1 id="vboxmanage-snapshot-examples">
    382382    <title>Examples</title>
    383383    <remark role="help-scope" condition="GLOBAL"/>

  • trunk/doc/manual/en_US/man_VBoxManage-usbfilter.xml

    r98103 r99497  
    103103  </refsynopsisdiv>
    104104
    105   <refsect1>
     105  <refsect1 id="vboxmanage-usbfilter-description">
    106106    <title>Description</title>
    107107    <para>
    … …  
    125125      available.
    126126    </para>
    127     <refsect2>
     127    <refsect2 id="vboxmanage-usbfilter-common">
    128128      <title>Common Operand and Options</title>
    129129      <variablelist>
    … …  
    301301  </refsect1>
    302302
    303   <refsect1>
     303  <refsect1 id="vboxmanage-usbfilter-examples">
    304304    <title>Examples</title>
    305305    <remark role="help-scope" condition="GLOBAL" />

  • trunk/doc/manual/pdf-theme-UserManual.yaml

    r99271 r99497  
    135135    h4:
    136136        font-size:          12pt
     137        font-weight:        bold
    137138        font-style:         italic
    138         space-before:       12pt
    139         title-numbering:    false
     139        space-before:       15pt
     140        start-indent:       'from-parent(start-indent)'
     141        title-numbering:    true
    140142
    141143    link:
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