VirtualBox

Changeset 99513 in vbox


Ignore:
Timestamp:
Apr 21, 2023 9:59:02 PM (22 months ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
157010
Message:

manual,VBoxManage,isomaker/viso: Require all refsect1 and refsect2 elements to have @id attributes in manpages (refentry) to make these predictable and the split up topic files easier to handle for the docs team. Also requires these @id values to start with the refentry @id + '-'. Corrected a few bogus ones. Because 'controlvm' has too many sub-commands, HELP_SCOPE_ IDs will not be generated for 'See Also' and 'Examples' sections. bugref:10302

Location:
trunk
Files:
50 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/manual/docbook-refentry-to-C-help.xsl

    r99118 r99513  
    149149    <!-- Then comes the description and other refsect1 -->
    150150    <xsl:for-each select="./refsect1">
     151      <!-- assertions -->
    151152      <xsl:if test="name(*[1]) != 'title'"><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>Expected title as the first element in refsect1.</xsl:message></xsl:if>
    152153      <xsl:if test="text()"><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>No text supported in refsect1.</xsl:message></xsl:if>
     154      <xsl:if test="not(@id)"><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>refsect1 must have an @id attribute.</xsl:message></xsl:if>
     155      <xsl:if test="not(starts-with(@id, concat(../@id, '-')))"><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>Wrong @id refsect1 prefix: '<xsl:value-of select="@id"/>', expected it to start with '<xsl:value-of select="../@id"/>-'</xsl:message></xsl:if>
     156
     157      <!-- .... -->
    153158      <xsl:if test="not(./remark[@role='help-skip'])">
    154159        <xsl:variable name="sTitle">
     
    321326    <xsl:if test="text()"><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>refsect2 shouldn't contain text</xsl:message></xsl:if>
    322327    <xsl:if test="count(./title) != 1"><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>refsect2 requires a title (<xsl:value-of select="ancestor-or-self::*[@id][1]/@id"/>)</xsl:message></xsl:if>
     328    <xsl:if test="not(@id)"><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>refsect2 must have an @id attribute.</xsl:message></xsl:if>
     329    <xsl:if test="not(starts-with(@id, concat(../../@id, '-')))"><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>Wrong @id refsect2 prefix: '<xsl:value-of select="@id"/>', expected it to start with '<xsl:value-of select="../../@id"/>-'</xsl:message></xsl:if>
    323330
    324331    <!-- title / command synopsis - sets the scope. -->
     
    731738  <xsl:template name="calc-scope-refsect1">
    732739    <xsl:choose>
    733       <xsl:when test="title[text() = 'Description']">
     740      <xsl:when test="contains(@id, '-description') or title[text() = 'Description']">
    734741        <xsl:text>RTMSGREFENTRYSTR_SCOPE_GLOBAL</xsl:text>
    735742      </xsl:when>
    736       <xsl:when test="@id or remark[@role='help-scope']">
     743      <xsl:when test="(@id and not(contains(@id, '-see-also')) and not(contains(@id, '-examples'))) or remark[@role='help-scope']">
    737744        <xsl:call-template name="calc-scope-from-remark-or-id"/>
    738745      </xsl:when>
     
    746753  <xsl:template name="calc-scope-refsect2">
    747754    <xsl:choose>
    748       <xsl:when test="@id or remark[@role='help-scope']">
     755      <xsl:when test="(@id and not(contains(@id, '-see-also')) and not(contains(@id, '-examples'))) or remark[@role='help-scope']">
    749756        <xsl:call-template name="calc-scope-from-remark-or-id"/>
    750757      </xsl:when>
  • trunk/doc/manual/docbook-refentry-to-H-help.xsl

    r98103 r99513  
    9999        <xsl:for-each select=".//refsect1[@id] | .//refsect2[@id]">
    100100          <xsl:variable name="sThisId" select="@id"/>
    101           <xsl:if test="not($RefEntry[@id = $sThisId]) and not($RefEntry/refsynopsisdiv/cmdsynopsis[@id = concat('synopsis-', $sThisId)])">
     101          <xsl:if test="    not($RefEntry[@id = $sThisId])
     102                        and not($RefEntry/refsynopsisdiv/cmdsynopsis[@id = concat('synopsis-', $sThisId)])
     103                        and not(contains($sThisId, '-see-also'))
     104                        and not(contains($sThisId, '-examples')) "> <!-- controlvm is too big, so skip these two -->
    102105            <xsl:variable name="sSubNm">
    103106              <xsl:text>HELP_SCOPE_</xsl:text>
  • trunk/doc/manual/en_US/man_VBoxHeadless.xml

    r99155 r99513  
    7070  </refsynopsisdiv>
    7171
    72   <refsect1>
     72  <refsect1 id="vboxheadless-description">
    7373    <title>Description</title>
    7474    <para>
     
    209209  </refsect1>
    210210
    211   <refsect1>
     211  <refsect1 id="vboxheadless-examples">
    212212    <title>Examples</title>
    213213    <remark role="help-scope" condition="GLOBAL"/>
     
    229229  </refsect1>
    230230
    231   <refsect1>
     231  <refsect1 id="vboxheadless-see-also">
    232232    <title>See Also</title>
    233233    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-adoptstate.xml

    r99154 r99513  
    5858  </refsynopsisdiv>
    5959
    60   <refsect1>
     60  <refsect1 id="vboxmanage-adoptstate-description">
    6161    <title>Description</title>
    6262    <para>
     
    9292  </refsect1>
    9393
    94   <refsect1>
     94  <refsect1 id="vboxmanage-adoptstate-examples">
    9595    <title>Examples</title>
    9696    <remark role="help-scope" condition="GLOBAL" />
     
    104104  </refsect1>
    105105
    106   <refsect1>
     106  <refsect1 id="vboxmanage-adoptstate-see-also">
    107107    <title>See Also</title>
    108108    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-bandwidthctl.xml

    r99155 r99513  
    9595  </refsynopsisdiv>
    9696
    97   <refsect1>
     97  <refsect1 id="vboxmanage-bandwidthctl-description">
    9898    <title>Description</title>
    9999    <para>
     
    280280  </refsect1>
    281281
    282   <refsect1>
     282  <refsect1 id="vboxmanage-bandwidthctl-examples">
    283283    <title>Examples</title>
    284284    <remark role="help-scope" condition="GLOBAL"/>
  • trunk/doc/manual/en_US/man_VBoxManage-checkmediumpwd.xml

    r99155 r99513  
    5858  </refsynopsisdiv>
    5959
    60   <refsect1>
     60  <refsect1 id="vboxmanage-checkmediumpwd-description">
    6161    <title>Description</title>
    6262    <para>
     
    8989  </refsect1>
    9090
    91   <refsect1>
     91  <refsect1 id="vboxmanage-checkmediumpwd-examples">
    9292    <title>Examples</title>
    9393    <remark role="help-scope" condition="GLOBAL" />
     
    105105  </refsect1>
    106106
    107   <refsect1>
     107  <refsect1 id="vboxmanage-checkmediumpwd-see-also">
    108108    <title>See Also</title>
    109109    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-clonemedium.xml

    r99155 r99513  
    8181  </refsynopsisdiv>
    8282
    83   <refsect1>
     83  <refsect1 id="vboxmanage-clonemedium-description">
    8484    <title>Description</title>
    8585    <para>
     
    195195  </refsect1>
    196196
    197   <refsect1>
     197  <refsect1 id="vboxmanage-clonemedium-examples">
    198198    <title>Examples</title>
    199199    <remark role="help-scope" condition="GLOBAL" />
     
    212212  </refsect1>
    213213
    214   <refsect1>
     214  <refsect1 id="vboxmanage-clonemedium-see-also">
    215215    <title>See Also</title>
    216216    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-clonevm.xml

    r98103 r99513  
    7474  </refsynopsisdiv>
    7575
    76   <refsect1>
     76  <refsect1 id="vboxmanage-clonevm-description">
    7777    <title>Description</title>
    7878    <para>
     
    8787  </refsect1>
    8888
    89   <refsect1>
     89  <refsect1 id="vboxmanage-clonevm-common-args">
    9090    <title>Command Operand and Options</title>
    9191    <para>
     
    239239  </refsect1>
    240240
    241   <refsect1>
     241  <refsect1 id="vboxmanage-clonevm-examples">
    242242    <title>Examples</title>
    243243    <para>
     
    266266  </refsect1>
    267267
    268   <refsect1>
     268  <refsect1 id="vboxmanage-clonevm-see-also">
    269269    <title>See Also</title>
    270270    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-closemedium.xml

    r98103 r99513  
    6363  </refsynopsisdiv>
    6464
    65   <refsect1>
     65  <refsect1 id="vboxmanage-closemedium-description">
    6666    <title>Description</title>
    6767    <para>
     
    102102  </refsect1>
    103103
    104   <refsect1>
     104  <refsect1 id="vboxmanage-closemedium-examples">
    105105    <title>Examples</title>
    106106    <remark role="help-scope" condition="GLOBAL" />
  • trunk/doc/manual/en_US/man_VBoxManage-cloud.xml

    r99161 r99513  
    5050    <!-- Cloud list -->
    5151    <!-- The 'id' is mandatory and must start with 'synopsis-'. -->
    52     <cmdsynopsis id="synopsis-vboxmanage-cloudlist-instances">
     52    <cmdsynopsis id="synopsis-vboxmanage-cloud-list-instances">
    5353      <command>VBoxManage cloud</command>
    5454        <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    5959        <arg>--compartment-id=<replaceable>string</replaceable></arg>
    6060    </cmdsynopsis>
    61     <cmdsynopsis id="synopsis-vboxmanage-cloudlist-images">
     61    <cmdsynopsis id="synopsis-vboxmanage-cloud-list-images">
    6262      <command>VBoxManage cloud</command>
    6363      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    6868      <arg>--state=<replaceable>string</replaceable></arg>
    6969    </cmdsynopsis>
    70     <cmdsynopsis id="synopsis-vboxmanage-cloudlist-vnicattachments">
     70    <cmdsynopsis id="synopsis-vboxmanage-cloud-list-vnicattachments">
    7171      <command>VBoxManage cloud</command>
    7272      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    8383
    8484    <!-- Cloud instance commands -->
    85       <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-create" sepchar=" ">
     85      <cmdsynopsis id="synopsis-vboxmanage-cloud-instance-create" sepchar=" ">
    8686       <command moreinfo="none">VBoxManage cloud</command>
    8787       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    108108       <arg>--cloud-init-script-path=<replaceable>path to a script</replaceable></arg>
    109109     </cmdsynopsis>
    110      <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-info" sepchar=" ">
     110     <cmdsynopsis id="synopsis-vboxmanage-cloud-instance-info" sepchar=" ">
    111111       <command moreinfo="none">VBoxManage cloud</command>
    112112       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    116116       <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    117117     </cmdsynopsis>
    118      <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-terminate" sepchar=" ">
     118     <cmdsynopsis id="synopsis-vboxmanage-cloud-instance-terminate" sepchar=" ">
    119119       <command moreinfo="none">VBoxManage cloud</command>
    120120       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    124124       <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    125125     </cmdsynopsis>
    126      <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-start" sepchar=" ">
     126     <cmdsynopsis id="synopsis-vboxmanage-cloud-instance-start" sepchar=" ">
    127127       <command moreinfo="none">VBoxManage cloud</command>
    128128       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    132132       <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    133133     </cmdsynopsis>
    134      <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-pause" sepchar=" ">
     134     <cmdsynopsis id="synopsis-vboxmanage-cloud-instance-pause" sepchar=" ">
    135135       <command moreinfo="none">VBoxManage cloud</command>
    136136       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    140140       <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    141141     </cmdsynopsis>
    142      <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-reset" sepchar=" ">
     142     <cmdsynopsis id="synopsis-vboxmanage-cloud-instance-reset" sepchar=" ">
    143143       <command moreinfo="none">VBoxManage cloud</command>
    144144       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    150150
    151151     <!-- Cloud image commands -->
    152       <cmdsynopsis id="synopsis-vboxmanage-cloudimage-create" sepchar=" "> <!-- The 'id' is mandatory and must start with 'synopsis-'. -->
     152      <cmdsynopsis id="synopsis-vboxmanage-cloud-image-create" sepchar=" "> <!-- The 'id' is mandatory and must start with 'synopsis-'. -->
    153153        <command>VBoxManage cloud</command>
    154154          <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    161161          <arg>--instance-id=<replaceable>unique id</replaceable></arg>
    162162      </cmdsynopsis>
    163       <cmdsynopsis id="synopsis-vboxmanage-cloudimage-info" sepchar=" ">
     163      <cmdsynopsis id="synopsis-vboxmanage-cloud-image-info" sepchar=" ">
    164164        <command>VBoxManage cloud</command>
    165165        <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    169169        <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    170170      </cmdsynopsis>
    171       <cmdsynopsis id="synopsis-vboxmanage-cloudimage-delete" sepchar=" ">
     171      <cmdsynopsis id="synopsis-vboxmanage-cloud-image-delete" sepchar=" ">
    172172        <command>VBoxManage cloud</command>
    173173        <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    177177        <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    178178      </cmdsynopsis>
    179       <cmdsynopsis id="synopsis-vboxmanage-cloudimage-import" sepchar=" ">
     179      <cmdsynopsis id="synopsis-vboxmanage-cloud-image-import" sepchar=" ">
    180180        <command>VBoxManage cloud</command>
    181181        <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    187187        <arg>--object-name=<replaceable>name</replaceable></arg>
    188188      </cmdsynopsis>
    189       <cmdsynopsis id="synopsis-vboxmanage-cloudimage-export" sepchar=" ">
     189      <cmdsynopsis id="synopsis-vboxmanage-cloud-image-export" sepchar=" ">
    190190        <command>VBoxManage cloud</command>
    191191        <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     
    246246  </refsynopsisdiv>
    247247
    248   <refsect1>
     248  <refsect1 id="vboxmanage-cloud-image-description">
    249249    <title>Description</title>
    250250
     
    268268
    269269    <!-- Cloud list commands -->
    270     <refsect2 id="vboxmanage-cloudlist-instances">
     270    <refsect2 id="vboxmanage-cloud-list-instances">
    271271      <title>cloud list instances</title>
    272272      <remark role="help-copy-synopsis"/>
     
    294294    </refsect2>
    295295
    296     <refsect2 id="vboxmanage-cloudlist-images">
     296    <refsect2 id="vboxmanage-cloud-list-images">
    297297      <title>cloud list images</title>
    298298      <remark role="help-copy-synopsis"/>
     
    321321    </refsect2>
    322322
    323     <refsect2 id="vboxmanage-cloudlist-vnicattachments">
     323    <refsect2 id="vboxmanage-cloud-list-vnicattachments">
    324324      <title>cloud list vnic attachments</title>
    325325      <remark role="help-copy-synopsis"/>
     
    356356
    357357    <!-- Cloud instance commands -->
    358     <refsect2 id="vboxmanage-cloudinstance-create">
     358    <refsect2 id="vboxmanage-cloud-instance-create">
    359359      <title>cloud instance create</title>
    360360      <remark role="help-copy-synopsis"/>
     
    417417    </refsect2>
    418418
    419     <refsect2 id="vboxmanage-cloudinstance-info">
     419    <refsect2 id="vboxmanage-cloud-instance-info">
    420420      <title>cloud instance info</title>
    421421      <para>
     
    429429    </refsect2>
    430430
    431     <refsect2 id="vboxmanage-cloudinstance-terminate">
     431    <refsect2 id="vboxmanage-cloud-instance-terminate">
    432432      <title>cloud instance termination</title>
    433433      <para>
     
    441441    </refsect2>
    442442
    443     <refsect2 id="vboxmanage-cloudinstance-start">
     443    <refsect2 id="vboxmanage-cloud-instance-start">
    444444      <title>cloud instance start</title>
    445445      <para>
     
    453453    </refsect2>
    454454
    455     <refsect2 id="vboxmanage-cloudinstance-pause">
     455    <refsect2 id="vboxmanage-cloud-instance-pause">
    456456      <title>cloud instance pause</title>
    457457      <para>
     
    465465    </refsect2>
    466466
    467     <refsect2 id="vboxmanage-cloudinstance-reset">
     467    <refsect2 id="vboxmanage-cloud-instance-reset">
    468468      <title>cloud instance reset</title>
    469469      <para>
     
    478478
    479479    <!-- Cloud image commands -->
    480     <refsect2 id="vboxmanage-cloudimage-create">
     480    <refsect2 id="vboxmanage-cloud-image-create">
    481481      <title>cloud image create</title>
    482482      <remark role="help-copy-synopsis"/>
     
    510510    </refsect2>
    511511
    512     <refsect2 id="vboxmanage-cloudimage-info">
     512    <refsect2 id="vboxmanage-cloud-image-info">
    513513      <title>cloud image info</title>
    514514      <remark role="help-copy-synopsis"/>
     
    523523    </refsect2>
    524524
    525     <refsect2 id="vboxmanage-cloudimage-delete">
     525    <refsect2 id="vboxmanage-cloud-image-delete">
    526526      <title>cloud image delete</title>
    527527      <remark role="help-copy-synopsis"/>
     
    536536    </refsect2>
    537537
    538     <refsect2 id="vboxmanage-cloudimage-import">
     538    <refsect2 id="vboxmanage-cloud-image-import">
    539539      <title>cloud image import</title>
    540540      <remark role="help-copy-synopsis"/>
     
    568568    </refsect2>
    569569
    570     <refsect2 id="vboxmanage-cloudimage-export">
     570    <refsect2 id="vboxmanage-cloud-image-export">
    571571      <title>cloud image export</title>
    572572      <remark role="help-copy-synopsis"/>
  • trunk/doc/manual/en_US/man_VBoxManage-cloudprofile.xml

    r99161 r99513  
    8787  </refsynopsisdiv>
    8888
    89   <refsect1>
     89  <refsect1 id="vboxmanage-cloudprofile-description">
    9090    <title>Description</title>
    9191
  • trunk/doc/manual/en_US/man_VBoxManage-common.xml

    r99176 r99513  
    7878  </refsynopsisdiv>
    7979
    80   <refsect1>
     80  <refsect1 id="vboxmanage-common-description">
    8181    <title>Description</title>
    8282    <para>
     
    226226  </refsect1>
    227227
    228   <refsect1>
     228  <refsect1 id="vboxmanage-common-examples">
    229229    <title>Examples</title>
    230230    <remark role="help-scope" condition="GLOBAL"/>
     
    279279  </refsect1>
    280280
    281   <refsect1>
     281  <refsect1 id="vboxmanage-common-see-also">
    282282    <title>See Also</title>
    283283    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-controlvm.xml

    r99176 r99513  
    757757  </refsynopsisdiv>
    758758
    759   <refsect1>
     759  <refsect1 id="vboxmanage-controlvm-description">
    760760    <title>Description</title>
    761761    <para>
     
    21212121  </refsect1>
    21222122
    2123   <refsect1>
     2123  <refsect1 id="vboxmanage-controlvm-examples">
    21242124    <title>Examples</title>
    21252125    <remark role="help-scope" condition="GLOBAL" />
     
    21372137  </refsect1>
    21382138
    2139   <refsect1>
     2139  <refsect1 id="vboxmanage-controlvm-see-also">
    21402140    <title>See Also</title>
    21412141    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-convertfromraw.xml

    r99153 r99513  
    8686  </refsynopsisdiv>
    8787
    88   <refsect1>
     88  <refsect1 id="vboxmanage-convertfromraw-description">
    8989    <title>Description</title>
    9090    <para>
     
    244244  </refsect1>
    245245
    246   <refsect1>
     246  <refsect1 id="vboxmanage-convertfromraw-examples">
    247247    <title>Examples</title>
    248248    <remark role="help-scope" condition="GLOBAL" />
  • trunk/doc/manual/en_US/man_VBoxManage-createmedium.xml

    r99176 r99513  
    8383  </refsynopsisdiv>
    8484
    85   <refsect1>
     85  <refsect1 id="vboxmanage-createmedium-description">
    8686    <title>Description</title>
    8787    <para>
     
    208208  </refsect1>
    209209
    210   <refsect1>
     210  <refsect1 id="vboxmanage-createmedium-examples">
    211211    <title>Examples</title>
    212212    <remark role="help-scope" condition="GLOBAL" />
  • trunk/doc/manual/en_US/man_VBoxManage-createvm.xml

    r99176 r99513  
    6363  </refsynopsisdiv>
    6464
    65   <refsect1>
     65  <refsect1 id="vboxmanage-createvm-description">
    6666    <title>Description</title>
    6767    <para>
     
    8787  </refsect1>
    8888
    89   <refsect1>
     89  <refsect1 id="vboxmanage-createvm-common-options">
    9090    <title>Command Options</title>
    9191    <para>
     
    186186  </refsect1>
    187187
    188   <refsect1>
     188  <refsect1 id="vboxmanage-createvm-examples">
    189189    <title>Examples</title>
    190190    <remark role="help-scope" condition="GLOBAL" />
     
    201201  </refsect1>
    202202
    203   <refsect1>
     203  <refsect1 id="vboxmanage-createvm-see-also">
    204204    <title>See Also</title>
    205205    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-debugvm.xml

    r99154 r99513  
    191191    </cmdsynopsis>
    192192  </refsynopsisdiv>
    193   <refsect1>
     193  <refsect1 id="vboxmanage-debugvm-description">
    194194    <title>Description</title>
    195195
  • trunk/doc/manual/en_US/man_VBoxManage-dhcpserver.xml

    r99192 r99513  
    255255  </refsynopsisdiv>
    256256
    257   <refsect1>
     257  <refsect1 id="vboxmanage-dhcpserver-description">
    258258    <title>Description</title>
    259259
  • trunk/doc/manual/en_US/man_VBoxManage-discardstate.xml

    r99154 r99513  
    5757  </refsynopsisdiv>
    5858
    59   <refsect1>
     59  <refsect1 id="vboxmanage-discardstate-description">
    6060    <title>Description</title>
    6161    <para>
     
    8383  </refsect1>
    8484
    85   <refsect1>
     85  <refsect1 id="vboxmanage-discardstate-examples">
    8686    <title>Examples</title>
    8787    <remark role="help-scope" condition="GLOBAL" />
     
    9494  </refsect1>
    9595
    96   <refsect1>
     96  <refsect1 id="vboxmanage-discardstate-see-also">
    9797    <title>See Also</title>
    9898    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-encryptmedium.xml

    r98103 r99513  
    6161  </refsynopsisdiv>
    6262
    63   <refsect1>
     63  <refsect1 id="vboxmanage-encryptmedium-description">
    6464    <title>Description</title>
    6565    <para>
     
    142142  </refsect1>
    143143
    144   <refsect1>
     144  <refsect1 id="vboxmanage-encryptmedium-examples">
    145145    <title>Examples</title>
    146146    <remark role="help-scope" condition="GLOBAL"/>
  • trunk/doc/manual/en_US/man_VBoxManage-encryptvm.xml

    r98103 r99513  
    9494  </refsynopsisdiv>
    9595
    96   <refsect1>
     96  <refsect1 id="vboxmanage-encryptvm-description">
    9797    <title>Description</title>
    9898    <para>
     
    186186  </refsect1>
    187187
    188   <refsect1>
     188  <refsect1 id="vboxmanage-encryptvm-examples">
    189189    <title>Examples</title>
    190190    <remark role="help-scope" condition="GLOBAL" />
     
    196196  </refsect1>
    197197
    198   <refsect1>
     198  <refsect1 id="vboxmanage-encryptvm-see-also">
    199199    <title>See Also</title>
    200200    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-export.xml

    r99153 r99513  
    110110  </refsynopsisdiv>
    111111
    112   <refsect1>
     112  <refsect1 id="vboxmanage-export-description">
    113113    <title>Description</title>
    114114    <para>
     
    424424  </refsect1>
    425425
    426   <refsect1>
     426  <refsect1 id="vboxmanage-export-examples">
    427427    <title>Example</title>
    428428    <remark role="help-scope" condition="GLOBAL"/>
  • trunk/doc/manual/en_US/man_VBoxManage-extpack.xml

    r98103 r99513  
    6363  </refsynopsisdiv>
    6464
    65   <refsect1>
     65  <refsect1 id="vboxmanage-extpack-description">
    6666    <title>Description</title>
    6767
     
    133133  </refsect1>
    134134
    135   <refsect1>
     135  <refsect1 id="vboxmanage-extpack-examples">
    136136    <title>Examples</title>
    137137    <remark role="help-scope" condition="EXTPACK_UNINSTALL,EXTPACK"/>
  • trunk/doc/manual/en_US/man_VBoxManage-getextradata.xml

    r99154 r99513  
    6363  </refsynopsisdiv>
    6464
    65   <refsect1>
     65  <refsect1 id="vboxmanage-getextradata-description">
    6666    <title>Description</title>
    6767    <para>
     
    101101  </refsect1>
    102102
    103   <refsect1>
     103  <refsect1 id="vboxmanage-getextradata-examples">
    104104    <title>Examples</title>
    105105    <remark role="help-scope" condition="GLOBAL"/>
     
    143143  </refsect1>
    144144
    145   <refsect1>
     145  <refsect1 id="vboxmanage-getextradata-see-also">
    146146    <title>See Also</title>
    147147    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-hostonlyif.xml

    r99153 r99513  
    7474  </refsynopsisdiv>
    7575
    76   <refsect1>
     76  <refsect1 id="vboxmanage-hostonlyif-description">
    7777    <title>Description</title>
    7878    <para>
     
    190190  </refsect1>
    191191
    192   <refsect1>
     192  <refsect1 id="vboxmanage-hostonlyif-examples">
    193193    <title>Examples</title>
    194194    <remark role="help-scope" condition="GLOBAL" />
  • trunk/doc/manual/en_US/man_VBoxManage-hostonlynet.xml

    r98103 r99513  
    8282  </refsynopsisdiv>
    8383
    84   <refsect1>
     84  <refsect1 id="vboxmanage-hostonlynet-description">
    8585    <title>Description</title>
    8686
  • trunk/doc/manual/en_US/man_VBoxManage-list.xml

    r98103 r99513  
    8686  </refsynopsisdiv>
    8787
    88   <refsect1>
     88  <refsect1 id="vboxmanage-list-description">
    8989    <title>Description</title>
    9090    <para>
     
    507507  </refsect1>
    508508
    509   <refsect1>
     509  <refsect1 id="vboxmanage-list-examples">
    510510    <title>Examples</title>
    511511    <remark role="help-scope" condition="GLOBAL" />
  • trunk/doc/manual/en_US/man_VBoxManage-mediumio.xml

    r98103 r99513  
    8787  </refsynopsisdiv>
    8888
    89   <refsect1>
     89  <refsect1 id="vboxmanage-mediumio-description">
    9090    <title>Description</title>
    9191
  • trunk/doc/manual/en_US/man_VBoxManage-mediumproperty.xml

    r98103 r99513  
    9595  </refsynopsisdiv>
    9696
    97   <refsect1>
     97  <refsect1 id="vboxmanage-mediumproperty-description">
    9898    <title>Description</title>
    9999    <para>
     
    202202  </refsect1>
    203203
    204   <refsect1>
     204  <refsect1 id="vboxmanage-mediumproperty-examples">
    205205    <title>Examples</title>
    206206    <remark role="help-scope" condition="GLOBAL" />
  • trunk/doc/manual/en_US/man_VBoxManage-modifymedium.xml

    r98103 r99513  
    7070  </refsynopsisdiv>
    7171
    72   <refsect1>
     72  <refsect1 id="vboxmanage-modifymedium-description">
    7373    <title>Description</title>
    7474    <para>
     
    233233  </refsect1>
    234234
    235   <refsect1>
     235  <refsect1 id="vboxmanage-modifymedium-examples">
    236236    <title>Examples</title>
    237237    <remark role="help-scope" condition="GLOBAL" />
     
    248248  </refsect1>
    249249
    250   <refsect1>
     250  <refsect1 id="vboxmanage-modifymedium-see-also">
    251251    <title>See Also</title>
    252252    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-modifynvram.xml

    r99154 r99513  
    131131  </refsynopsisdiv>
    132132
    133   <refsect1>
     133  <refsect1 id="vboxmanage-modifynvram-description">
    134134    <title>Description</title>
    135135
  • trunk/doc/manual/en_US/man_VBoxManage-movevm.xml

    r99154 r99513  
    5959  </refsynopsisdiv>
    6060
    61   <refsect1>
     61  <refsect1 id="vboxmanage-movevm-description">
    6262    <title>Description</title>
    6363    <para>
     
    100100  </refsect1>
    101101
    102   <refsect1>
     102  <refsect1 id="vboxmanage-movevm-examples">
    103103    <title>Examples</title>
    104104    <remark role="help-scope" condition="GLOBAL" />
  • trunk/doc/manual/en_US/man_VBoxManage-natnetwork.xml

    r98103 r99513  
    101101  </refsynopsisdiv>
    102102
    103   <refsect1>
     103  <refsect1 id="vboxmanage-natnetwork-description">
    104104    <title>Description</title>
    105105    <para>
     
    349349  </refsect1>
    350350
    351   <refsect1>
     351  <refsect1 id="vboxmanage-natnetwork-examples">
    352352    <title>Examples</title>
    353353    <remark role="help-scope" condition="GLOBAL"/>
  • trunk/doc/manual/en_US/man_VBoxManage-registervm.xml

    r98103 r99513  
    5555  </refsynopsisdiv>
    5656
    57   <refsect1>
     57  <refsect1 id="vboxmanage-registervm-description">
    5858    <title>Description</title>
    5959    <para>
     
    9494  </refsect1>
    9595
    96   <refsect1>
     96  <refsect1 id="vboxmanage-registervm-examples">
    9797    <title>Examples</title>
    9898    <remark role="help-scope" condition="GLOBAL" />
     
    105105  </refsect1>
    106106
    107   <refsect1>
     107  <refsect1 id="vboxmanage-registervm-see-also">
    108108    <title>See Also</title>
    109109    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-setextradata.xml

    r99154 r99513  
    6161  </refsynopsisdiv>
    6262
    63   <refsect1>
     63  <refsect1 id="vboxmanage-setextradata-description">
    6464    <title>Description</title>
    6565    <para>
     
    9898  </refsect1>
    9999
    100   <refsect1>
     100  <refsect1 id="vboxmanage-setextradata-examples">
    101101    <title>Examples</title>
    102102    <remark role="help-scope" condition="GLOBAL"/>
     
    115115  </refsect1>
    116116
    117   <refsect1>
     117  <refsect1 id="vboxmanage-setextradata-see-also">
    118118    <title>See Also</title>
    119119    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-setproperty.xml

    r98103 r99513  
    5555  </refsynopsisdiv>
    5656
    57   <refsect1>
     57  <refsect1 id="vboxmanage-setproperty-description">
    5858    <title>Description</title>
    5959    <para>
     
    211211  </refsect1>
    212212
    213   <refsect1>
     213  <refsect1 id="vboxmanage-setproperty-examples">
    214214    <title>Examples</title>
    215215    <remark role="help-scope" condition="GLOBAL" />
     
    222222  </refsect1>
    223223
    224   <refsect1>
     224  <refsect1 id="vboxmanage-setproperty-see-also">
    225225    <title>See Also</title>
    226226    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-sharedfolder.xml

    r99154 r99513  
    7373  </refsynopsisdiv>
    7474
    75   <refsect1>
     75  <refsect1 id="vboxmanage-sharedfolder-description">
    7676    <title>Description</title>
    7777    <para>
     
    195195  </refsect1>
    196196
    197   <refsect1>
     197  <refsect1 id="vboxmanage-sharedfolder-examples">
    198198    <title>Examples</title>
    199199    <remark role="help-scope" condition="GLOBAL" />
  • trunk/doc/manual/en_US/man_VBoxManage-showmediuminfo.xml

    r98103 r99513  
    6262  </refsynopsisdiv>
    6363
    64   <refsect1>
     64  <refsect1 id="vboxmanage-showmediuminfo-description">
    6565    <title>Description</title>
    6666    <para>
     
    119119  </refsect1>
    120120
    121   <refsect1>
     121  <refsect1 id="vboxmanage-showmediuminfo-examples">
    122122    <title>Examples</title>
    123123    <remark role="help-scope" condition="GLOBAL" />
     
    134134  </refsect1>
    135135
    136   <refsect1>
     136  <refsect1 id="vboxmanage-showmediuminfo-see-also">
    137137    <title>See Also</title>
    138138    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-showvminfo.xml

    r98108 r99513  
    7373  </refsynopsisdiv>
    7474
    75   <refsect1>
     75  <refsect1 id="vboxmanage-showvminfo-description">
    7676    <title>Description</title>
    7777    <para>
     
    164164  </refsect1>
    165165
    166   <refsect1>
     166  <refsect1 id="vboxmanage-showvminfo-examples">
    167167    <title>Examples</title>
    168168    <remark role="help-scope" condition="GLOBAL"/>
     
    213213  </refsect1>
    214214
    215   <refsect1>
     215  <refsect1 id="vboxmanage-showvminfo-see-also">
    216216    <title>See Also</title>
    217217    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-signova.xml

    r98103 r99513  
    7070  </refsynopsisdiv>
    7171
    72   <refsect1>
     72  <refsect1 id="vboxmanage-signova-description">
    7373    <title>Description</title>
    7474    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-startvm.xml

    r99154 r99513  
    6666  </refsynopsisdiv>
    6767
    68   <refsect1>
     68  <refsect1 id="vboxmanage-startvm-description">
    6969    <title>Description</title>
    7070    <para>
     
    170170  </refsect1>
    171171
    172   <refsect1>
     172  <refsect1 id="vboxmanage-startvm-examples">
    173173    <title>Examples</title>
    174174    <remark role="help-scope" condition="GLOBAL" />
     
    184184  </refsect1>
    185185
    186   <refsect1>
     186  <refsect1 id="vboxmanage-startvm-see-also">
    187187    <title>See Also</title>
    188188    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-storageattach.xml

    r99154 r99513  
    123123  </refsynopsisdiv>
    124124
    125   <refsect1>
     125  <refsect1 id="vboxmanage-storageattach-description">
    126126    <title>Description</title>
    127127    <para>
     
    520520  </refsect1>
    521521
    522   <refsect1>
     522  <refsect1 id="vboxmanage-storageattach-examples">
    523523    <title>Examples</title>
    524524    <remark role="help-scope" condition="GLOBAL" />
     
    539539  </refsect1>
    540540
    541   <refsect1>
     541  <refsect1 id="vboxmanage-storageattach-see-also">
    542542    <title>See Also</title>
    543543    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-storagectl.xml

    r99154 r99513  
    9191  </refsynopsisdiv>
    9292
    93   <refsect1>
     93  <refsect1 id="vboxmanage-storagectl-description">
    9494    <title>Description</title>
    9595    <para>
     
    179179  </refsect1>
    180180
    181   <refsect1>
     181  <refsect1 id="vboxmanage-storagectl-examples">
    182182    <title>Examples</title>
    183183    <remark role="help-scope" condition="GLOBAL" />
     
    197197  </refsect1>
    198198
    199   <refsect1>
     199  <refsect1 id="vboxmanage-storagectl-see-also">
    200200    <title>See Also</title>
    201201    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-unattended.xml

    r99154 r99513  
    8787  </refsynopsisdiv>
    8888
    89   <refsect1>
     89  <refsect1 id="vboxmanage-unattended-description">
    9090    <title>Description</title>
    9191
  • trunk/doc/manual/en_US/man_VBoxManage-unregistervm.xml

    r99154 r99513  
    5959  </refsynopsisdiv>
    6060
    61   <refsect1>
     61  <refsect1 id="vboxmanage-unregistervm-description">
    6262    <title>Description</title>
    6363    <para>
     
    107107  </refsect1>
    108108
    109   <refsect1>
     109  <refsect1 id="vboxmanage-unregistervm-examples">
    110110    <title>Examples</title>
    111111    <remark role="help-scope" condition="GLOBAL" />
     
    124124  </refsect1>
    125125
    126   <refsect1>
     126  <refsect1 id="vboxmanage-unregistervm-see-also">
    127127    <title>See Also</title>
    128128    <para>
  • trunk/doc/manual/en_US/man_VBoxManage-updatecheck.xml

    r98103 r99513  
    6666  </refsynopsisdiv>
    6767
    68   <refsect1>
     68  <refsect1 id="vboxmanage-updatecheck-description">
    6969    <title>Description</title>
    7070
  • trunk/doc/manual/en_US/man_VBoxManage-usbdevsource.xml

    r98103 r99513  
    6060  </refsynopsisdiv>
    6161
    62   <refsect1>
     62  <refsect1 id="vboxmanage-usbdevsource-description">
    6363    <title>Description</title>
    6464    <para>
     
    118118  </refsect1>
    119119
    120   <refsect1>
     120  <refsect1 id="vboxmanage-usbdevsource-examples">
    121121    <title>Examples</title>
    122122    <remark role="help-scope" condition="GLOBAL" />
  • trunk/doc/manual/en_US/man_vboximg-mount.xml

    r99155 r99513  
    7878  </refsynopsisdiv>
    7979
    80   <refsect1 id="vboximg-mount-intro">
     80  <refsect1 id="vboximg-mount-description">
    8181    <title>Description</title>
    8282    <para>
     
    308308  </refsect1>
    309309
    310   <refsect1>
     310  <refsect1 id="vboximg-mount-examples">
    311311    <title>Examples</title>
    312312    <remark role="help-scope" condition="MOUNT-MOUNT,MOUNT-LIST"/>
  • trunk/src/VBox/Frontends/VBoxManage/VBoxManageCloud.cpp

    r98852 r99513  
    650650        {
    651651            case kCloudList_Images:
    652                 setCurrentSubcommand(HELP_SCOPE_CLOUDLIST_IMAGES);
     652                setCurrentSubcommand(HELP_SCOPE_CLOUD_LIST_IMAGES);
    653653                return listCloudImages(a, GetState.iNext, pCommonOpts);
    654654
    655655            case kCloudList_Instances:
    656                 setCurrentSubcommand(HELP_SCOPE_CLOUDLIST_INSTANCES);
     656                setCurrentSubcommand(HELP_SCOPE_CLOUD_LIST_INSTANCES);
    657657                return listCloudInstances(a, GetState.iNext, pCommonOpts);
    658658            case kCloudList_Machines:
     
    662662
    663663            case kCloudList_VnicAttachments:
    664                 setCurrentSubcommand(HELP_SCOPE_CLOUDLIST_VNICATTACHMENTS);
     664                setCurrentSubcommand(HELP_SCOPE_CLOUD_LIST_VNICATTACHMENTS);
    665665                return listCloudVnicAttachments(a, GetState.iNext, pCommonOpts);
    666666
     
    14271427            /* Sub-commands: */
    14281428            case kCloudInstance_Create:
    1429                 setCurrentSubcommand(HELP_SCOPE_CLOUDINSTANCE_CREATE);
     1429                setCurrentSubcommand(HELP_SCOPE_CLOUD_INSTANCE_CREATE);
    14301430                return createCloudInstance(a, GetState.iNext, pCommonOpts);
    14311431
    14321432            case kCloudInstance_Start:
    1433                 setCurrentSubcommand(HELP_SCOPE_CLOUDINSTANCE_START);
     1433                setCurrentSubcommand(HELP_SCOPE_CLOUD_INSTANCE_START);
    14341434                return startCloudInstance(a, GetState.iNext, pCommonOpts);
    14351435
    14361436            case kCloudInstance_Pause:
    1437                 setCurrentSubcommand(HELP_SCOPE_CLOUDINSTANCE_PAUSE);
     1437                setCurrentSubcommand(HELP_SCOPE_CLOUD_INSTANCE_PAUSE);
    14381438                return pauseCloudInstance(a, GetState.iNext, pCommonOpts);
    14391439
    14401440            case kCloudInstance_Info:
    1441                 setCurrentSubcommand(HELP_SCOPE_CLOUDINSTANCE_INFO);
     1441                setCurrentSubcommand(HELP_SCOPE_CLOUD_INSTANCE_INFO);
    14421442                return showCloudInstanceInfo(a, GetState.iNext, pCommonOpts);
    14431443
    14441444            case kCloudInstance_Update:
    1445 //              setCurrentSubcommand(HELP_SCOPE_CLOUDINSTANCE_UPDATE);
     1445//              setCurrentSubcommand(HELP_SCOPE_CLOUD_INSTANCE_UPDATE);
    14461446                return updateCloudInstance(a, GetState.iNext, pCommonOpts);
    14471447
    14481448            case kCloudInstance_Terminate:
    1449                 setCurrentSubcommand(HELP_SCOPE_CLOUDINSTANCE_TERMINATE);
     1449                setCurrentSubcommand(HELP_SCOPE_CLOUD_INSTANCE_TERMINATE);
    14501450                return terminateCloudInstance(a, GetState.iNext, pCommonOpts);
    14511451
    14521452            case kCloudInstance_Reset:
    1453                 setCurrentSubcommand(HELP_SCOPE_CLOUDINSTANCE_RESET);
     1453                setCurrentSubcommand(HELP_SCOPE_CLOUD_INSTANCE_RESET);
    14541454                return resetCloudInstance(a, GetState.iNext, pCommonOpts);
    14551455
     
    20802080            /* Sub-commands: */
    20812081            case kCloudImage_Create:
    2082                 setCurrentSubcommand(HELP_SCOPE_CLOUDIMAGE_CREATE);
     2082                setCurrentSubcommand(HELP_SCOPE_CLOUD_IMAGE_CREATE);
    20832083                return createCloudImage(a, GetState.iNext, pCommonOpts);
    20842084
    20852085            case kCloudImage_Export:
    2086                 setCurrentSubcommand(HELP_SCOPE_CLOUDIMAGE_EXPORT);
     2086                setCurrentSubcommand(HELP_SCOPE_CLOUD_IMAGE_EXPORT);
    20872087                return exportCloudImage(a, GetState.iNext, pCommonOpts);
    20882088
    20892089            case kCloudImage_Import:
    2090                 setCurrentSubcommand(HELP_SCOPE_CLOUDIMAGE_IMPORT);
     2090                setCurrentSubcommand(HELP_SCOPE_CLOUD_IMAGE_IMPORT);
    20912091                return importCloudImage(a, GetState.iNext, pCommonOpts);
    20922092
    20932093            case kCloudImage_Info:
    2094                 setCurrentSubcommand(HELP_SCOPE_CLOUDIMAGE_INFO);
     2094                setCurrentSubcommand(HELP_SCOPE_CLOUD_IMAGE_INFO);
    20952095                return showCloudImageInfo(a, GetState.iNext, pCommonOpts);
    20962096
    20972097            case kCloudImage_Update:
    2098 //              setCurrentSubcommand(HELP_SCOPE_CLOUDIMAGE_UPDATE);
     2098//              setCurrentSubcommand(HELP_SCOPE_CLOUD_IMAGE_UPDATE);
    20992099                return updateCloudImage(a, GetState.iNext, pCommonOpts);
    21002100
    21012101            case kCloudImage_Delete:
    2102                 setCurrentSubcommand(HELP_SCOPE_CLOUDIMAGE_DELETE);
     2102                setCurrentSubcommand(HELP_SCOPE_CLOUD_IMAGE_DELETE);
    21032103                return deleteCloudImage(a, GetState.iNext, pCommonOpts);
    21042104
  • trunk/src/VBox/Runtime/common/fs/isomakercmd-man.xml

    r98103 r99513  
    6262  </refsynopsisdiv>
    6363
    64   <refsect1>
     64  <refsect1 id="viso-description">
    6565    <title>Description</title>
    6666    <para>Construct a virtual ISO 9660 / Joliet / UDF / HFS hybrid image and either write it to a
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