Index: trunk/doc/manual/en_US/user_VBoxManage.xml
===================================================================
--- trunk/doc/manual/en_US/user_VBoxManage.xml	(revision 63680)
+++ trunk/doc/manual/en_US/user_VBoxManage.xml	(revision 63707)
@@ -562,6 +562,7 @@
 
           <listitem>
-            <para><computeroutput>--pciattach &lt;host PCI address [@ guest PCI bus address]&gt;</computeroutput>:
-            Attaches a specified PCI network controller on the host to a PCI bus (can specify) on the guest.
+            <para><computeroutput>--pciattach &lt;host PCI address [@ guest
+            PCI bus address]&gt;</computeroutput>: Attaches a specified PCI network
+            controller on the host to a PCI bus (can specify) on the guest.
             See <xref linkend="pcipassthrough" /> for details. </para>
           </listitem>
@@ -569,6 +570,7 @@
           <listitem>
             <para><computeroutput>--pcidetach &lt;host PCI address&gt;</computeroutput>:
-            Detaches a specified PCI network controller on the host from the attached PCI bus on the guest. 
-            See <xref linkend="pcipassthrough" /> for details. </para>
+            Detaches a specified PCI network controller on the host from the attached
+            PCI bus on the guest. See <xref linkend="pcipassthrough" />
+            for details. </para>
           </listitem>
 
@@ -617,19 +619,17 @@
           <listitem>
             <para><computeroutput>--pae on|off</computeroutput>: This
-            enables/disables PAE (see <xref
-            linkend="settings-processor" />).</para>
+            enables/disables PAE. See <xref linkend="settings-processor" />.</para>
           </listitem>
 
           <listitem>
             <para><computeroutput>--longmode on|off</computeroutput>: This
-            enables/disables long mode (see <xref
-            linkend="settings-processor" />).</para>
+            enables/disables long mode. See <xref linkend="settings-processor" />.</para>
           </listitem>
 
           <listitem>
             <para><computeroutput>--cpu-profile &lt;host|intel 80[86|286|386]&gt;</computeroutput>:
-            Indicate the use of a profile for guest cpu emulation. Specify either one based  
-            on the host system CPU (host), or one from a number of older Intel 
-            Micro-architectures - 8086, 80286, 80386.</para>
+            This enables specification of a profile for guest cpu emulation.
+            Specify either one based on the host system CPU (host), or one from
+            a number of older Intel Micro-architectures - 8086, 80286, 80386.</para>
           </listitem>
 
@@ -644,11 +644,11 @@
             <para><computeroutput>--hwvirtex on|off</computeroutput>: This
             enables or disables the use of hardware virtualization extensions
-            (Intel VT-x or AMD-V) in the processor of your host system; see
-            <xref linkend="hwvirt" />.</para>
+            (Intel VT-x or AMD-V) in the processor of your host system;
+            see <xref linkend="hwvirt" />.</para>
           </listitem>
 
           <listitem>
             <para><computeroutput>--triplefaultreset on|off</computeroutput>:
-            This setting allows to reset the guest instead of triggering a
+            This setting enables resetting of the guest instead of triggering a
             Guru Meditation. Some guests raise a triple fault to reset the
             CPU so sometimes this is desired behavior. Works only for non-SMP
@@ -736,7 +736,7 @@
 
           <listitem>
-            <para><computeroutput>--accelerate3d on|off</computeroutput>: This
-            enables, if the Guest Additions are installed, whether hardware 3D
-            acceleration should be available; see <xref
+            <para><computeroutput>--accelerate3d on|off</computeroutput>: 
+            If the Guest Additions are installed, this setting enables or 
+            disables hardware 3D acceleration; see <xref
             linkend="guestadd-3d" />.</para>
           </listitem>
@@ -744,6 +744,6 @@
           <listitem>
             <para><computeroutput>--accelerate2dvideo on|off</computeroutput>:
-            This enables, if the Guest Additions are installed, whether 2D video
-            acceleration should be available; see <xref
+            If the Guest Additions are installed, this setting enables or 
+            disables 2D video acceleration; see <xref
             linkend="guestadd-2d" />.</para>
           </listitem>
@@ -752,5 +752,5 @@
             <para><computeroutput>--chipset piix3|ich9</computeroutput>:
             By default VirtualBox emulates an Intel PIIX3 chipset. Usually there
-            is no reason to change the default setting unless it is required to
+            is no reason to change the default setting unless this is required to
             relax some of its constraints; see <xref
             linkend="settings-motherboard" />.</para>
@@ -759,5 +759,5 @@
           <listitem>
             <para>You can influence the BIOS logo that is displayed when a
-            virtual machine starts up with a number of settings. Per default,
+            virtual machine starts up with a number of settings. By default,
             a VirtualBox logo is displayed.</para>
 
@@ -795,7 +795,7 @@
 
             <para>Note that if x2apic is specified and x2apic is unsupported by the 
-            VCPU, biosapic downgrades to apic, if supported - otherwise to 'disabled'. 
-            Similarly, if apic is specified, and apic is unsupported results in a 
-            downgrade to 'disabled'.</para>
+            VCPU, biosapic downgrades to apic, if supported - otherwise down to 'disabled'. 
+            Similarly, if apic is specified, and apic is unsupported a 
+            downgrade to 'disabled' results.</para>
           </listitem>
 
@@ -824,25 +824,24 @@
           <listitem>
             <para><computeroutput>--rtcuseutc on|off</computeroutput>: This
-            option lets the real-time clock (RTC) operate in UTC time (see
+            option lets the real-time clock (RTC) operate in UTC time. See
+            <xref linkend="settings-motherboard" />.</para>
+          </listitem>
+
+          <listitem>
+            <para><computeroutput>--graphicscontroller none|vboxvga|vmsvga</computeroutput>: This
+            option specifies use of a graphics controller, and type chosen from vboxvga or vmsvga. 
             <xref linkend="settings-motherboard" />).</para>
           </listitem>
 
           <listitem>
-            <para><computeroutput>--graphicscontroller none|vboxvga|vmsvga</computeroutput>: This
-            option specifies use of a graphics controller, and type chosen from vboxvga or vmsvga.
-            <xref linkend="settings-motherboard" />).</para>
-          </listitem>
-
-          <listitem>
             <para><computeroutput>--snapshotfolder
-            default|&lt;path&gt;</computeroutput>: This allows you to specify
-            the folder in which snapshots will be kept for a virtual
-            machine.</para>
+            default|&lt;path&gt;</computeroutput>: This option specifies the folder in which 
+            snapshots will be kept for a virtual machine.</para>
           </listitem>
 
           <listitem>
             <para><computeroutput>--firmware bios|efi|efi32|efi64</computeroutput>:
-            Specifies which firmware to be used to boot the VM: 
-            Available options are BIOS, or one of the EFI options: efi, efi32 or efi64.
+            This option specifies which firmware to be used to boot the VM: 
+            Available options are: BIOS, or one of the EFI options: efi, efi32 or efi64.
             Use EFI options with care.</para>
           </listitem>
@@ -850,5 +849,5 @@
           <listitem>
             <para><computeroutput>--guestmemoryballoon
-            &lt;size&gt;</computeroutput> sets the default size of the guest
+            &lt;size&gt;</computeroutput> This option sets the default size of the guest
             memory balloon, that is, memory allocated by the VirtualBox Guest
             Additions from the guest operating system and returned to the
@@ -861,7 +860,7 @@
           <listitem>
             <para><computeroutput>--defaultfrontend
-            default|&lt;name&gt;</computeroutput>: This allows you to specify
-            the default frontend which will be used when starting this VM; see
-            <xref linkend="vboxmanage-startvm" /> for details.</para>
+            default|&lt;name&gt;</computeroutput>: This option specifies
+            the default frontend to be used when starting this VM;
+            see <xref linkend="vboxmanage-startvm" /> for details.</para>
           </listitem>
         </itemizedlist></para>
@@ -899,14 +898,14 @@
             <para><computeroutput>--nictype&lt;1-N&gt;
             Am79C970A|Am79C973|82540EM|82543GC|82545EM|virtio</computeroutput>:
-            This allows you, for each of the VM's virtual network cards, to
-            specify which networking hardware VirtualBox presents to the
-            guest; see <xref linkend="nichardware" />.</para>
+            This enables you to specify which networking hardware VirtualBox presents 
+            to the guest for a specified VM virtual network card;
+            see <xref linkend="nichardware" />.</para>
           </listitem>
 
           <listitem>
             <para><computeroutput>--cableconnected&lt;1-N&gt;
-            on|off</computeroutput>: This allows you to temporarily disconnect
+            on|off</computeroutput>: This enables you to temporarily disconnect
             a virtual network interface, as if a network cable had been pulled
-            from a real network card. This might be useful for resetting
+            from a real network card. This might be useful e.g. for resetting
             certain software components in the VM.</para>
           </listitem>
@@ -923,5 +922,5 @@
             <para>If enabled, you must specify with
             <computeroutput>--nictracefile&lt;1-N&gt;
-            &lt;filename&gt;</computeroutput> what file the trace should be
+            &lt;filename&gt;</computeroutput> the absolute path of the file the trace should be
             logged to.</para>
           </listitem>
@@ -933,6 +932,6 @@
             pass parameters to rarely-used network backends.</para>
 
-            <para>Those parameters are backend engine-specific, and are different
-            between UDP Tunnel and the VDE backend drivers. For example,
+            <para>These parameters are backend engine-specific, and are different
+            between UDP Tunnel and the VDE backend drivers. For examples,
             please see <xref linkend="network_udp_tunnel" />.
             </para>
@@ -941,9 +940,9 @@
           <listitem>
             <para><computeroutput>--nicspeed&lt;1-N&gt; &lt;kbps&gt;</computeroutput>:
-            If generic networking has been enabled for a virtual network card (see the
-            <computeroutput>--nic</computeroutput> option above; otherwise
-            this setting has no effect), this mode enables access
-            to rarely used networking sub-modes, such as VDE network or UDP Tunnel.
-            This option specifies the throughput rate in KBytes/sec.
+            If generic networking has been enabled for a particular virtual network 
+            card (see the <computeroutput>--nic</computeroutput> option above - otherwise
+            this setting has no effect), this mode enables access to rarely used networking 
+            sub-modes, such as VDE network or UDP Tunnel. This option specifies the 
+            throughput rate in KBytes/sec.
             </para>
           </listitem>
@@ -964,7 +963,7 @@
             <para><computeroutput>--nicpromisc&lt;1-N&gt;
             deny|allow-vms|allow-all</computeroutput>:
-            This allows you, for each of the VM's virtual network cards, to
-            specify how the promiscuous mode is handled. This setting is only
-            relevant for bridged networking.
+            This ernables you to specify how the promiscuous mode is handled for 
+            the specified VM virtual network card.
+            This setting is only relevant for bridged networking. 
             <computeroutput>deny</computeroutput> (default setting) hides
             any traffic not intended for this VM.
@@ -1025,5 +1024,5 @@
             <computeroutput>natnetwork</computeroutput> (not
             <computeroutput>nat</computeroutput>) then this setting specifies
-            the name of the NAT network this adapter is connected to.</para>
+            the name of the NAT network this adapter is connected to. Optional.</para>
           </listitem>
 
@@ -1034,5 +1033,5 @@
             <computeroutput>--nic</computeroutput> option above; otherwise
             this setting has no effect), this mode allows you to access
-            rarely used networking sub-modes, such as VDE network or UDP Tunnel.
+            rarely used networking sub-modes, such as VDE network or UDP Tunnel. 
             </para>
           </listitem>
@@ -1069,36 +1068,36 @@
               <para><computeroutput>--natpf&lt;1-N&gt;
               [&lt;name&gt;],tcp|udp,[&lt;hostip&gt;],&lt;hostport&gt;,[&lt;guestip&gt;],
-              &lt;guestport&gt;</computeroutput>: This option defines a NAT
-              port-forwarding rule (please see <xref linkend="natforward" />
-              for details).</para>
+              &lt;guestport&gt;</computeroutput>: This setting defines a NAT
+              port-forwarding rule. See <xref linkend="natforward" />
+              for details.</para>
             </listitem>
 
             <listitem>
               <para><computeroutput>--natpf&lt;1-N&gt; delete
-              &lt;name&gt;</computeroutput>: This option deletes a NAT
-              port-forwarding rule (please see <xref linkend="natforward" />
-              for details).</para>
+              &lt;name&gt;</computeroutput>: This setting deletes a NAT
+              port-forwarding rule. See <xref linkend="natforward" />
+              for details.</para>
             </listitem>
 
             <listitem>
               <para><computeroutput>--nattftpprefix&lt;1-N&gt;
-              &lt;prefix&gt;</computeroutput>: This option defines a prefix
+              &lt;prefix&gt;</computeroutput>: This setting defines a prefix
               for the built-in TFTP server, i.e. where the boot file is
-              located (please see <xref linkend="nat-tftp" /> and <xref
-              linkend="nat-adv-tftp" /> for details).</para>
+              located. See <xref linkend="nat-tftp" /> and <xref
+              linkend="nat-adv-tftp" /> for details.</para>
             </listitem>
 
             <listitem>
               <para><computeroutput>--nattftpfile&lt;1-N&gt;
-              &lt;bootfile&gt;</computeroutput>: This option defines the TFT
-              boot file (please see <xref linkend="nat-adv-tftp" /> for
-              details).</para>
+              &lt;bootfile&gt;</computeroutput>: This setting defines the TFT
+              boot file. See <xref linkend="nat-adv-tftp" /> for
+              details.</para>
             </listitem>
 
             <listitem>
               <para><computeroutput>--nattftpserver&lt;1-N&gt;
-              &lt;tftpserver&gt;</computeroutput>: This option defines the
-              TFTP server address to boot from (please see <xref
-              linkend="nat-adv-tftp" /> for details).</para>
+              &lt;tftpserver&gt;</computeroutput>: This setting defines the
+              TFTP server address to boot from. Please see <xref
+              linkend="nat-adv-tftp" /> for details.</para>
             </listitem>
 
@@ -1107,12 +1106,12 @@
               &lt;ip;&gt;</computeroutput>: VirtualBox's NAT engine normally routes 
               TCP/IP packets through the default interface assigned by the host's 
-              TCP/IP stack. Use this option to instruct the NAT engine to bind 
-              to a specified IP address instead. (Please see <xref
-              linkend="nat-adv-settings" /> for details).</para>
+              TCP/IP stack. Use this setting to instruct the NAT engine to bind 
+              to a specified IP address instead. Please see <xref
+              linkend="nat-adv-settings" /> for details.</para>
             </listitem>
 
             <listitem>
               <para><computeroutput>--natdnspassdomain&lt;1-N&gt;
-              on|off</computeroutput>: This option specifies whether the
+              on|off</computeroutput>: This setting specifies whether the
               built-in DHCP server passes the domain name for network name
               resolution.</para>
@@ -1121,14 +1120,14 @@
             <listitem>
               <para><computeroutput>--natdnsproxy&lt;1-N&gt;
-              on|off</computeroutput>: This option makes the NAT engine proxy
-              all guest DNS requests to the host's DNS servers (please see
-              <xref linkend="nat-adv-dns" /> for details).</para>
+              on|off</computeroutput>: This setting makes the NAT engine proxy
+              all guest DNS requests to the host's DNS servers. Please see
+              <xref linkend="nat-adv-dns" /> for details.</para>
             </listitem>
 
             <listitem>
               <para><computeroutput>--natdnshostresolver&lt;1-N&gt;
-              on|off</computeroutput>: This option makes the NAT engine use
-              the host's resolver mechanisms to handle DNS requests (please
-              see <xref linkend="nat-adv-dns" /> for details).</para>
+              on|off</computeroutput>: This setting makes the NAT engine use
+              the host's resolver mechanisms to handle DNS requests. Please
+              see <xref linkend="nat-adv-dns" /> for detailsx).</para>
             </listitem>
 
@@ -1136,7 +1135,7 @@
               <para><computeroutput>--natsettings&lt;1-N&gt;
               [&lt;mtu&gt;],[&lt;socksnd&gt;],[&lt;sockrcv&gt;],[&lt;tcpsnd&gt;],
-              [&lt;tcprcv&gt;]</computeroutput>: This option controls several
-              NAT settings (please see <xref linkend="nat-adv-settings" /> for
-              details).</para>
+              [&lt;tcprcv&gt;]</computeroutput>: This setting controls several
+              NAT settings. Please see <xref linkend="nat-adv-settings" /> for
+              details.</para>
             </listitem>
 
@@ -1144,10 +1143,10 @@
               <para><computeroutput>--nataliasmode&lt;1-N&gt;
               default|[log],[proxyonly],[sameports]</computeroutput>: This
-              option defines behaviour of NAT engine core: log - enables
+              setting defines behaviour of NAT engine core: log - enables
               logging, proxyonly - switches of aliasing mode makes NAT
               transparent, sameports enforces NAT engine to send packets via
               the same port as they originated on, default - disable all
-              mentioned modes above . (please see <xref
-              linkend="nat-adv-alias" /> for details).</para>
+              mentioned modes above. Please see <xref
+              linkend="nat-adv-alias" /> for details.</para>
             </listitem>
           </itemizedlist></para>
@@ -1175,6 +1174,6 @@
         <listitem>
           <para><computeroutput>--uart&lt;1-N&gt; off|&lt;I/O base&gt;
-          &lt;IRQ&gt;</computeroutput>: With this option you can configure
-          virtual serial ports for the VM; see <xref
+          &lt;IRQ&gt;</computeroutput>: With this setting you can configure
+          virtual serial ports for the VM. See <xref
           linkend="serialports" /> for an introduction.</para>
         </listitem>
@@ -1185,8 +1184,8 @@
           connects a given virtual serial port (previously configured with
           the <computeroutput>--uartX</computeroutput> setting, see above)
-          to the host on which the virtual machine is running. As described
-          in detail in <xref linkend="serialports" />, for each such port,
-          you can specify <computeroutput>&lt;arg&gt;</computeroutput> as
-          one of the following options:<itemizedlist>
+          to the host on which the virtual machine is running. As 
+          described in detail in <xref linkend="serialports" />, for each 
+          such port, you can specify <computeroutput>&lt;arg&gt;</computeroutput> 
+          as one of the following options:<itemizedlist>
             <listitem>
               <para><computeroutput>disconnected</computeroutput>: Even
@@ -1268,12 +1267,13 @@
           &lt;I/O base&gt; &lt;IRQ&gt;</computeroutput>:
           Specifies the I/O address of the parallel port and the IRQ
-          number that the Parallel Port feature will be using. Use this <emphasis>after</emphasis>
-          <computeroutput>--lptmod</computeroutput>. I/O base address and IRQ are
-          the values that guest sees i.e. the values avalable under guest Device Manager.</para>
+          number that the Parallel Port feature will be using.  Optional. Use this 
+          <emphasis>after</emphasis> <computeroutput>--lptmod</computeroutput>. 
+          I/O base address and IRQ are the values that guest sees i.e. the values 
+          avalable under guest Device Manager.</para>
         </listitem>
 
         <listitem>
           <para><computeroutput>--audio none|null|oss|alsa|pulse</computeroutput>: With
-          this option, you can set whether the VM should have audio
+          this setting, you can specify whether the VM should have audio
           support, and if so - which type.</para>
         </listitem>
@@ -1281,5 +1281,6 @@
         <listitem>
           <para><computeroutput>--audiocontroller ac97|hda|sb16</computeroutput>: With
-          this option, you can specify the audio controller to be used with this VM.
+          this setting, you can specify the audio controller to be used with this 
+          VM.
           </para>
         </listitem>
@@ -1287,5 +1288,5 @@
         <listitem>
           <para><computeroutput>--audiocodec stac9700|ad1980|stac9221|sb16</computeroutput>: With
-          this option, you can specify the audio codec to be used with this VM.
+          this setting, you can specify the audio codec to be used with this VM.
           </para>
         </listitem>
@@ -1295,6 +1296,6 @@
           disabled|hosttoguest|guesttohost|bidirectional</computeroutput>:
           With this setting, you can select if and how the guest or host
-          operating system's clipboard should be shared with the host or guest;
-          see <xref linkend="generalsettings" />. This requires that the Guest
+          operating system's clipboard should be shared with the host or guest.
+          See <xref linkend="generalsettings" />. This requires that the Guest
           Additions be installed in the virtual machine.</para>
         </listitem>
@@ -1303,7 +1304,7 @@
           <para><computeroutput>--draganddrop
           disabled|hosttoguest|guesttohost|bidirectional</computeroutput>:
-          With this setting, you can select the current drag and drop mode
-          being used between the host and the virtual machine;
-          see <xref linkend="guestadd-dnd" />. This requires that the Guest
+          With this setting, you can specify the current drag and drop mode
+          being used between the host and the virtual machine.
+          See <xref linkend="guestadd-dnd" />. This requires that the Guest
           Additions be installed in the virtual machine.</para>
         </listitem>
@@ -1312,10 +1313,10 @@
           <para><computeroutput>--monitorcount
           &lt;count&gt;</computeroutput>: This enables multi-monitor
-          support; see <xref linkend="settings-display" />.</para>
-        </listitem>
-
-        <listitem>
-          <para><computeroutput>--usb on|off</computeroutput>: This option
-          enables or disables the VM's virtual USB controller; see <xref
+          support. See <xref linkend="settings-display" />.</para>
+        </listitem>
+
+        <listitem>
+          <para><computeroutput>--usb on|off</computeroutput>: This setting
+          enables or disables the VM's virtual USB controller. See <xref
           linkend="settings-usb" /> for details.</para>
         </listitem>
@@ -1323,12 +1324,12 @@
         <listitem>
           <para><computeroutput>--usbehci on|off</computeroutput>: This
-          option enables or disables the VM's virtual USB 2.0 controller;
-          see <xref linkend="settings-usb" /> for details.</para>
+          setting enables or disables the VM's virtual USB 2.0 controller.
+          See <xref linkend="settings-usb" /> for details.</para>
         </listitem>
 
         <listitem>
           <para><computeroutput>--usbxhci on|off</computeroutput>: This
-          option enables or disables the VM's virtual USB 3.0 controller;
-          see <xref linkend="settings-usb" /> for details.</para>
+          setting enables or disables the VM's virtual USB 3.0 controller.
+          See <xref linkend="settings-usb" /> for details.</para>
         </listitem>
 
@@ -1336,5 +1337,5 @@
           <para><computeroutput>--usbrename 
           &lt;oldname&gt; &lt;newname&gt;</computeroutput>: This
-          option enables renaming of the VM's virtual USB controller from &lt;oldname&gt; 
+          setting enables renaming of the VM's virtual USB controller from &lt;oldname&gt; 
           to &lt;newname&gt;.</para>
         </listitem>
@@ -1570,5 +1571,5 @@
           <listitem>
             <para><computeroutput>--vrdeextpack default|&lt;name&gt;</computeroutput>:
-            Allows to specify the library to use for to access the VM
+            Enables specification of the library for accessing the VM
             remotely. The default is to use the RDP code which is part of the
             Oracle VM VirtualBox Extension Pack.</para>
@@ -1582,5 +1583,5 @@
             ports or ranges of ports. Use a dash between two port numbers to
             specify a range. The VRDE server will bind to <emphasis
-            role="bold">one</emphasis> of available ports from the specified
+            role="bold">one</emphasis> of the available ports from the specified
             list. Only one machine can use a given port at a time. For
             example, the option <computeroutput> --vrdeport
@@ -1596,5 +1597,5 @@
             interface.</para>
             <para>The setting can be used to specify whether the VRDP server
-            should accept either IPv4 or IPv6 or both connections:
+            should accept either IPv4, IPv6 or both connections:
             <itemizedlist>
               <listitem>
@@ -1615,12 +1616,12 @@
           <listitem>
             <para><computeroutput>--vrdeauthtype
-            null|external|guest</computeroutput>: This allows you to choose
-            whether and how authorization will be performed; see <xref
-            linkend="vbox-auth" /> for details.</para>
+            null|external|guest</computeroutput>: This enables you to indicate 
+            use of authorization, and specify how authorization will be performed; 
+            see <xref linkend="vbox-auth" /> for details.</para>
           </listitem>
 
           <listitem>
             <para><computeroutput>--vrdeauthlibrary
-            default|&lt;name&gt;</computeroutput>: This allos to set the
+            default|&lt;name&gt;</computeroutput>: This specifies the
             library used for RDP authentication, see <xref lang=""
             linkend="vbox-auth" /> for details.</para>
@@ -1629,5 +1630,5 @@
           <listitem>
             <para><computeroutput>--vrdemulticon on|off</computeroutput>: This
-            enables multiple connections to the same VRDE server, if the
+            enables multiple connections to be made to the same VRDE server, if the
             server supports this feature; see <xref lang=""
             linkend="vrde-multiconnection" />.</para>
@@ -1652,5 +1653,5 @@
           <listitem>
             <para><computeroutput>--vrdevideochannelquality
-            &lt;percent&gt;</computeroutput>: Sets the image quality for video
+            &lt;percent&gt;</computeroutput>: Specifies the image quality for video
             redirection; see <xref lang=""
             linkend="vrde-videochannel" />.</para>
@@ -1667,11 +1668,9 @@
       introduction.<itemizedlist>
           <listitem>
-            <para><computeroutput>--teleporter on|off</computeroutput>: With
-            this setting you turn on or off whether a machine waits for a
-            teleporting request to come in on the network when it is started.
-            If "on", when the machine is started, it does not boot the virtual
-            machine as it would normally; instead, it then waits for a
-            teleporting request to come in on the port and address listed with
-            the next two parameters.</para>
+            <para><computeroutput>--teleporter on|off</computeroutput>: 
+            This setting enables/disables the teleporter feature whereby when the 
+            machine is started, it waits to receieve a teleporting request from the 
+            network instead of booting normally; teleporting requests are received on the 
+            port and address specified using the following two parameters.</para>
           </listitem>
 
@@ -1679,8 +1678,8 @@
             <para><computeroutput>--teleporterport
             &lt;port&gt;</computeroutput>, <computeroutput>--teleporteraddress
-            &lt;address&gt;</computeroutput>: these must be used with
-            --teleporter and tell the virtual machine on which port and
-            address it should listen for a teleporting request from another
-            virtual machine. <computeroutput>&lt;port&gt;</computeroutput> can
+            &lt;address&gt;</computeroutput>: these settings must be used with
+            --teleporter and they specify the port and address the virtual machine should 
+            listen to to receive a teleporting request sent from another virtual machine. 
+            <computeroutput>&lt;port&gt;</computeroutput> can
             be any free TCP/IP port number (e.g. 6000);
             <computeroutput>&lt;address&gt;</computeroutput> can be any IP
@@ -1691,5 +1690,5 @@
           <listitem>
             <para><computeroutput>--teleporterpassword
-            &lt;password&gt;</computeroutput>: if this optional argument is
+            &lt;password&gt;</computeroutput>: if this optional setting is
             given, then the teleporting request will only succeed if the
             source machine specifies the same password as the one given with
@@ -1699,5 +1698,5 @@
           <listitem>
             <para><computeroutput>--teleporterpasswordfile
-            &lt;password&gt;</computeroutput>: if this optional argument is
+            &lt;password&gt;</computeroutput>: if this optional setting is
             given, then the teleporting request will only succeed if the
             source machine specifies the same password as the one specified
@@ -1709,5 +1708,5 @@
             <para><computeroutput>--cpuid &lt;leaf&gt; &lt;eax&gt; &lt;ebx&gt;
             &lt;ecx&gt; &lt;edx&gt;</computeroutput>: Advanced users can use
-            this command before a teleporting operation to restrict the
+            this setting  before a teleporting operation to restrict the
             virtual CPU capabilities that VirtualBox presents to the guest
             operating system. This must be run on both the source and the
@@ -1735,5 +1734,5 @@
           <listitem>
             <para><computeroutput>--tracing-config &lt;config-string&gt;</computeroutput>:
-            Allows to configure tracing. In particular this defines which group of
+            Enables tracing configuration. In particular, this defines which group of
             tracepoints are enabled.</para>
           </listitem>
@@ -1812,7 +1811,7 @@
            Allows additional fine tuning of the clone operation. The first
            option defines that a linked clone should be created, which is
-           only possible for a machine clone from a snapshot. The next two
-           options allow to define how the MAC addresses of every virtual
-           network card should be handled. They can either be reinitialized
+           only possible for a machine cloned from a snapshot. The next two
+           options enable specification of the handling of MAC addresses of 
+           every virtual network card. They can either be reinitialized
            (the default), left unchanged
            (<computeroutput>keepallmacs</computeroutput>) or left unchanged
@@ -2158,7 +2157,8 @@
       <listitem>
         <para><computeroutput>nic&lt;1-N&gt;
-        null|nat|bridged|intnet|hostonly|generic|natnetwork[&lt;devicename&gt;]</computeroutput>: With this, you can
-        set, for each of the VM's virtual network cards, what type of
-        networking should be available. They can be not connected to the host
+        null|nat|bridged|intnet|hostonly|generic|natnetwork[&lt;devicename&gt;]</computeroutput>: 
+        specifies the type of networking that should be made available on the specified VM 
+        virtual network card. 
+        They can be: not connected to the host
         (<computeroutput>null</computeroutput>), use network address
         translation (<computeroutput>nat</computeroutput>), bridged networking
@@ -2175,16 +2175,15 @@
 
       <listitem>
-        <para>With the "nictrace" options, you can optionally trace
-        network traffic by dumping it to a file, for debugging
-        purposes.</para>
+        <para>With the "nictrace" options, you can optionally trace network traffic by dumping 
+        it to a file, for debugging purposes.</para>
 
         <para>With <computeroutput>nictrace&lt;1-N&gt;
-        on|off</computeroutput>, you can enable network tracing for a
-        particular virtual network card.</para>
+        on|off</computeroutput>, you can enable network tracing for a particular virtual 
+        network card.</para>
 
         <para>If enabled, you must specify with
         <computeroutput>--nictracefile&lt;1-N&gt;
-        &lt;filename&gt;</computeroutput> what file the trace should be
-        logged to.</para>
+        &lt;filename&gt;</computeroutput> the pathname of the file to which the trace should be
+        logged.</para>
       </listitem>
 
@@ -2192,7 +2191,6 @@
         <para><computeroutput>nicpromisc&lt;1-N&gt;
         deny|allow-vms|allow-all</computeroutput>:
-        This allows you, for each of the VM's virtual network cards, to
-        specify how the promiscious mode is handled. This setting is only
-        relevant for bridged networking.
+        This specifies how the promiscious mode is handled for the specified VM 
+        virtual network card. This setting is only relevant for bridged networking.
         <computeroutput>deny</computeroutput> (default setting) hides
         any traffic not intended for this VM.
@@ -2207,5 +2205,5 @@
         <para><computeroutput>nicproperty&lt;1-N&gt;
         &lt;paramname&gt;="paramvalue"</computeroutput>:
-        This option, in combination with "nicgenericdrv" allows you to
+        This option, in combination with "nicgenericdrv" enables you to
         pass parameters to rarely-used network backends.</para><para>
         Those parameters are backend engine-specific, and are different
@@ -2218,5 +2216,5 @@
         <para><computeroutput>natpf&lt;1-N&gt;
         [&lt;name&gt;],tcp|udp,[&lt;hostip&gt;],&lt;hostport&gt;,[&lt;guestip&gt;],
-        &lt;guestport&gt;</computeroutput>: This option defines a NAT
+        &lt;guestport&gt;</computeroutput>: This option specifies a NAT
         port-forwarding rule (please see <xref linkend="natforward"/>
         for details).
@@ -2286,10 +2284,10 @@
       <listitem>
         <para><computeroutput>vrdeproperty "TCP/Ports|Address=&lt;value&gt;"</computeroutput>
-        sets the port number(s) and IP address on the VM that the VRDE server can bind to.</para>
+        sets the port number(s) and IP address on the VM to which the VRDE server can bind.</para>
 
         <itemizedlist>
           <listitem>
-            <para>For TCP/Ports, &lt;value&gt; should be a port or a range of ports that the VRDE 
-            server can bind to; "default" or "0" means port 3389, the standard port for RDP. 
+            <para>For TCP/Ports, &lt;value&gt; should be a port or a range of ports to which 
+            the VRDE server can bind; "default" or "0" means port 3389, the standard port for RDP. 
             For details, see the description for the
             <computeroutput>--vrdeport</computeroutput> option in <xref
@@ -2324,8 +2322,9 @@
 
           <listitem>
-            <para>For VideoChannel/DownscaleProtection, &lt;value&gt; can be set to "1" to 
-            enable the videochannel downscale protection feature. When enabled, if a video's size equals the shadow buffer 
-            size, then it is regarded as a full screen video, and is displayed; but if its size is between fullscreen and the downscale
-            threshold - it is NOT displayed, as it could be an application window, which would be unreadable when downscaled.
+            <para>For VideoChannel/DownscaleProtection, &lt;value&gt; can be set to "1" to enable the 
+            videochannel downscale protection feature. When enabled, if a video's size equals the shadow 
+            buffer size, then it is regarded as a full screen video, and is displayed; but if its size 
+            is between fullscreen and the downscale threshold - it is NOT displayed, as it could be an 
+            application window, which would be unreadable when downscaled.
             When the downscale protection feature is disabled, an attempt is always made to display videos.</para>
           </listitem>
@@ -2414,5 +2413,6 @@
             <itemizedlist>
               <listitem>
-                <para> <computeroutput>VRDP_AUDIO_MODE_VOID</computeroutput> - no mode specified, use to unset any Audio mode already set.</para>
+                <para> <computeroutput>VRDP_AUDIO_MODE_VOID</computeroutput> - no mode specified, use to 
+                unset any Audio mode already set.</para>
               </listitem>
               <listitem>
@@ -2423,5 +2423,6 @@
               </listitem>
               <listitem>
-                <para> <computeroutput>VRDP_AUDIO_MODE_CS</computeroutput> - client sync mode to prevent under/overflow of the client queue.</para>
+                <para> <computeroutput>VRDP_AUDIO_MODE_CS</computeroutput> - client sync mode to prevent 
+                under/overflow of the client queue.</para>
               </listitem>
             </itemizedlist></para>
@@ -2528,12 +2529,12 @@
         can be used to configure a VM as a target for teleporting. 
         &lt;name&gt; specifies the virtual machine name. &lt;port&gt; specifies the port on the 
-        virtual machine which should listen for a teleporting request from another
-        virtual machine. It can be any free TCP/IP port number (e.g. 6000);
+        virtual machine which should listen for teleporting requests from other
+        virtual machines. It can be any free TCP/IP port number (e.g. 6000);
         See <xref linkend="teleporting" /> for an introduction.</para>
         <itemizedlist>
           <listitem>
             <para><computeroutput>--maxdowntime &lt;msec&gt;</computeroutput>:
-            Optional - specifies the maximum downtime (milliseconds) for the 
-            teleporting target VM.</para>
+            specifies the maximum downtime (milliseconds) for the 
+            teleporting target VM. Optional.</para>
           </listitem>
 
@@ -2541,7 +2542,7 @@
             <para><computeroutput>--password
             &lt;password&gt;</computeroutput>: 
-            Optional - indicates that the teleporting request will only succeed if the
+            indicates that the teleporting request will only succeed if the
             source machine specifies the same password as the one given with
-            this command.</para>
+            this command. Optional.</para>
           </listitem>
 
@@ -2549,8 +2550,9 @@
             <para><computeroutput>--passwordfile
             &lt;password file&gt;</computeroutput>: 
-            Optional - indicates that the teleporting request will only succeed if the
+            indicates that the teleporting request will only succeed if the
             source machine specifies the same password as the one specified
-            in the file given with this command. Use <computeroutput>stdin</computeroutput>
-            to read the password from stdin.</para>
+            in the password file with the path specified with this command. 
+            Use <computeroutput>stdin</computeroutput> to read the password 
+            from stdin. Optional.</para>
           </listitem>
         </itemizedlist>
@@ -3022,5 +3024,5 @@
               <listitem>
                 <para>VirtualBox will only trim whole 1MB blocks. The VDIs themselves are organized 
-                into 1MB blocks, so this will only work if the space being TRIM-med is at least 
+                into 1MB blocks, so this will only work if the space being TRIM-ed is at least 
                 a 1MB contiguous block at a 1MB boundary. On Windows, occasional defrag (with "defrag.exe /D"),
                 or under Linux running "btrfs filesystem defrag" as a background cron job may be
@@ -3090,6 +3092,6 @@
 
           <glossdef>
-            <para>TCP/IP port number of the iSCSI service on the target
-            (optional).</para>
+            <para>TCP/IP port number of the iSCSI service on the target.
+            Optional.</para>
           </glossdef>
         </glossentry>
@@ -3099,5 +3101,5 @@
 
           <glossdef>
-            <para>Logical Unit Number of the target resource (optional).
+            <para>Logical Unit Number of the target resource. Optional.
             Often, this value is zero.</para>
           </glossdef>
@@ -3108,5 +3110,5 @@
 
           <glossdef>
-            <para>Hex encoded Logical Unit Number of the target resource (optional).
+            <para>Hex encoded Logical Unit Number of the target resource. Optional.
             Often, this value is zero.</para>
           </glossdef>
@@ -3118,5 +3120,5 @@
           <glossdef>
             <para>Username and password (initiator secret) for target
-                authentication, if required (optional).<note>
+                authentication, if required. Optional.<note>
                 <para>Username and password are stored without
                 encryption (i.e. in clear text) in the XML machine
@@ -3142,5 +3144,5 @@
 
             <para>A gigabit Ethernet adapter that transmits 1000 megabits per second (Mbps) is recommended for the connection to an iSCSI target. Like 
-            standard 10/100 adapters, most gigabit adapters use a preexisting Category 5 or Category 6E cable that. Each port on the adapter is 
+            standard 10/100 adapters, most gigabit adapters use a pre-existing Category 5 or Category 6E cable. Each port on the adapter is 
             identified by a unique IP address.</para>
 
@@ -3197,5 +3199,5 @@
 
           <glossdef>
-            <para>Name of the storage controller. Mandatory.</para>
+            <para>Specifies the name of the storage controller. Mandatory.</para>
           </glossdef>
         </glossentry>
@@ -3205,5 +3207,5 @@
 
           <glossdef>
-            <para>Define the type of the system bus to which the storage
+            <para>Specifies the type of the system bus to which the storage
             controller must be connected.</para>
           </glossdef>
@@ -3214,5 +3216,5 @@
 
           <glossdef>
-            <para>Allows to choose the type of chipset being emulated for the
+            <para>Enables a choice of chipset type being emulated for the
             given storage controller.</para>
           </glossdef>
@@ -3223,5 +3225,5 @@
 
           <glossdef>
-            <para>This determines how many ports the storage controller should
+            <para>This specifies the number of ports the storage controller should
             support.</para>
           </glossdef>
@@ -3242,5 +3244,5 @@
 
           <glossdef>
-            <para>Selects whether this controller is bootable.</para>
+            <para>Specifies whether this controller is bootable.</para>
           </glossdef>
         </glossentry>
@@ -3250,5 +3252,5 @@
 
           <glossdef>
-            <para>Sets the name of the storage controller.</para>
+            <para>Specifies a new name for the storage controller.</para>
           </glossdef>
         </glossentry>
@@ -3278,5 +3280,5 @@
       <listitem>
         <para><computeroutput>add</computeroutput>, creates a new bandwidth
-        group of given type.</para>
+        group of a given type.</para>
       </listitem>
       <listitem>
@@ -3286,9 +3288,9 @@
       <listitem>
         <para><computeroutput>remove</computeroutput>, destroys a bandwidth
-          group.</para>
+        group.</para>
       </listitem>
       <listitem>
         <para><computeroutput>list</computeroutput>, shows all bandwidth groups
-        defined for the given VM. Use <computeroutput>--machinereadable</computeroutput> 
+        defined for the given VM. Use the <computeroutput>--machinereadable</computeroutput> 
         option to produce the same output, but in machine readable format. This is of the 
         form: name="value" on a line by line basis.</para>
@@ -3321,5 +3323,5 @@
             <computeroutput>network</computeroutput>. See
             <xref linkend="storage-bandwidth-limit" /> or
-            <xref linkend="network_bandwidth_limit" /> for a description of a
+            <xref linkend="network_bandwidth_limit" /> for the description of a
             particular type.</para>
           </glossdef>
@@ -3330,5 +3332,5 @@
 
           <glossdef>
-            <para>Specifies the limit for the given group. Can be changed
+            <para>Specifies the limit for the given bandwidth group. This can be changed
             while the VM is running. The default unit is megabytes per
             second. The unit can be changed by specifying one of the
@@ -3348,5 +3350,5 @@
       <note>
         <para>To remove a bandwidth group it must not be referenced by any disks
-        or adapters in running VM.</para>
+        or adapters in the running VM.</para>
       </note>
     </para>
@@ -3375,6 +3377,6 @@
   </sect1>
 
-  <sect1 id="vboxmanage-createvdi">
-    <title>VBoxManage createhd</title>
+  <sect1 id="vboxmanage-createmedium">
+    <title>VBoxManage createmedium</title>
 
     <para>This command creates a new medium. The syntax is as follows:</para>
@@ -3392,5 +3394,5 @@
           <glossdef>
             <para>Specifies a file name &lt;filename&gt; as an absolute path on the host file
-            system.. Mandatory.</para>
+            system. Mandatory.</para>
           </glossdef>
         </glossentry>
@@ -3428,14 +3430,12 @@
 
           <glossdef>
-            <para>Specifies any required file format variant(s) for the output file.
-            It is a comma-separated list of variant flags. Not all
-            combinations are supported, and specifying mutually incompatible 
-            flags results in an error message. Optional.</para>
+            <para>Specifies any required file format variant(s) for the output file.  It is a 
+            comma-separated list of variant flags. Not all combinations are supported, and specifying 
+            mutually incompatible flags results in an error message. Optional.</para>
           </glossdef>
         </glossentry>
       </glosslist> <note>
-        <para>For compatibility with earlier versions of VirtualBox, the
-        "createvdi" command is also supported and mapped internally to the
-        "createmedium" command.</para>
+        <para>For compatibility with earlier versions of VirtualBox, the "createvdi"  and "createhd" commands 
+        are also supported and mapped internally to the "createmedium" command.</para>
       </note></para>
   </sect1>
@@ -3481,5 +3481,5 @@
 
         <listitem>
-          <para>The <computeroutput>--compact</computeroutput> option,
+          <para>The <computeroutput>--compact</computeroutput> option
           can be used to compact disk images, i.e. remove blocks that only
           contains zeroes. This will shrink a dynamically allocated image
@@ -4109,5 +4109,4 @@
 </screen>
 
-
     <para>This command allows you to share folders on the host computer with
     guest operating systems. For this, the guest systems must have a version
@@ -4197,6 +4196,5 @@
 
 
-    <para>Shared folders are described in detail in <xref
-    linkend="sharedfolders" />.</para>
+    <para>Shared folders are described in detail in <xref linkend="sharedfolders" />.</para>
   </sect1>
 
