Changeset 37651 in vbox

Timestamp:

Jun 27, 2011 1:24:17 PM (14 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

72502

Message:

docs: clarify the conditions under which resizing works, and also provide an example which makes it obvious that one has to specify the new size, not the increment.

File:

• trunk/doc/manual/en_US/user_VBoxManage.xml (modified) (1 diff)

trunk/doc/manual/en_US/user_VBoxManage.xml

@@ -2057 +2057 @@
 
         <listitem>
-          <para>The --resize option allows you to expand the capacity of an
-          existing image; this increases the <emphasis>logical</emphasis> size
-          of a virtual disk without affecting the physical size much.<footnote>
+          <para>The <computeroutput>--resize</computeroutput> option allows you
+          to change the capacity of an existing image; this adjusts the
+          <emphasis>logical</emphasis> size of a virtual disk without affecting
+          the physical size much.<footnote>
               <para>Image resizing was added with VirtualBox 4.0.</para>
-            </footnote> This currently works only for the VDI and VHD formats,
-          and only for the dynamically expanding variants. For example, if you
-          originally created a 10G disk which is now full, you can use the
-          --resize command to add more space to the virtual disk without
+            </footnote> This currently works only for expanding the capacity of
+          VDI and VHD formats, and only for the dynamically expanding variants.
+          For example, if you originally created a 10G disk which is now full,
+          you can use the <computeroutput>--resize 15360</computeroutput>
+          command to add 5 GByte more space to the virtual disk without
           having to create a new image and copy all data from within a virtual
           machine.</para>