Changeset 82350 in vbox for trunk/doc/manual/en_US/user_GuestAdditions.xml

Timestamp:

Dec 3, 2019 6:44:23 PM (5 years ago)

Author:

vboxsync

Message:

manual: integrate 6.1 drop #10 with minimal manual adjustments (frontmatter for preface and eliminated trailing whitespace)

File:

• trunk/doc/manual/en_US/user_GuestAdditions.xml (modified) (60 diffs)

trunk/doc/manual/en_US/user_GuestAdditions.xml

@@ -36 +36 @@
       The &product-name; Guest Additions for all supported guest
       operating systems are provided as a single CD-ROM image file which
-      is called <computeroutput>VBoxGuestAdditions.iso</computeroutput>.
-      This image file is located in the installation directory of
-      &product-name;. To install the Guest Additions for a particular
-      VM, you mount this ISO file in your VM as a virtual CD-ROM and
-      install from there.
+      is called <filename>VBoxGuestAdditions.iso</filename>. This image
+      file is located in the installation directory of &product-name;.
+      To install the Guest Additions for a particular VM, you mount this
+      ISO file in your VM as a virtual CD-ROM and install from there.
     </para>
 
@@ -56 +55 @@
           you with seamless mouse support. You will only have one mouse
           pointer and pressing the Host key is no longer required to
-          "free" the mouse from being captured by the guest OS. To make
-          this work, a special mouse driver is installed in the guest
-          that communicates with the "real" mouse driver on your host
-          and moves the guest mouse pointer accordingly.
+          <emphasis>free</emphasis> the mouse from being captured by the
+          guest OS. To make this work, a special mouse driver is
+          installed in the guest that communicates with the physical
+          mouse driver on your host and moves the guest mouse pointer
+          accordingly.
         </para>
       </listitem>
@@ -71 +71 @@
           folder, and &product-name; will make it available to the guest
           operating system as a network share, irrespective of whether
-          guest actually has a network. See
-          <xref
-            linkend="sharedfolders" />.
+          the guest actually has a network. See
+          <xref linkend="sharedfolders" />.
         </para>
       </listitem>
@@ -118 +117 @@
           <emphasis role="bold">Generic host/guest communication
           channels.</emphasis> The Guest Additions enable you to control
-          and monitor guest execution. The "guest properties" provide a
-          generic string-based mechanism to exchange data bits between a
-          guest and a host, some of which have special meanings for
-          controlling and monitoring the guest. See
-          <xref linkend="guestadd-guestprops" />.
+          and monitor guest execution. The <emphasis>guest
+          properties</emphasis> provide a generic string-based mechanism
+          to exchange data bits between a guest and a host, some of
+          which have special meanings for controlling and monitoring the
+          guest. See <xref linkend="guestadd-guestprops" />.
         </para>
 
@@ -148 +147 @@
           differs slightly, the time synchronization service attempts to
           gradually and smoothly adjust the guest time in small
-          increments to either "catch up" or "lose" time. When the
+          increments to either catch up or lose time. When the
           difference is too great, for example if a VM paused for hours
           or restored from saved state, the guest time is changed
@@ -199 +198 @@
       To disable this update check for the Guest Additions of a given
       virtual machine, set the value of its
-      <computeroutput>/VirtualBox/GuestAdd/CheckHostVersion</computeroutput>
-      guest property to <computeroutput>0</computeroutput>. See
+      <literal>/VirtualBox/GuestAdd/CheckHostVersion</literal> guest
+      property to <literal>0</literal>. See
       <xref
     linkend="guestadd-guestprops" />.
@@ -343 +342 @@
           <listitem>
             <para>
-              Select <emphasis role="bold">Mount CD/DVD-ROM</emphasis>
+              Select <emphasis role="bold">Optical Drives</emphasis>
               from the <emphasis role="bold">Devices</emphasis> menu in
               the virtual machine's menu bar and then
-              <emphasis role="bold">CD/DVD-ROM Image</emphasis>. This
-              displays the Virtual Media Manager, described in
-              <xref
-            linkend="vdis" />.
+              <emphasis role="bold">Choose/Create a Disk
+              Image</emphasis>. This displays the Virtual Media Manager,
+              described in <xref linkend="vdis" />.
             </para>
           </listitem>
@@ -358 +356 @@
               <emphasis role="bold">Add</emphasis> and browse your host
               file system for the
-              <computeroutput>VBoxGuestAdditions.iso</computeroutput>
-              file.
+              <filename>VBoxGuestAdditions.iso</filename> file.
             </para>
 
@@ -368 +365 @@
                   On a Windows host, this file is in the &product-name;
                   installation directory, usually in
-                  <computeroutput>C:\Program
-                  files\Oracle\VirtualBox</computeroutput>.
+                  <filename>C:\Program
+                  files\Oracle\VirtualBox</filename>.
                 </para>
               </listitem>
@@ -380 +377 @@
                   <emphasis role="bold">Show Package
                   Contents</emphasis>. The file is located in the
-                  <computeroutput>Contents/MacOS</computeroutput>
-                  folder.
+                  <filename>Contents/MacOS</filename> folder.
                 </para>
               </listitem>
@@ -388 +384 @@
                 <para>
                   On a Linux host, this file is in the
-                  <computeroutput>additions</computeroutput> folder
-                  where you installed &product-name;, usually
-                  <computeroutput>/opt/VirtualBox/</computeroutput>.
+                  <filename>additions</filename> folder where you
+                  installed &product-name;, usually
+                  <filename>/opt/VirtualBox/</filename>.
                 </para>
               </listitem>
@@ -397 +393 @@
                 <para>
                   On Oracle Solaris hosts, this file is in the
-                  <computeroutput>additions</computeroutput> folder
-                  where you installed &product-name;, usually
-                  <computeroutput>/opt/VirtualBox</computeroutput>.
+                  <filename>additions</filename> folder where you
+                  installed &product-name;, usually
+                  <filename>/opt/VirtualBox</filename>.
                 </para>
               </listitem>
@@ -409 +405 @@
             <para>
               In the Virtual Media Manager, select the ISO file and
-              click <emphasis role="bold">Select</emphasis> button. This
-              mounts the ISO file and presents it to your Windows guest
-              as a CD-ROM.
+              click the <emphasis role="bold">Add</emphasis> button.
+              This mounts the ISO file and presents it to your Windows
+              guest as a CD-ROM.
             </para>
           </listitem>
@@ -422 +418 @@
           Additions installation program from the Additions ISO. If the
           Autostart feature has been turned off, choose
-          <computeroutput>VBoxWindowsAdditions.exe</computeroutput> from
-          the CD/DVD drive inside the guest to start the installer.
+          <filename>VBoxWindowsAdditions.exe</filename> from the CD/DVD
+          drive inside the guest to start the installer.
         </para>
 
@@ -461 +457 @@
         </para>
 
-        <orderedlist>
+        <itemizedlist>
 
           <listitem>
@@ -475 +471 @@
           </listitem>
 
-        </orderedlist>
+        </itemizedlist>
 
         <para>
@@ -510 +506 @@
           Installing the code signing certificates on a Windows guest
           can be done automatically. Use the
-          <computeroutput>VBoxCertUtil.exe</computeroutput> utility from
-          the <computeroutput>cert</computeroutput> folder on the Guest
-          Additions installation CD.
+          <filename>VBoxCertUtil.exe</filename> utility from the
+          <filename>cert</filename> folder on the Guest Additions
+          installation CD.
         </para>
 
@@ -536 +532 @@
             <para>
               Open a command line window on the guest and change to the
-              <computeroutput>cert</computeroutput> folder on the
-              &product-name; Guest Additions CD.
+              <filename>cert</filename> folder on the &product-name;
+              Guest Additions CD.
             </para>
           </listitem>
@@ -577 +573 @@
             driver needs to be installed. To select this driver by
             default, add the command line parameter
-            <computeroutput>/with_wddm</computeroutput> when invoking
-            the Windows Guest Additions installer. This is only required
-            for Vista and Windows 7.
+            <literal>/with_wddm</literal> when invoking the Windows
+            Guest Additions installer. This is only required for Vista
+            and Windows 7.
           </para>
         </note>
@@ -616 +612 @@
           a 32-bit system, you must use the appropriate platform
           installer. Use
-          <computeroutput>VBoxWindowsAdditions-x86.exe</computeroutput>
-          or
-          <computeroutput>VBoxWindowsAdditions-amd64.exe</computeroutput>
-          with the <computeroutput>/extract</computeroutput> parameter.
+          <filename>VBoxWindowsAdditions-x86.exe</filename> or
+          <filename>VBoxWindowsAdditions-amd64.exe</filename> with the
+          <literal>/extract</literal> parameter.
         </para>
 
@@ -657 +652 @@
         <listitem>
           <para>
-            Redhat Enterprise Linux as of version 3
+            Red Hat Enterprise Linux as of version 3
           </para>
         </listitem>
@@ -744 +739 @@
           <listitem>
             <para>
-              Insert the
-              <computeroutput>VBoxGuestAdditions.iso</computeroutput> CD
+              Insert the <filename>VBoxGuestAdditions.iso</filename> CD
               file into your Linux guest's virtual CD-ROM drive, as
               described for a Windows guest in
@@ -830 +824 @@
           into the virtual CD-ROM drive as described above. Then run the
           installer for the current Guest Additions with the
-          <computeroutput>uninstall</computeroutput> parameter from the
-          path that the CD image is mounted on in the guest, as follows:
+          <literal>uninstall</literal> parameter from the path that the
+          CD image is mounted on in the guest, as follows:
         </para>
 
@@ -853 +847 @@
         <para>
           Replace
-          <computeroutput>/opt/VBoxGuestAdditions-<replaceable>version</replaceable></computeroutput>
+          <filename>/opt/VBoxGuestAdditions-<replaceable>version</replaceable></filename>
           with the correct Guest Additions installation directory.
         </para>
@@ -917 +911 @@
           <listitem>
             <para>
-              Mount the
-              <computeroutput>VBoxGuestAdditions.iso</computeroutput>
-              file as your Oracle Solaris guest's virtual CD-ROM drive,
+              Mount the <filename>VBoxGuestAdditions.iso</filename> file
+              as your Oracle Solaris guest's virtual CD-ROM drive,
               exactly the same way as described for a Windows guest in
               <xref
@@ -1002 +995 @@
         those for the other platforms. Mount the ISO in OS/2 as
         described previously. The OS/2 Guest Additions are located in
-        the directory <computeroutput>\OS2</computeroutput>.
+        the directory <filename>\OS2</filename>.
       </para>
 
       <para>
         We do not provide an automatic installer at this time. See the
-        <computeroutput>readme.txt</computeroutput> file in the CD-ROM
-        directory, which describes how to install the OS/2 Guest
-        Additions manually.
+        <filename>readme.txt</filename> file in the CD-ROM directory,
+        which describes how to install the OS/2 Guest Additions
+        manually.
       </para>
 
@@ -1027 +1020 @@
       not require networking, only the Guest Additions. Shared folders
       are supported with Windows 2000 or later, Linux, and Oracle
-      Solaris guests. &product-name; release 6.0 includes experimental
-      support for Mac OS X and OS/2 guests.
+      Solaris guests. &product-name; includes experimental support for
+      Mac OS X and OS/2 guests.
     </para>
 
@@ -1104 +1097 @@
           the VM is powered off. These can be created using a checkbox
           in the VirtualBox Manager, or by using the
-          <computeroutput>--transient</computeroutput> option of the
-          <command>VBoxManage sharedfolder add</command> command.
+          <option>--transient</option> option of the <command>VBoxManage
+          sharedfolder add</command> command.
         </para>
       </listitem>
@@ -1116 +1109 @@
       read files on the host. By default, shared folders are read-write.
       Read-only folders can be created using a checkbox in the
-      VirtualBox Manager, or with the
-      <computeroutput>--readonly</computeroutput> option of the
-      <command>VBoxManage sharedfolder add</command> command.
+      VirtualBox Manager, or with the <option>--readonly</option> option
+      of the <command>VBoxManage sharedfolder add</command> command.
     </para>
 
@@ -1189 +1181 @@
 
           <para>
-            While <computeroutput>vboxsvr</computeroutput> is a fixed
-            name, note that <computeroutput>vboxsrv</computeroutput>
-            would also work, replace <replaceable>x:</replaceable> with
-            the drive letter that you want to use for the share, and
+            While <literal>vboxsvr</literal> is a fixed name, note that
+            <literal>vboxsrv</literal> would also work, replace
+            <replaceable>x:</replaceable> with the drive letter that you
+            want to use for the share, and
             <replaceable>sharename</replaceable> with the share name
             specified with <command>VBoxManage</command>.
@@ -1207 +1199 @@
           <para>
             To mount a shared folder during boot, add the following
-            entry to <computeroutput>/etc/fstab</computeroutput>:
+            entry to <filename>/etc/fstab</filename>:
           </para>
 
@@ -1223 +1215 @@
             Replace <replaceable>sharename</replaceable>, use a
             lowercase string, with the share name specified with
-            <command>VBoxManage</command> or the GUI. Replace
-            <replaceable>mountpoint</replaceable> with the path where
-            you want the share to be mounted on the guest, such as
-            <computeroutput>/mnt/share</computeroutput>. The usual mount
-            rules apply. For example, create this directory first if it
-            does not exist yet.
+            <command>VBoxManage</command> or the VirtualBox Manager.
+            Replace <replaceable>mountpoint</replaceable> with the path
+            where you want the share to be mounted on the guest, such as
+            <filename>/mnt/share</filename>. The usual mount rules
+            apply. For example, create this directory first if it does
+            not exist yet.
           </para>
 
@@ -1256 +1248 @@
             This option sets the character set used for I/O operations.
             Note that on Linux guests, if the
-            <computeroutput>iocharset</computeroutput> option is not
-            specified, then the Guest Additions driver will attempt to
-            use the character set specified by the CONFIG_NLS_DEFAULT
-            kernel option. If this option is not set either, then UTF-8
-            is used.
+            <literal>iocharset</literal> option is not specified, then
+            the Guest Additions driver will attempt to use the character
+            set specified by the CONFIG_NLS_DEFAULT kernel option. If
+            this option is not set either, then UTF-8 is used.
           </para>
 
@@ -1272 +1263 @@
           <para>
             The generic mount options, documented in the
-            <computeroutput>mount</computeroutput> manual page, apply
-            also. Especially useful are the options
-            <computeroutput>uid</computeroutput>,
-            <computeroutput>gid</computeroutput> and
-            <computeroutput>mode</computeroutput>, as they can allow
-            access by normal users in read/write mode, depending on the
-            settings, even if root has mounted the filesystem.
+            <command>mount</command> manual page, apply also. Especially
+            useful are the options <literal>uid</literal>,
+            <literal>gid</literal> and <literal>mode</literal>, as they
+            can allow access by normal users in read/write mode,
+            depending on the settings, even if root has mounted the
+            filesystem.
           </para>
         </listitem>
@@ -1294 +1284 @@
           <para>
             As with Windows guests, shared folders can also be accessed
-            via UNC using <computeroutput>\\VBoxSF\</computeroutput>,
-            <computeroutput>\\VBoxSvr\</computeroutput> or
-            <computeroutput>\\VBoxSrv\</computeroutput> as the server
-            name and the shared folder name as
-            <replaceable>sharename</replaceable>.
+            via UNC using <filename>\\VBoxSF\</filename>,
+            <filename>\\VBoxSvr\</filename> or
+            <filename>\\VBoxSrv\</filename> as the server name and the
+            shared folder name as <replaceable>sharename</replaceable>.
           </para>
         </listitem>
@@ -1332 +1321 @@
             <emphasis role="bold">Windows and OS/2 guests.</emphasis>
             Search for a free drive letter, starting at
-            <computeroutput>Z:</computeroutput>. If all drive letters
-            are assigned, the folder is not mounted.
+            <filename>Z:</filename>. If all drive letters are assigned,
+            the folder is not mounted.
           </para>
         </listitem>
@@ -1341 +1330 @@
             <emphasis role="bold">Linux and Oracle Solaris
             guests.</emphasis> Folders are mounted under the
-            <computeroutput>/media</computeroutput> directory. The
-            folder name is normalized (no spaces, slashes or colons) and
-            is prefixed with <computeroutput>sf_</computeroutput>.
+            <filename>/media</filename> directory. The folder name is
+            normalized (no spaces, slashes or colons) and is prefixed
+            with <filename>sf_</filename>.
           </para>
 
           <para>
             For example, if you have a shared folder called
-            <computeroutput>myfiles</computeroutput>, it will appear as
-            <computeroutput>/media/sf_myfiles</computeroutput> in the
-            guest.
+            <filename>myfiles</filename>, it will appear as
+            <filename>/media/sf_myfiles</filename> in the guest.
           </para>
 
           <para>
             The guest properties
-            <computeroutput>/VirtualBox/GuestAdd/SharedFolders/MountDir</computeroutput>
+            <literal>/VirtualBox/GuestAdd/SharedFolders/MountDir</literal>
             and the more generic
-            <computeroutput>/VirtualBox/GuestAdd/SharedFolders/MountPrefix</computeroutput>
+            <literal>/VirtualBox/GuestAdd/SharedFolders/MountPrefix</literal>
             can be used to override the automatic mount directory and
             prefix. See <xref linkend="guestadd-guestprops" />.
@@ -1369 +1357 @@
         everyone in a Windows guest, including the guest user. For Linux
         and Oracle Solaris guests, access is restricted to members of
-        the group <computeroutput>vboxsf</computeroutput> and the
-        <computeroutput>root</computeroutput> user.
+        the group <literal>vboxsf</literal> and the
+        <literal>root</literal> user.
       </para>
 
@@ -1383 +1371 @@
     <para>
       &product-name; enables you to drag and drop content from the host
-      to the guest, and vice versa. For this to work the latest Guest
-      Additions must be installed on the guest.
+      to the guest, and vice versa. For this to work the latest version
+      of the Guest Additions must be installed on the guest.
     </para>
 
@@ -1439 +1427 @@
     <figure id="fig-drag-drop-options">
       <title>Drag and Drop Menu Options</title>
-      <mediaobject>
+    <mediaobject>
         <imageobject>
           <imagedata align="center" fileref="images/dnd-modes.png"
@@ -1617 +1605 @@
               <para>
                 3D acceleration with Windows guests requires Windows
-                2000, Windows XP, Vista, or Windows 7. Apart from on
-                Windows 2000 guests, both OpenGL and Direct3D 8/9 are
-                supported on an experimental basis.
+                2000 or later. Apart from on Windows 2000 guests, both
+                OpenGL and Direct3D 8/9 are supported on an experimental
+                basis.
               </para>
             </listitem>
@@ -1692 +1680 @@
         driver must be installed, which is available with the Guest
         Additions installation. The WDDM driver is not installed by
-        default for Vista and Windows 7 guest and must be
+        default for Vista and Windows 7 guests and must be
         <emphasis>manually selected</emphasis> in the Guest Additions
         installer by clicking <emphasis role="bold">No</emphasis> in the
@@ -1701 +1689 @@
 
       <para>
-        The Aero theme is not enabled by default. To enable it, do the
-        following:
-      </para>
-
-      <itemizedlist>
-
-        <listitem>
-          <para>
-            <emphasis role="bold">Windows Vista guests:</emphasis>
-            Right-click on the desktop and select
-            <emphasis role="bold">Personalize</emphasis>, then select
-            <emphasis role="bold">Windows Color and
-            Appearance</emphasis> in the
-            <emphasis role="bold">Personalization</emphasis> window. In
-            the <emphasis role="bold">Appearance Settings</emphasis>
-            dialog, select <emphasis role="bold">Windows Aero</emphasis>
-            and click <emphasis role="bold">OK</emphasis>.
-          </para>
-        </listitem>
-
-        <listitem>
-          <para>
-            <emphasis role="bold">Windows 7 guests:</emphasis>
-            Right-click on the desktop and select
-            <emphasis role="bold">Personalize</emphasis>. Select any
-            Aero theme in the
-            <emphasis role="bold">Personalization</emphasis> window.
-          </para>
-        </listitem>
-
-      </itemizedlist>
-
-      <para>
-        Technically, &product-name; implements this by installing an
-        additional hardware 3D driver inside your guest when the Guest
-        Additions are installed. This driver acts as a hardware 3D
-        driver and reports to the guest operating system that the
-        virtual hardware is capable of 3D hardware acceleration. When an
-        application in the guest then requests hardware acceleration
-        through the OpenGL or Direct3D programming interfaces, these are
-        sent to the host through a special communication tunnel
-        implemented by &product-name;, and then the
-        <emphasis>host</emphasis> performs the requested 3D operation
-        using the host's programming interfaces.
+        The Aero theme is not enabled by default on Windows. See your
+        Windows platform documentation for details of how to enable the
+        Aero theme.
+      </para>
+
+      <para>
+        Technically, &product-name; implements 3D acceleration by
+        installing an additional hardware 3D driver inside the guest
+        when the Guest Additions are installed. This driver acts as a
+        hardware 3D driver and reports to the guest operating system
+        that the virtual hardware is capable of 3D hardware
+        acceleration. When an application in the guest then requests
+        hardware acceleration through the OpenGL or Direct3D programming
+        interfaces, these are sent to the host through a special
+        communication tunnel implemented by &product-name;. The
+        <emphasis>host</emphasis> then performs the requested 3D
+        operation using the host's programming interfaces.
       </para>
 
@@ -1806 +1767 @@
         through a special communication tunnel implemented by
         &product-name;. On the host side, OpenGL is then used to
-        implement color space transformation and scaling
+        implement color space transformation and scaling.
       </para>
 
@@ -1829 +1790 @@
       <listitem>
         <para>
-          Windows guests. Support was added in &product-name; 1.5.
+          Windows guests.
         </para>
       </listitem>
@@ -1836 +1797 @@
         <para>
           Supported Linux or Oracle Solaris guests running the X Window
-          System. Support was added with &product-name; 1.6.
+          System.
         </para>
       </listitem>
@@ -1851 +1812 @@
     <figure id="fig-seamless-windows">
       <title>Seamless Windows on a Host Desktop</title>
-      <mediaobject>
+    <mediaobject>
         <imageobject>
           <imagedata align="center" fileref="images/seamless.png" width="14cm" />
@@ -1918 +1879 @@
       version of the Guest Additions, users that are currently logged
       into the guest OS, network statistics and more. These predefined
-      properties are all prefixed with
-      <computeroutput>/VirtualBox/</computeroutput> and organized into a
-      hierarchical tree of keys.
+      properties are all prefixed with <literal>/VirtualBox/</literal>
+      and organized into a hierarchical tree of keys.
     </para>
 
@@ -1940 +1900 @@
 <screen>$ VBoxManage guestproperty enumerate "Windows Vista III"
 VirtualBox Command Line Management Interface Version <replaceable>version-number</replaceable>
-(C) 2005-2018 Oracle Corporation
+(C) 2005-2019 Oracle Corporation
 All rights reserved.
 
@@ -1997 +1957 @@
     <para>
       To query the value of a single property, use the
-      <computeroutput>get</computeroutput> subcommand as follows:
+      <command>get</command> subcommand as follows:
     </para>
 
 <screen>$ VBoxManage guestproperty get "Windows Vista III" "/VirtualBox/GuestInfo/OS/Product"
 VirtualBox Command Line Management Interface Version <replaceable>version-number</replaceable>
-(C) 2005-2018 Oracle Corporation
+(C) 2005-2019 Oracle Corporation
 All rights reserved.
 
@@ -2009 +1969 @@
     <para>
       To add or change guest properties from the guest, use the tool
-      <computeroutput>VBoxControl</computeroutput>. This tool is
-      included in the Guest Additions of &product-name; 2.2 or later.
-      When started from a Linux guest, this tool requires root
-      privileges for security reasons:
+      <command>VBoxControl</command>. This tool is included in the Guest
+      Additions. When started from a Linux guest, this tool requires
+      root privileges for security reasons.
     </para>
 
 <screen>$ sudo VBoxControl guestproperty enumerate
 VirtualBox Guest Additions Command Line Management Interface Version <replaceable>version-number</replaceable>
-(C) 2005-2018 Oracle Corporation
+(C) 2005-2019 Oracle Corporation
 All rights reserved.
 
@@ -2036 +1995 @@
 
       <para>
-        The properties
-        <computeroutput>/VirtualBox/HostInfo/VBoxVer</computeroutput>,
-        <computeroutput>/VirtualBox/HostInfo/VBoxVerExt</computeroutput>
-        or <computeroutput>/VirtualBox/HostInfo/VBoxRev</computeroutput>
-        can be waited on to detect that the VM state was restored from
-        saved state or snapshot:
+        The properties <literal>/VirtualBox/HostInfo/VBoxVer</literal>,
+        <literal>/VirtualBox/HostInfo/VBoxVerExt</literal> or
+        <literal>/VirtualBox/HostInfo/VBoxRev</literal> can be waited on
+        to detect that the VM state was restored from saved state or
+        snapshot:
       </para>
 
@@ -2048 +2006 @@
       <para>
         Similarly the
-        <computeroutput>/VirtualBox/HostInfo/ResumeCounter</computeroutput>
-        can be used to detect that a VM was resumed from the paused
-        state or saved state.
+        <literal>/VirtualBox/HostInfo/ResumeCounter</literal> can be
+        used to detect that a VM was resumed from the paused state or
+        saved state.
       </para>
 
@@ -2070 +2028 @@
     <figure id="fig-guest-control-fm">
       <title>Guest Control File Manager</title>
-      <mediaobject>
+    <mediaobject>
         <imageobject>
           <imagedata align="center" fileref="images/guest-fm.png"
@@ -2165 +2123 @@
 
     <para>
-      The Guest Additions enable starting of applications inside a VM
-      from the host system.
-    </para>
-
-    <para>
-      For this to work, the application needs to be installed inside the
+      The Guest Additions enable starting of applications inside a guest
+      VM from the host system. This feature can be used to automate
+      deployment of software within the guest.
+    </para>
+
+    <para>
+      For this to work, the application needs to be installed on the
       guest. No additional software needs to be installed on the host.
       Additionally, text mode output to stdout and stderr can be shown
@@ -2179 +2138 @@
 
     <para>
-      This feature can be used to automate deployment of software within
-      the guest.
-    </para>
-
-    <para>
       The Guest Additions for Windows allow for automatic updating. This
-      applies for already installed Guest Additions version 4.0 or
-      later. Also, copying files from host to the guest as well as
-      remotely creating guest directories is available.
+      applies for already installed Guest Additions versions. Also,
+      copying files from host to the guest as well as remotely creating
+      guest directories is available.
     </para>
 
@@ -2234 +2188 @@
               Memory ballooning does not work with large pages enabled.
               To turn off large pages support for a VM, run
-              <computeroutput>VBoxManage modifyvm &lt;VM name&gt;
-              --largepages off</computeroutput>
+              <command>VBoxManage modifyvm
+              <replaceable>vmname</replaceable> --largepages
+              off</command>
             </para>
           </listitem>
@@ -2303 +2258 @@
       <para>
         By default, no balloon memory is allocated. This is a VM
-        setting, like other <computeroutput>modifyvm</computeroutput>
-        settings, and therefore can only be set while the machine is
-        shut down. See <xref
+        setting, like other <command>modifyvm</command> settings, and
+        therefore can only be set while the machine is shut down. See
+        <xref
       linkend="vboxmanage-modifyvm" />.
       </para>
@@ -2341 +2296 @@
         efficiently Page Fusion can reduce the amount of host memory
         that is in use. It therefore works best if all VMs on a host run
-        identical operating systems, such as Windows XP Service Pack 2.
-        Instead of having a complete copy of each operating system in
-        each VM, Page Fusion identifies the identical memory pages in
-        use by these operating systems and eliminates the duplicates,
-        sharing host memory between several machines. This is called
-        <emphasis>deduplication</emphasis>. If a VM tries to modify a
-        page that has been shared with other VMs, a new page is
-        allocated again for that VM with a copy of the shared page. This
-        is called <emphasis>copy on write</emphasis>. All this is fully
-        transparent to the virtual machine.
+        identical operating systems. Instead of having a complete copy
+        of each operating system in each VM, Page Fusion identifies the
+        identical memory pages in use by these operating systems and
+        eliminates the duplicates, sharing host memory between several
+        machines. This is called <emphasis>deduplication</emphasis>. If
+        a VM tries to modify a page that has been shared with other VMs,
+        a new page is allocated again for that VM with a copy of the
+        shared page. This is called <emphasis>copy on write</emphasis>.
+        All this is fully transparent to the virtual machine.
       </para>
 
@@ -2411 +2365 @@
       <para>
         You can observe Page Fusion operation using some metrics.
-        <computeroutput>RAM/VMM/Shared</computeroutput> shows the total
-        amount of fused pages, whereas the per-VM metric
-        <computeroutput>Guest/RAM/Usage/Shared</computeroutput> will
-        return the amount of fused memory for a given VM. See
-        <xref
-        linkend="vboxmanage-metrics" /> for information on
-        how to query metrics.
+        <literal>RAM/VMM/Shared</literal> shows the total amount of
+        fused pages, whereas the per-VM metric
+        <literal>Guest/RAM/Usage/Shared</literal> will return the amount
+        of fused memory for a given VM. See
+        <xref linkend="vboxmanage-metrics" /> for information on how to
+        query metrics.
       </para>