Changeset 77888 in vbox for trunk/doc/manual/en_US

Timestamp:

Mar 26, 2019 4:57:34 PM (6 years ago)

Author:

vboxsync

Message:

man_VBoxManage-clonevm.xml: Checked how --options actually work and adjusted the synopsis+text accordingly.

File:

• trunk/doc/manual/en_US/man_VBoxManage-clonevm.xml (modified) (9 diffs)

trunk/doc/manual/en_US/man_VBoxManage-clonevm.xml

@@ -43 +43 @@
       <arg>--basefolder=<replaceable>basefolder</replaceable></arg>
 
-      <arg>--group=<replaceable>group</replaceable>, ...</arg>
+      <arg rep="repeat">--group=<replaceable>group</replaceable>,</arg>
 
       <arg>--mode=<group choice='plain'><arg choice='plain'>machine</arg><arg choice='plain'>machinechildren</arg><arg choice='plain'>all</arg></group></arg>
@@ -49 +49 @@
       <arg>--name=<replaceable>name</replaceable></arg>
 
-      <arg>--options=<group choice='plain'><arg choice='plain'>link</arg><arg choice='plain'>keepallmacs</arg><arg choice='plain'>keepnatmacs</arg><arg choice='plain'>keepdisknames</arg><arg choice='plain'>keephwuuids</arg></group></arg>
+      <arg rep="repeat">--options=<replaceable>option</replaceable>,</arg>
 
       <arg>--register</arg>
@@ -93 +93 @@
       </varlistentry>
       <varlistentry>
-        <term><option>--groups=<replaceable>group</replaceable>, ...</option></term>
+        <term><option>--groups=<replaceable>group</replaceable>,...</option></term>
         <listitem><para>
             Assigns the clone to the specified group or groups. If you
@@ -139 +139 @@
       </varlistentry>
       <varlistentry>
-        <term><option>--options=option</option></term>
-        <listitem><para>
-            Specifies how to create a new clone.
-          </para><variablelist>
-            <varlistentry>
-              <term><option>--options=link</option></term>
+        <term><option>--options=<replaceable>option</replaceable>,...</option></term>
+        <listitem><para>
+            Specifies how to create the new clone.</para>
+          <para>The <option>--options</option> argument can be used multiple
+            times to enable multiple options, or the options can be given as a
+            comma separated list.  The options are case insensitive.</para>
+          <para>The following options (case-insensitive) are recognized:</para>
+          <variablelist>
+            <varlistentry>
+              <term><option>Link</option></term>
               <listitem><para>
                   Creates a linked clone from a snapshot only.
@@ -150 +154 @@
             </varlistentry>
             <varlistentry>
-              <term><option>--options=keepallmacs</option></term>
+              <term><option>KeepAllMACs</option></term>
               <listitem><para>
                   Specifies that the new clone reuses the MAC addresses
@@ -162 +166 @@
             </varlistentry>
             <varlistentry>
-              <term><option>--options=keepnatmacs</option></term>
+              <term><option>KeepNATMACs</option></term>
               <listitem><para>
                   Specifies that the new clone reuses the MAC addresses
@@ -169 +173 @@
                 </para><para>
                   If you do not specify this option or the
-                  <option>--options=keepallmacs</option> option, the
+                  <option>KeepAllMACs</option> option, the
                   default behavior is to reinitialize the MAC addresses
                   of each virtual network card.
@@ -175 +179 @@
             </varlistentry>
             <varlistentry>
-              <term><option>--option=keepdisknames</option></term>
+              <term><option>KeepDiskNames</option></term>
               <listitem><para>
                   Specifies that the new clone reuses the disk image
@@ -183 +187 @@
             </varlistentry>
             <varlistentry>
-              <term><option>--option=keephwuuids</option></term>
+              <term><option>KeepHwUUIDs</option></term>
               <listitem><para>
                   Specifies that the new clone reuses the hardware IDs