Changeset 54630 in vbox

Timestamp:

Mar 4, 2015 4:39:46 PM (10 years ago)

Author:

vboxsync

Message:

doc/manual: wording

Location:

trunk/doc/manual/en_US

Files:

• user_BasicConcepts.xml (modified) (1 diff)
• user_Introduction.xml (modified) (4 diffs)
• user_Storage.xml (modified) (1 diff)

trunk/doc/manual/en_US/user_BasicConcepts.xml

@@ -1233 +1233 @@
         </note></para>
 
-      <para>When USB support is enabled for a VM, you can determine in
-      detail which devices are exists on host. You can choose that devices 
-      can be available on guest sytem. To do that you should add "filters" for
-      chosen devices. In result these devices will disappear in host system and 
-      will appear in guest system.</para>
+      <para>When USB support is enabled for a VM, you can determine in detail
+      which devices will be automatically attached to the guest. For this, you
+      can create so-called "filters" by specifying certain properties of
+      the USB device. USB devices with a matching filter will be automatically
+      passed to the guest once they are attached to the host. USB devices
+      without a matching filter can be passed manually to the guest, for
+      example by using the Devices / USB devices menu.</para>
 
       <para>Clicking on the "+" button to the right of the "USB Device

trunk/doc/manual/en_US/user_Introduction.xml

@@ -816 +816 @@
           applications you want to install -- for a modern Windows or Linux
           guest, you will probably need several gigabytes for any serious
-          use. The limit of image file size can be changed later (see <xref
+          use. The limit of the image file size can be changed later (see <xref
           linkend="vboxmanage-modifyvdi"/> for details).</para>
 
@@ -1277 +1277 @@
         <listitem>
           <para>
-            Command line option 1) Create group and assign VM:
+            Command line option 1) Create a group and assign a VM:
             <screen>VBoxManage modifyvm "Fred" --groups "/TestGroup"</screen>
-            creates group "TestGroup" and attaches VM "Fred" to that group
+            creates a group "TestGroup" and attaches the VM "Fred" to that group.
           </para>
           <para>
-            Command line option 2) Detach VM from group, and delete group if
-            empty: <screen>VBoxManage modifyvm "Fred" --groups ""</screen>
-            It detaches all groups from VM "Fred" and deletes empty groups
+            Command line option 2) Detach a VM from the group, and delete the group
+            if empty: <screen>VBoxManage modifyvm "Fred" --groups ""</screen>
+            It detaches all groups from the VM "Fred" and deletes the empty group.
           </para>
         </listitem>
@@ -1291 +1291 @@
             Multiple groups e.g.:
             <screen>VBoxManage modifyvm "Fred" --groups "/TestGroup,/TestGroup2"</screen>
-            It creates groups "TestGroup" and "TestGroup2" (if they are not exist)
-            and attaches VM "Fred" to both of them
+            It creates the groups "TestGroup" and "TestGroup2" (if they don't exist yet)
+            and attaches the VM "Fred" to both of them.
           </para>
         </listitem>
@@ -1299 +1299 @@
             Nested groups -- hierarchy of groups e.g.:
             <screen>VBoxManage modifyvm "Fred" --groups "/TestGroup/TestGroup2"</screen>
-            It attaches VM "Fred" to  subgroup "TestGroup2" of "TestGroup"
-            group
+            It attaches the VM "Fred" to the subgroup "TestGroup2" of the "TestGroup"
+            group.
           </para>
         </listitem>

trunk/doc/manual/en_US/user_Storage.xml

@@ -527 +527 @@
         "immutable" image except the differencing image is not reset every
         time the machine starts.</para>
-        <para>This mode could be useful, for example, to share virtual disk 
-        with source code. The every user changes only small number of files 
-        and all other files can be unchanged. The files modified by user 
-        stored in differencing images that reletively small. It saves a 
-        disk space.</para>
+      <para>This mode is useful for sharing files which are almost never
+        written, for instance picture galleries, where every guest changes
+        only a small amount of data and the majority of the disk content
+        remains unchanged. The modified blocks are stored in differencing
+        images which remain reletively small and the shared content is stored
+        only once at the host.</para>
       </listitem>