VirtualBox

Changeset 89917 in vbox


Ignore:
Timestamp:
Jun 25, 2021 6:35:48 PM (3 years ago)
Author:
vboxsync
Message:

docbook2latex.xsl: Fix incorrect formatting (had too much line spacing and also was justified) of the last line of a refentry icommand synopsis. Use standard font (not monospace) for the square brackets, alternatives and so on. Use ellipses and tweak line breaking to happen at a defined places with alternatives. More compact and easier to read. Made the XSLT a little simpler with args and groups handling, and resolved a couple of quirks with missing or extra spaces when nesting them.

For several man_VBoxManage-*.xml files: Eliminate redundant attributes (choice="opt" is default) to make the files easier to read. Unified DOCTYPE and applied some small cleanups here and there.

Location:
trunk/doc/manual
Files:
7 edited

Legend:

Unmodified
Added
Removed

  • trunk/doc/manual/docbook2latex.xsl

    r89866 r89917  
    8383    </xsl:choose>
    8484  </xsl:variable>
     85
     86  <!-- command synopsis -->
     87  <xsl:variable name="arg.rep.repeat.str.tex">\ldots{}</xsl:variable>
     88  <xsl:variable name="arg.or.sep.tex"> |~</xsl:variable>
    8589
    8690  <xsl:output method="text"/>
    … …  
    903907  <xsl:template match="cmdsynopsis">
    904908    <xsl:if test="preceding-sibling::cmdsynopsis">
    905       <xsl:text>\par%cmdsynopsis</xsl:text>
     909      <xsl:text>%cmdsynopsis</xsl:text>
    906910    </xsl:if>
    907911    <xsl:text>&#x0a;</xsl:text>
     912    <xsl:text>\begin{flushleft}</xsl:text>
    908913    <xsl:if test="parent::remark[@role='VBoxManage-overview']">
    909914      <!-- Overview fontsize trick -->
    … …  
    923928    <!-- Special overview trick for the current VBoxManage command overview. -->
    924929    <xsl:if test="parent::remark[@role='VBoxManage-overview']">
    925       <xsl:text>\par}\vspace{1em}</xsl:text>
    926     </xsl:if>
     930      <xsl:text>\par}</xsl:text>
     931    </xsl:if>
     932    <xsl:text>\end{flushleft}</xsl:text>
    927933  </xsl:template>
    928934
    … …  
    930936    <xsl:choose>
    931937      <xsl:when test="ancestor::cmdsynopsis">
    932         <!-- Trigger a line break if this isn't the first command in a the synopsis -->
     938        <!-- Trigger a line break if this isn't the first command in a synopsis -->
    933939        <xsl:if test="preceding-sibling::command">
    934940          <xsl:text>}\par%command&#x0a;</xsl:text>
    … …  
    964970    <xsl:if test="position() > 1">
    965971      <xsl:choose>
    966         <xsl:when test="parent::group"><xsl:value-of select="$arg.or.sep"/></xsl:when>
     972        <xsl:when test="parent::group"><xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.or.sep.tex"/><xsl:text>}</xsl:text></xsl:when>
    967973        <xsl:when test="ancestor-or-self::*/@sepchar"><xsl:value-of select="ancestor-or-self::*/@sepchar"/></xsl:when>
    968974        <xsl:otherwise><xsl:text> </xsl:text></xsl:otherwise>
    … …  
    971977
    972978    <!-- open wrapping -->
    973     <xsl:variable name="fWrappers" select="not(ancestor::group)"/>
    974     <xsl:if test="$fWrappers">
    975       <xsl:choose>
    976         <xsl:when test="not(@choice) or @choice = ''">  <xsl:value-of select="$arg.choice.def.open.str"/></xsl:when>
    977         <xsl:when test="@choice = 'opt'">               <xsl:value-of select="$arg.choice.opt.open.str"/></xsl:when>
    978         <xsl:when test="@choice = 'req'">               <xsl:value-of select="$arg.choice.req.open.str"/></xsl:when>
    979         <xsl:when test="@choice = 'plain'"/>
    980         <xsl:otherwise><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>Invalid arg choice: "<xsl:value-of select="@choice"/>"</xsl:message></xsl:otherwise>
    981       </xsl:choose>
    982     </xsl:if>
    983 
    984     <!-- render the arg (TODO: may need to do more work here) -->
    985     <xsl:apply-templates />
    986 
    987     <!-- repeat wrapping -->
     979    <xsl:choose>
     980      <xsl:when test="not(@choice) or @choice = ''">  <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.def.open.str"/><xsl:text>}</xsl:text></xsl:when>
     981      <xsl:when test="@choice = 'opt'">               <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.opt.open.str"/><xsl:text>}</xsl:text></xsl:when>
     982      <xsl:when test="@choice = 'req'">               <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.req.open.str"/><xsl:text>}</xsl:text></xsl:when>
     983      <xsl:when test="@choice = 'plain'"/>
     984      <xsl:otherwise><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>Invalid arg choice: "<xsl:value-of select="@choice"/>"</xsl:message></xsl:otherwise>
     985    </xsl:choose>
     986
     987    <xsl:apply-templates />
     988
     989    <!-- repeat indication -->
    988990    <xsl:choose>
    989991      <xsl:when test="@rep = 'norepeat' or not(@rep) or @rep = ''"/>
    990       <xsl:when test="@rep = 'repeat'">               <xsl:value-of select="$arg.rep.repeat.str"/></xsl:when>
     992      <xsl:when test="@rep = 'repeat'">
     993        <!-- add space padding if we're in a repeating group -->
     994        <xsl:if test="self::group">
     995          <xsl:text> </xsl:text>
     996        </xsl:if>
     997        <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.rep.repeat.str.tex"/><xsl:text>}</xsl:text>
     998      </xsl:when>
    991999      <xsl:otherwise><xsl:message terminate="yes"><xsl:call-template name="error-prefix"/>Invalid rep choice: "<xsl:value-of select="@rep"/>"</xsl:message></xsl:otherwise>
    9921000    </xsl:choose>
    9931001
    9941002    <!-- close wrapping -->
    995     <xsl:if test="$fWrappers">
    996       <xsl:choose>
    997         <xsl:when test="not(@choice) or @choice = ''">  <xsl:value-of select="$arg.choice.def.close.str"/></xsl:when>
    998         <xsl:when test="@choice = 'opt'">               <xsl:value-of select="$arg.choice.opt.close.str"/></xsl:when>
    999         <xsl:when test="@choice = 'req'">               <xsl:value-of select="$arg.choice.req.close.str"/></xsl:when>
    1000       </xsl:choose>
    1001       <!-- Add a space padding if we're the last element in a repeating arg or group -->
    1002       <xsl:if test="(parent::arg or parent::group) and not(following-sibiling)">
    1003         <xsl:text> </xsl:text>
    1004       </xsl:if>
     1003    <xsl:choose>
     1004      <xsl:when test="not(@choice) or @choice = ''">  <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.def.close.str"/><xsl:text>}</xsl:text></xsl:when>
     1005      <xsl:when test="@choice = 'opt'">               <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.opt.close.str"/><xsl:text>}</xsl:text></xsl:when>
     1006      <xsl:when test="@choice = 'req'">               <xsl:text>\textrm{</xsl:text><xsl:value-of select="$arg.choice.req.close.str"/><xsl:text>}</xsl:text></xsl:when>
     1007    </xsl:choose>
     1008
     1009    <!-- add space padding if we're the last element in a nested arg -->
     1010    <xsl:if test="parent::arg and not(following-sibling)">
     1011      <xsl:text> </xsl:text>
    10051012    </xsl:if>
    10061013  </xsl:template>

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

    r87279 r89917  
    1313    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
    1414 -->
    15 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
     15<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
     16  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
     17<!ENTITY % all.entities SYSTEM "all-entities.ent">
     18%all.entities;
     19]>
    1620<refentry id="vboxmanage-cloud" lang="en">
    17 
    1821  <refentryinfo>
    1922    <pubdate>$Date$</pubdate>
    … …  
    5659      <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-create" sepchar=" ">
    5760       <command moreinfo="none">VBoxManage cloud</command>
    58        <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    59        <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    60        <arg choice="plain" rep="norepeat">instance</arg>
    61        <arg choice="plain" rep="norepeat">create</arg>
    62        <arg choice="req" rep="norepeat">--domain-name=<replaceable>name</replaceable></arg>
     61       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     62       <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     63       <arg choice="plain">instance</arg>
     64       <arg choice="plain">create</arg>
     65       <arg choice="req">--domain-name=<replaceable>name</replaceable></arg>
    6366       <group choice="req">
    64            <arg choice="req" rep="norepeat">--image-id=<replaceable>id</replaceable></arg>
    65            <arg choice="req" rep="norepeat">--boot-volume-id=<replaceable>id</replaceable></arg>
     67           <arg choice="req">--image-id=<replaceable>id</replaceable></arg>
     68           <arg choice="req">--boot-volume-id=<replaceable>id</replaceable></arg>
    6669       </group>
    67        <arg choice="req" rep="norepeat">--display-name=<replaceable>name</replaceable></arg>
    68        <arg choice="req" rep="norepeat">--shape=<replaceable>type</replaceable></arg>
    69        <arg choice="req" rep="norepeat">--subnet=<replaceable>id</replaceable></arg>
    70        <arg rep="norepeat">--boot-disk-size=<replaceable>size in GB</replaceable></arg>
    71        <arg rep="norepeat">--publicip=<replaceable>true/false</replaceable></arg>
    72        <arg rep="norepeat">--privateip=<replaceable>IP address</replaceable></arg>
     70       <arg choice="req">--display-name=<replaceable>name</replaceable></arg>
     71       <arg choice="req">--shape=<replaceable>type</replaceable></arg>
     72       <arg choice="req">--subnet=<replaceable>id</replaceable></arg>
     73       <arg>--boot-disk-size=<replaceable>size in GB</replaceable></arg>
     74       <arg>--publicip=<replaceable>true/false</replaceable></arg>
     75       <arg>--privateip=<replaceable>IP address</replaceable></arg>
    7376       <arg rep="repeat">--public-ssh-key=<replaceable>key string</replaceable></arg>
    74        <arg rep="norepeat">--launch-mode=<replaceable>NATIVE/EMULATED/PARAVIRTUALIZED</replaceable></arg>
    75        <arg rep="norepeat">--cloud-init-script-path=<replaceable>path to a script</replaceable></arg>
     77       <arg>--launch-mode=<replaceable>NATIVE/EMULATED/PARAVIRTUALIZED</replaceable></arg>
     78       <arg>--cloud-init-script-path=<replaceable>path to a script</replaceable></arg>
    7679     </cmdsynopsis>
    7780     <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-info" sepchar=" ">
    7881       <command moreinfo="none">VBoxManage cloud</command>
    79        <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    80        <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    81        <arg choice="plain" rep="norepeat">instance</arg>
    82        <arg choice="plain" rep="norepeat">info</arg>
    83        <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     82       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     83       <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     84       <arg choice="plain">instance</arg>
     85       <arg choice="plain">info</arg>
     86       <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    8487     </cmdsynopsis>
    8588     <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-terminate" sepchar=" ">
    8689       <command moreinfo="none">VBoxManage cloud</command>
    87        <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    88        <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    89        <arg choice="plain" rep="norepeat">instance</arg>
    90        <arg choice="plain" rep="norepeat">terminate</arg>
    91        <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     90       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     91       <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     92       <arg choice="plain">instance</arg>
     93       <arg choice="plain">terminate</arg>
     94       <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    9295     </cmdsynopsis>
    9396     <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-start" sepchar=" ">
    9497       <command moreinfo="none">VBoxManage cloud</command>
    95        <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    96        <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    97        <arg choice="plain" rep="norepeat">instance</arg>
    98        <arg choice="plain" rep="norepeat">start</arg>
    99        <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     98       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     99       <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     100       <arg choice="plain">instance</arg>
     101       <arg choice="plain">start</arg>
     102       <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    100103     </cmdsynopsis>
    101104     <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-pause" sepchar=" ">
    102105       <command moreinfo="none">VBoxManage cloud</command>
    103        <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    104        <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    105        <arg choice="plain" rep="norepeat">instance</arg>
    106        <arg choice="plain" rep="norepeat">pause</arg>
    107        <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     106       <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     107       <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     108       <arg choice="plain">instance</arg>
     109       <arg choice="plain">pause</arg>
     110       <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    108111     </cmdsynopsis>
    109112
    … …  
    111114      <cmdsynopsis id="synopsis-vboxmanage-cloudimage-create" sepchar=" "> <!-- The 'id' is mandatory and must start with 'synopsis-'. -->
    112115        <command>VBoxManage cloud</command>
    113           <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    114           <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    115           <arg choice="plain" rep="norepeat">image</arg>
    116           <arg choice="plain" rep="norepeat">create</arg>
    117           <arg choice="req" rep="norepeat">--display-name=<replaceable>name</replaceable></arg>
    118           <arg rep="norepeat">--bucket-name=<replaceable>name</replaceable></arg>
    119           <arg rep="norepeat">--object-name=<replaceable>name</replaceable></arg>
    120           <arg rep="norepeat">--instance-id=<replaceable>unique id</replaceable></arg>
     116          <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     117          <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     118          <arg choice="plain">image</arg>
     119          <arg choice="plain">create</arg>
     120          <arg choice="req">--display-name=<replaceable>name</replaceable></arg>
     121          <arg>--bucket-name=<replaceable>name</replaceable></arg>
     122          <arg>--object-name=<replaceable>name</replaceable></arg>
     123          <arg>--instance-id=<replaceable>unique id</replaceable></arg>
    121124      </cmdsynopsis>
    122125      <cmdsynopsis id="synopsis-vboxmanage-cloudimage-info" sepchar=" ">
    123126        <command>VBoxManage cloud</command>
    124         <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    125         <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    126         <arg choice="plain" rep="norepeat">image</arg>
    127         <arg choice="plain" rep="norepeat">info</arg>
    128         <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     127        <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     128        <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     129        <arg choice="plain">image</arg>
     130        <arg choice="plain">info</arg>
     131        <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    129132      </cmdsynopsis>
    130133      <cmdsynopsis id="synopsis-vboxmanage-cloudimage-delete" sepchar=" ">
    131134        <command>VBoxManage cloud</command>
    132         <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    133         <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    134         <arg choice="plain" rep="norepeat">image</arg>
    135         <arg choice="plain" rep="norepeat">delete</arg>
    136         <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     135        <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     136        <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     137        <arg choice="plain">image</arg>
     138        <arg choice="plain">delete</arg>
     139        <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    137140      </cmdsynopsis>
    138141      <cmdsynopsis id="synopsis-vboxmanage-cloudimage-import" sepchar=" ">
    139142        <command>VBoxManage cloud</command>
    140         <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    141         <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    142         <arg choice="plain" rep="norepeat">image</arg>
    143         <arg choice="plain" rep="norepeat">import</arg>
    144         <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
    145         <arg rep="norepeat">--bucket-name=<replaceable>name</replaceable></arg>
    146         <arg rep="norepeat">--object-name=<replaceable>name</replaceable></arg>
     143        <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     144        <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     145        <arg choice="plain">image</arg>
     146        <arg choice="plain">import</arg>
     147        <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
     148        <arg>--bucket-name=<replaceable>name</replaceable></arg>
     149        <arg>--object-name=<replaceable>name</replaceable></arg>
    147150      </cmdsynopsis>
    148151      <cmdsynopsis id="synopsis-vboxmanage-cloudimage-export" sepchar=" ">
    149152        <command>VBoxManage cloud</command>
    150         <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    151         <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    152         <arg choice="plain" rep="norepeat">image</arg>
    153         <arg choice="plain" rep="norepeat">export</arg>
    154         <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
    155         <arg choice="req" rep="norepeat">--display-name=<replaceable>name</replaceable></arg>
    156         <arg rep="norepeat">--bucket-name=<replaceable>name</replaceable></arg>
    157         <arg rep="norepeat">--object-name=<replaceable>name</replaceable></arg>
     153        <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     154        <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     155        <arg choice="plain">image</arg>
     156        <arg choice="plain">export</arg>
     157        <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
     158        <arg choice="req">--display-name=<replaceable>name</replaceable></arg>
     159        <arg>--bucket-name=<replaceable>name</replaceable></arg>
     160        <arg>--object-name=<replaceable>name</replaceable></arg>
    158161      </cmdsynopsis>
    159162

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

    r82969 r89917  
    1313    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
    1414 -->
    15 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    16 
     15<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
     16  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
     17<!ENTITY % all.entities SYSTEM "all-entities.ent">
     18%all.entities;
     19]>
    1720<refentry id="vboxmanage-cloudimage" lang="en">
    18 
    1921  <refentryinfo>
    2022    <pubdate>$Date$</pubdate>
    … …  
    3638    <cmdsynopsis id="synopsis-vboxmanage-cloudimage-create" sepchar=" "> <!-- The 'id' is mandatory and must start with 'synopsis-'. -->
    3739      <command>VBoxManage cloud</command>
    38         <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    39         <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    40         <arg choice="plain" rep="norepeat">image</arg>
    41         <arg choice="plain" rep="norepeat">create</arg>
    42         <arg choice="req" rep="norepeat">--display-name=<replaceable>name</replaceable></arg>
    43         <arg rep="norepeat">--bucket-name=<replaceable>name</replaceable></arg>
    44         <arg rep="norepeat">--object-name=<replaceable>name</replaceable></arg>
    45         <arg rep="norepeat">--instance-id=<replaceable>unique id</replaceable></arg>
     40        <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     41        <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     42        <arg choice="plain">image</arg>
     43        <arg choice="plain">create</arg>
     44        <arg choice="req">--display-name=<replaceable>name</replaceable></arg>
     45        <arg>--bucket-name=<replaceable>name</replaceable></arg>
     46        <arg>--object-name=<replaceable>name</replaceable></arg>
     47        <arg>--instance-id=<replaceable>unique id</replaceable></arg>
    4648    </cmdsynopsis>
    4749    <cmdsynopsis id="synopsis-vboxmanage-cloudimage-info" sepchar=" ">
    4850      <command>VBoxManage cloud</command>
    49       <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    50       <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    51       <arg choice="plain" rep="norepeat">image</arg>
    52       <arg choice="plain" rep="norepeat">info</arg>
    53       <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     51      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     52      <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     53      <arg choice="plain">image</arg>
     54      <arg choice="plain">info</arg>
     55      <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    5456    </cmdsynopsis>
    5557    <cmdsynopsis id="synopsis-vboxmanage-cloudimage-delete" sepchar=" ">
    5658      <command>VBoxManage cloud</command>
    57       <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    58       <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    59       <arg choice="plain" rep="norepeat">image</arg>
    60       <arg choice="plain" rep="norepeat">delete</arg>
    61       <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     59      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     60      <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     61      <arg choice="plain">image</arg>
     62      <arg choice="plain">delete</arg>
     63      <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    6264    </cmdsynopsis>
    6365    <cmdsynopsis id="synopsis-vboxmanage-cloudimage-import" sepchar=" ">
    6466      <command>VBoxManage cloud</command>
    65       <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    66       <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    67       <arg choice="plain" rep="norepeat">image</arg>
    68       <arg choice="plain" rep="norepeat">import</arg>
    69       <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
    70       <arg rep="norepeat">--bucket-name=<replaceable>name</replaceable></arg>
    71       <arg rep="norepeat">--object-name=<replaceable>name</replaceable></arg>
     67      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     68      <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     69      <arg choice="plain">image</arg>
     70      <arg choice="plain">import</arg>
     71      <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
     72      <arg>--bucket-name=<replaceable>name</replaceable></arg>
     73      <arg>--object-name=<replaceable>name</replaceable></arg>
    7274    </cmdsynopsis>
    7375    <cmdsynopsis id="synopsis-vboxmanage-cloudimage-export" sepchar=" ">
    7476      <command>VBoxManage cloud</command>
    75       <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    76       <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    77       <arg choice="plain" rep="norepeat">image</arg>
    78       <arg choice="plain" rep="norepeat">export</arg>
    79       <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
    80       <arg choice="req" rep="norepeat">--display-name=<replaceable>name</replaceable></arg>
    81       <arg rep="norepeat">--bucket-name=<replaceable>name</replaceable></arg>
    82       <arg rep="norepeat">--object-name=<replaceable>name</replaceable></arg>
     77      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     78      <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     79      <arg choice="plain">image</arg>
     80      <arg choice="plain">export</arg>
     81      <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
     82      <arg choice="req">--display-name=<replaceable>name</replaceable></arg>
     83      <arg>--bucket-name=<replaceable>name</replaceable></arg>
     84      <arg>--object-name=<replaceable>name</replaceable></arg>
    8385    </cmdsynopsis>
    8486  </refsynopsisdiv>

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

    r82969 r89917  
    1313    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
    1414 -->
     15<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
     16  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
     17<!ENTITY % all.entities SYSTEM "all-entities.ent">
     18%all.entities;
     19]>
    1520<refentry id="vboxmanage-cloudinstance" lang="en">
    16 
    1721  <refentryinfo>
    1822    <pubdate>$Date$</pubdate>
    … …  
    3438     <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-create" sepchar=" ">
    3539      <command moreinfo="none">VBoxManage cloud</command>
    36       <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    37       <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    38       <arg choice="plain" rep="norepeat">instance</arg>
    39       <arg choice="plain" rep="norepeat">create</arg>
    40       <arg choice="req" rep="norepeat">--domain-name=<replaceable>name</replaceable></arg>
     40      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     41      <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     42      <arg choice="plain">instance</arg>
     43      <arg choice="plain">create</arg>
     44      <arg choice="req">--domain-name=<replaceable>name</replaceable></arg>
    4145      <group choice="req">
    42           <arg choice="req" rep="norepeat">--image-id=<replaceable>id</replaceable></arg>
    43           <arg choice="req" rep="norepeat">--boot-volume-id=<replaceable>id</replaceable></arg>
     46          <arg choice="req">--image-id=<replaceable>id</replaceable></arg>
     47          <arg choice="req">--boot-volume-id=<replaceable>id</replaceable></arg>
    4448      </group>
    45       <arg choice="req" rep="norepeat">--display-name=<replaceable>name</replaceable></arg>
    46       <arg choice="req" rep="norepeat">--shape=<replaceable>type</replaceable></arg>
    47       <arg choice="req" rep="norepeat">--subnet=<replaceable>id</replaceable></arg>
    48       <arg rep="norepeat">--boot-disk-size=<replaceable>size in GB</replaceable></arg>
    49       <arg rep="norepeat">--publicip=<replaceable>true/false</replaceable></arg>
    50       <arg rep="norepeat">--privateip=<replaceable>IP address</replaceable></arg>
     49      <arg choice="req">--display-name=<replaceable>name</replaceable></arg>
     50      <arg choice="req">--shape=<replaceable>type</replaceable></arg>
     51      <arg choice="req">--subnet=<replaceable>id</replaceable></arg>
     52      <arg>--boot-disk-size=<replaceable>size in GB</replaceable></arg>
     53      <arg>--publicip=<replaceable>true/false</replaceable></arg>
     54      <arg>--privateip=<replaceable>IP address</replaceable></arg>
    5155      <arg rep="repeat">--public-ssh-key=<replaceable>key string</replaceable></arg>
    52       <arg rep="norepeat">--launch-mode=<replaceable>NATIVE/EMULATED/PARAVIRTUALIZED</replaceable></arg>
     56      <arg>--launch-mode=<replaceable>NATIVE/EMULATED/PARAVIRTUALIZED</replaceable></arg>
    5357    </cmdsynopsis>
    5458    <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-info" sepchar=" ">
    5559      <command moreinfo="none">VBoxManage cloud</command>
    56       <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    57       <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    58       <arg choice="plain" rep="norepeat">instance</arg>
    59       <arg choice="plain" rep="norepeat">info</arg>
    60       <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     60      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     61      <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     62      <arg choice="plain">instance</arg>
     63      <arg choice="plain">info</arg>
     64      <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    6165    </cmdsynopsis>
    6266    <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-terminate" sepchar=" ">
    6367      <command moreinfo="none">VBoxManage cloud</command>
    64       <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    65       <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    66       <arg choice="plain" rep="norepeat">instance</arg>
    67       <arg choice="plain" rep="norepeat">terminate</arg>
    68       <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     68      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     69      <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     70      <arg choice="plain">instance</arg>
     71      <arg choice="plain">terminate</arg>
     72      <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    6973    </cmdsynopsis>
    7074    <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-start" sepchar=" ">
    7175      <command moreinfo="none">VBoxManage cloud</command>
    72       <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    73       <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    74       <arg choice="plain" rep="norepeat">instance</arg>
    75       <arg choice="plain" rep="norepeat">start</arg>
    76       <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     76      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     77      <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     78      <arg choice="plain">instance</arg>
     79      <arg choice="plain">start</arg>
     80      <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    7781    </cmdsynopsis>
    7882    <cmdsynopsis id="synopsis-vboxmanage-cloudinstance-pause" sepchar=" ">
    7983      <command moreinfo="none">VBoxManage cloud</command>
    80       <arg choice="req" rep="norepeat">--provider=<replaceable>name</replaceable></arg>
    81       <arg choice="req" rep="norepeat">--profile=<replaceable>name</replaceable></arg>
    82       <arg choice="plain" rep="norepeat">instance</arg>
    83       <arg choice="plain" rep="norepeat">pause</arg>
    84       <arg choice="req" rep="norepeat">--id=<replaceable>unique id</replaceable></arg>
     84      <arg choice="req">--provider=<replaceable>name</replaceable></arg>
     85      <arg choice="req">--profile=<replaceable>name</replaceable></arg>
     86      <arg choice="plain">instance</arg>
     87      <arg choice="plain">pause</arg>
     88      <arg choice="req">--id=<replaceable>unique id</replaceable></arg>
    8589    </cmdsynopsis>
    8690  </refsynopsisdiv>

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

    r89697 r89917  
    100100      <arg choice="plain">setregisters</arg>
    101101      <arg>--cpu=<replaceable>id</replaceable></arg>
    102       <arg rep="repeat"><replaceable>reg-set.reg-name=value</replaceable></arg>
     102      <arg rep="repeat"><replaceable>reg-set.reg-name</replaceable>=<replaceable>value</replaceable></arg>
    103103    </cmdsynopsis>
    104104    <cmdsynopsis id="synopsis-vboxmanage-debugvm-show">

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

    r86820 r89917  
    1313    hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
    1414 -->
    15 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
     15<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
     16  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"[
     17<!ENTITY % all.entities SYSTEM "all-entities.ent">
     18%all.entities;
     19]>
    1620<refentry id="vboxmanage-dhcpserver" lang="en">
    17 
    1821  <refentryinfo>
    1922    <pubdate>$Date$</pubdate>
    … …  
    4851      </group>
    4952      <sbr/>
    50       <arg choice="opt" rep="repeat">
    51         <arg choice="opt">--global</arg>
    52         <arg choice="opt" rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
    53         <arg choice="opt" rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
    54         <arg choice="opt" rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    55         <arg choice="opt" rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    56         <arg choice="opt">--min-lease-time=<replaceable>seconds</replaceable></arg>
    57         <arg choice="opt">--default-lease-time=<replaceable>seconds</replaceable></arg>
    58         <arg choice="opt">--max-lease-time=<replaceable>seconds</replaceable></arg>
    59       </arg>
    60       <sbr/>
    61       <arg choice="opt" rep="repeat">
     53      <group rep="repeat">
     54        <arg>--global</arg>
     55        <arg rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
     56        <arg rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
     57        <arg rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     58        <arg rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     59        <arg>--min-lease-time=<replaceable>seconds</replaceable></arg>
     60        <arg>--default-lease-time=<replaceable>seconds</replaceable></arg>
     61        <arg>--max-lease-time=<replaceable>seconds</replaceable></arg>
     62      </group>
     63      <sbr/>
     64      <group rep="repeat">
    6265        <arg choice="req">--group=<replaceable>name</replaceable></arg>
    63         <arg choice="opt" rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
    64         <arg choice="opt" rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
    65         <arg choice="opt" rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    66         <arg choice="opt" rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    67         <arg choice="opt" rep="repeat">--incl-mac=<replaceable>address</replaceable></arg>
    68         <arg choice="opt" rep="repeat">--excl-mac=<replaceable>address</replaceable></arg>
    69         <arg choice="opt" rep="repeat">--incl-mac-wild=<replaceable>pattern</replaceable></arg>
    70         <arg choice="opt" rep="repeat">--excl-mac-wild=<replaceable>pattern</replaceable></arg>
    71         <arg choice="opt" rep="repeat">--incl-vendor=<replaceable>string</replaceable></arg>
    72         <arg choice="opt" rep="repeat">--excl-vendor=<replaceable>string</replaceable></arg>
    73         <arg choice="opt" rep="repeat">--incl-vendor-wild=<replaceable>pattern</replaceable></arg>
    74         <arg choice="opt" rep="repeat">--excl-vendor-wild=<replaceable>pattern</replaceable></arg>
    75         <arg choice="opt" rep="repeat">--incl-user=<replaceable>string</replaceable></arg>
    76         <arg choice="opt" rep="repeat">--excl-user=<replaceable>string</replaceable></arg>
    77         <arg choice="opt" rep="repeat">--incl-user-wild=<replaceable>pattern</replaceable></arg>
    78         <arg choice="opt" rep="repeat">--excl-user-wild=<replaceable>pattern</replaceable></arg>
    79         <arg choice="opt">--min-lease-time=<replaceable>seconds</replaceable></arg>
    80         <arg choice="opt">--default-lease-time=<replaceable>seconds</replaceable></arg>
    81         <arg choice="opt">--max-lease-time=<replaceable>seconds</replaceable></arg>
    82       </arg>
    83       <sbr/>
    84       <arg choice="opt" rep="repeat">
     66        <arg rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
     67        <arg rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
     68        <arg rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     69        <arg rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     70        <arg rep="repeat">--incl-mac=<replaceable>address</replaceable></arg>
     71        <arg rep="repeat">--excl-mac=<replaceable>address</replaceable></arg>
     72        <arg rep="repeat">--incl-mac-wild=<replaceable>pattern</replaceable></arg>
     73        <arg rep="repeat">--excl-mac-wild=<replaceable>pattern</replaceable></arg>
     74        <arg rep="repeat">--incl-vendor=<replaceable>string</replaceable></arg>
     75        <arg rep="repeat">--excl-vendor=<replaceable>string</replaceable></arg>
     76        <arg rep="repeat">--incl-vendor-wild=<replaceable>pattern</replaceable></arg>
     77        <arg rep="repeat">--excl-vendor-wild=<replaceable>pattern</replaceable></arg>
     78        <arg rep="repeat">--incl-user=<replaceable>string</replaceable></arg>
     79        <arg rep="repeat">--excl-user=<replaceable>string</replaceable></arg>
     80        <arg rep="repeat">--incl-user-wild=<replaceable>pattern</replaceable></arg>
     81        <arg rep="repeat">--excl-user-wild=<replaceable>pattern</replaceable></arg>
     82        <arg>--min-lease-time=<replaceable>seconds</replaceable></arg>
     83        <arg>--default-lease-time=<replaceable>seconds</replaceable></arg>
     84        <arg>--max-lease-time=<replaceable>seconds</replaceable></arg>
     85      </group>
     86      <sbr/>
     87      <group rep="repeat">
    8588        <arg choice="req">--vm=<replaceable>name|uuid</replaceable></arg>
    86         <arg choice="opt">--nic=<replaceable>1-N</replaceable></arg>
    87         <arg choice="opt" rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
    88         <arg choice="opt" rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
    89         <arg choice="opt" rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    90         <arg choice="opt" rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    91         <arg choice="opt">--min-lease-time=<replaceable>seconds</replaceable></arg>
    92         <arg choice="opt">--default-lease-time=<replaceable>seconds</replaceable></arg>
    93         <arg choice="opt">--max-lease-time=<replaceable>seconds</replaceable></arg>
    94         <arg choice="opt">--fixed-address=<replaceable>address</replaceable></arg>
    95       </arg>
    96       <sbr/>
    97       <arg choice="opt" rep="repeat">
     89        <arg>--nic=<replaceable>1-N</replaceable></arg>
     90        <arg rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
     91        <arg rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
     92        <arg rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     93        <arg rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     94        <arg>--min-lease-time=<replaceable>seconds</replaceable></arg>
     95        <arg>--default-lease-time=<replaceable>seconds</replaceable></arg>
     96        <arg>--max-lease-time=<replaceable>seconds</replaceable></arg>
     97        <arg>--fixed-address=<replaceable>address</replaceable></arg>
     98      </group>
     99      <sbr/>
     100      <group rep="repeat">
    98101        <arg choice="req">--mac-address=<replaceable>address</replaceable></arg>
    99         <arg choice="opt" rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
    100         <arg choice="opt" rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
    101         <arg choice="opt" rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    102         <arg choice="opt" rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    103         <arg choice="opt">--min-lease-time=<replaceable>seconds</replaceable></arg>
    104         <arg choice="opt">--default-lease-time=<replaceable>seconds</replaceable></arg>
    105         <arg choice="opt">--max-lease-time=<replaceable>seconds</replaceable></arg>
    106         <arg choice="opt">--fixed-address=<replaceable>address</replaceable></arg>
    107       </arg>
     102        <arg rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
     103        <arg rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
     104        <arg rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     105        <arg rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     106        <arg>--min-lease-time=<replaceable>seconds</replaceable></arg>
     107        <arg>--default-lease-time=<replaceable>seconds</replaceable></arg>
     108        <arg>--max-lease-time=<replaceable>seconds</replaceable></arg>
     109        <arg>--fixed-address=<replaceable>address</replaceable></arg>
     110      </group>
    108111    </cmdsynopsis>
    109112    <cmdsynopsis id="synopsis-vboxmanage-dhcpserver-modify">
    … …  
    113116        <arg choice="plain">--interface=<replaceable>ifname</replaceable></arg>
    114117      </group>
    115       <arg choice="opt">--server-ip=<replaceable>address</replaceable></arg>
    116       <arg choice="opt">--lower-ip=<replaceable>address</replaceable></arg>
    117       <arg choice="opt">--upper-ip=<replaceable>address</replaceable></arg>
    118       <arg choice="opt">--netmask=<replaceable>mask</replaceable></arg>
    119       <group choice="opt">
     118      <arg>--server-ip=<replaceable>address</replaceable></arg>
     119      <arg>--lower-ip=<replaceable>address</replaceable></arg>
     120      <arg>--upper-ip=<replaceable>address</replaceable></arg>
     121      <arg>--netmask=<replaceable>mask</replaceable></arg>
     122      <group>
    120123        <arg choice="plain">--enable</arg>
    121124        <arg choice="plain">--disable</arg>
    122125      </group>
    123126      <sbr/>
    124       <arg choice="opt" rep="repeat">
    125         <arg choice="opt">--global</arg>
    126         <arg choice="opt" rep="repeat">--del-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    127         <arg choice="opt" rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
    128         <arg choice="opt" rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
    129         <arg choice="opt" rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    130         <arg choice="opt" rep="repeat">--unforce-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    131         <arg choice="opt" rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    132         <arg choice="opt" rep="repeat">--unsupress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    133         <arg choice="opt">--min-lease-time=<replaceable>seconds</replaceable></arg>
    134         <arg choice="opt">--default-lease-time=<replaceable>seconds</replaceable></arg>
    135         <arg choice="opt">--max-lease-time=<replaceable>seconds</replaceable></arg>
    136         <arg choice="opt">--remove-config</arg>
    137       </arg>
    138       <sbr/>
    139       <arg choice="opt" rep="repeat">
     127      <group rep="repeat">
     128        <arg>--global</arg>
     129        <arg rep="repeat">--del-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     130        <arg rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
     131        <arg rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
     132        <arg rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     133        <arg rep="repeat">--unforce-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     134        <arg rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     135        <arg rep="repeat">--unsupress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     136        <arg>--min-lease-time=<replaceable>seconds</replaceable></arg>
     137        <arg>--default-lease-time=<replaceable>seconds</replaceable></arg>
     138        <arg>--max-lease-time=<replaceable>seconds</replaceable></arg>
     139        <arg>--remove-config</arg>
     140      </group>
     141      <sbr/>
     142      <group rep="repeat">
    140143        <arg choice="req">--group=<replaceable>name</replaceable></arg>
    141         <arg choice="opt" rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
    142         <arg choice="opt" rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
    143         <arg choice="opt" rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    144         <arg choice="opt" rep="repeat">--unforce-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    145         <arg choice="opt" rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    146         <arg choice="opt" rep="repeat">--unsupress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    147         <arg choice="opt" rep="repeat">--del-mac=<replaceable>address</replaceable></arg>
    148         <arg choice="opt" rep="repeat">--incl-mac=<replaceable>address</replaceable></arg>
    149         <arg choice="opt" rep="repeat">--excl-mac=<replaceable>address</replaceable></arg>
    150         <arg choice="opt" rep="repeat">--del-mac-wild=<replaceable>pattern</replaceable></arg>
    151         <arg choice="opt" rep="repeat">--incl-mac-wild=<replaceable>pattern</replaceable></arg>
    152         <arg choice="opt" rep="repeat">--excl-mac-wild=<replaceable>pattern</replaceable></arg>
    153         <arg choice="opt" rep="repeat">--del-vendor=<replaceable>string</replaceable></arg>
    154         <arg choice="opt" rep="repeat">--incl-vendor=<replaceable>string</replaceable></arg>
    155         <arg choice="opt" rep="repeat">--excl-vendor=<replaceable>string</replaceable></arg>
    156         <arg choice="opt" rep="repeat">--del-vendor-wild=<replaceable>pattern</replaceable></arg>
    157         <arg choice="opt" rep="repeat">--incl-vendor-wild=<replaceable>pattern</replaceable></arg>
    158         <arg choice="opt" rep="repeat">--excl-vendor-wild=<replaceable>pattern</replaceable></arg>
    159         <arg choice="opt" rep="repeat">--del-user=<replaceable>string</replaceable></arg>
    160         <arg choice="opt" rep="repeat">--incl-user=<replaceable>string</replaceable></arg>
    161         <arg choice="opt" rep="repeat">--excl-user=<replaceable>string</replaceable></arg>
    162         <arg choice="opt" rep="repeat">--del-user-wild=<replaceable>pattern</replaceable></arg>
    163         <arg choice="opt" rep="repeat">--incl-user-wild=<replaceable>pattern</replaceable></arg>
    164         <arg choice="opt" rep="repeat">--excl-user-wild=<replaceable>pattern</replaceable></arg>
    165         <arg choice="opt">--zap-conditions</arg>
    166         <arg choice="opt">--min-lease-time=<replaceable>seconds</replaceable></arg>
    167         <arg choice="opt">--default-lease-time=<replaceable>seconds</replaceable></arg>
    168         <arg choice="opt">--max-lease-time=<replaceable>seconds</replaceable></arg>
    169         <arg choice="opt">--remove-config</arg>
    170       </arg>
    171       <sbr/>
    172       <arg choice="opt" rep="repeat">
     144        <arg rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
     145        <arg rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
     146        <arg rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     147        <arg rep="repeat">--unforce-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     148        <arg rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     149        <arg rep="repeat">--unsupress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     150        <arg rep="repeat">--del-mac=<replaceable>address</replaceable></arg>
     151        <arg rep="repeat">--incl-mac=<replaceable>address</replaceable></arg>
     152        <arg rep="repeat">--excl-mac=<replaceable>address</replaceable></arg>
     153        <arg rep="repeat">--del-mac-wild=<replaceable>pattern</replaceable></arg>
     154        <arg rep="repeat">--incl-mac-wild=<replaceable>pattern</replaceable></arg>
     155        <arg rep="repeat">--excl-mac-wild=<replaceable>pattern</replaceable></arg>
     156        <arg rep="repeat">--del-vendor=<replaceable>string</replaceable></arg>
     157        <arg rep="repeat">--incl-vendor=<replaceable>string</replaceable></arg>
     158        <arg rep="repeat">--excl-vendor=<replaceable>string</replaceable></arg>
     159        <arg rep="repeat">--del-vendor-wild=<replaceable>pattern</replaceable></arg>
     160        <arg rep="repeat">--incl-vendor-wild=<replaceable>pattern</replaceable></arg>
     161        <arg rep="repeat">--excl-vendor-wild=<replaceable>pattern</replaceable></arg>
     162        <arg rep="repeat">--del-user=<replaceable>string</replaceable></arg>
     163        <arg rep="repeat">--incl-user=<replaceable>string</replaceable></arg>
     164        <arg rep="repeat">--excl-user=<replaceable>string</replaceable></arg>
     165        <arg rep="repeat">--del-user-wild=<replaceable>pattern</replaceable></arg>
     166        <arg rep="repeat">--incl-user-wild=<replaceable>pattern</replaceable></arg>
     167        <arg rep="repeat">--excl-user-wild=<replaceable>pattern</replaceable></arg>
     168        <arg>--zap-conditions</arg>
     169        <arg>--min-lease-time=<replaceable>seconds</replaceable></arg>
     170        <arg>--default-lease-time=<replaceable>seconds</replaceable></arg>
     171        <arg>--max-lease-time=<replaceable>seconds</replaceable></arg>
     172        <arg>--remove-config</arg>
     173      </group>
     174      <sbr/>
     175      <group rep="repeat">
    173176        <arg choice="req">--vm=<replaceable>name|uuid</replaceable></arg>
    174         <arg choice="opt">--nic=<replaceable>1-N</replaceable></arg>
    175         <arg choice="opt" rep="repeat">--del-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    176         <arg choice="opt" rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
    177         <arg choice="opt" rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
    178         <arg choice="opt" rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    179         <arg choice="opt" rep="repeat">--unforce-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    180         <arg choice="opt" rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    181         <arg choice="opt" rep="repeat">--unsupress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    182         <arg choice="opt">--min-lease-time=<replaceable>seconds</replaceable></arg>
    183         <arg choice="opt">--default-lease-time=<replaceable>seconds</replaceable></arg>
    184         <arg choice="opt">--max-lease-time=<replaceable>seconds</replaceable></arg>
    185         <arg choice="opt">--fixed-address=<replaceable>address</replaceable></arg>
    186         <arg choice="opt">--remove-config</arg>
    187       </arg>
    188       <sbr/>
    189       <arg choice="opt" rep="repeat">
     177        <arg>--nic=<replaceable>1-N</replaceable></arg>
     178        <arg rep="repeat">--del-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     179        <arg rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
     180        <arg rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
     181        <arg rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     182        <arg rep="repeat">--unforce-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     183        <arg rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     184        <arg rep="repeat">--unsupress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     185        <arg>--min-lease-time=<replaceable>seconds</replaceable></arg>
     186        <arg>--default-lease-time=<replaceable>seconds</replaceable></arg>
     187        <arg>--max-lease-time=<replaceable>seconds</replaceable></arg>
     188        <arg>--fixed-address=<replaceable>address</replaceable></arg>
     189        <arg>--remove-config</arg>
     190      </group>
     191      <sbr/>
     192      <group rep="repeat">
    190193        <arg choice="req">--mac-address=<replaceable>address</replaceable></arg>
    191         <arg choice="opt" rep="repeat">--del-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    192         <arg choice="opt" rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
    193         <arg choice="opt" rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
    194         <arg choice="opt" rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    195         <arg choice="opt" rep="repeat">--unforce-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    196         <arg choice="opt" rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    197         <arg choice="opt" rep="repeat">--unsupress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
    198         <arg choice="opt">--min-lease-time=<replaceable>seconds</replaceable></arg>
    199         <arg choice="opt">--default-lease-time=<replaceable>seconds</replaceable></arg>
    200         <arg choice="opt">--max-lease-time=<replaceable>seconds</replaceable></arg>
    201         <arg choice="opt">--fixed-address=<replaceable>address</replaceable></arg>
    202         <arg choice="opt">--remove-config</arg>
    203       </arg>
     194        <arg rep="repeat">--del-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     195        <arg rep="repeat">--set-opt=<replaceable>dhcp-opt-no value</replaceable></arg>
     196        <arg rep="repeat">--set-opt-hex=<replaceable>dhcp-opt-no hexstring</replaceable></arg>
     197        <arg rep="repeat">--force-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     198        <arg rep="repeat">--unforce-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     199        <arg rep="repeat">--supress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     200        <arg rep="repeat">--unsupress-opt=<replaceable>dhcp-opt-no</replaceable></arg>
     201        <arg>--min-lease-time=<replaceable>seconds</replaceable></arg>
     202        <arg>--default-lease-time=<replaceable>seconds</replaceable></arg>
     203        <arg>--max-lease-time=<replaceable>seconds</replaceable></arg>
     204        <arg>--fixed-address=<replaceable>address</replaceable></arg>
     205        <arg>--remove-config</arg>
     206      </group>
    204207    </cmdsynopsis>
    205208    <cmdsynopsis id="synopsis-vboxmanage-dhcpserver-remove">

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

    r82969 r89917  
    2020<refentry id="vboxmanage-snapshot" lang="en">
    2121  <refentryinfo>
    22     <pubdate>March 2019</pubdate>
     22    <pubdate>$Date$</pubdate>
    2323    <title>VBoxManage snapshot</title>
    2424  </refentryinfo>
    … …  
    104104      <arg choice="plain">list</arg>
    105105
    106       <group choice="opt"><arg choice="opt">--details</arg><arg choice="opt">--machinereadable</arg></group>
     106      <group><arg>--details</arg><arg>--machinereadable</arg></group>
    107107    </cmdsynopsis>
    108108
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