Index: /trunk/doc/manual/en_US/user_BasicConcepts.xml
===================================================================
--- /trunk/doc/manual/en_US/user_BasicConcepts.xml	(revision 38046)
+++ /trunk/doc/manual/en_US/user_BasicConcepts.xml	(revision 38047)
@@ -614,4 +614,11 @@
       <para>You should not, however, configure virtual machines to use more
       CPU cores than you have available physically.</para>
+
+      <para>On this tab you can also set the CPU execution cap. This setting
+      limits the amount of time a host CPU spents to emulate a virtual CPU.
+      The default setting is 100% meaning that there is no limitation. A setting
+      of 50% implies a single virtual CPU can use up to 50% of a single host
+      CPU. Notet that limiting the execution time of the virtual CPUs may induce
+      guest timing problems.</para>
 
       <para>In addition, the <emphasis role="bold">"Enable PAE/NX"</emphasis>
Index: /trunk/doc/manual/en_US/user_GuestAdditions.xml
===================================================================
--- /trunk/doc/manual/en_US/user_GuestAdditions.xml	(revision 38046)
+++ /trunk/doc/manual/en_US/user_GuestAdditions.xml	(revision 38047)
@@ -230,9 +230,11 @@
 
         <note>
-          <para>For the basic Direct 3D acceleration to work in a Windows Guest, you
-          must install the Guest Additions in "Safe Mode".
-          This does NOT apply to experimental WDDM Direct 3D video driver available for 
-          Vista and Windows 7 guests. see <xref
-          linkend="KnownIssues" /> for details.</para>
+          <para>For the basic Direct3D acceleration to work in a Windows Guest, you
+          have to install the Guest Additions in "Safe Mode".
+          This does <emphasis role="bold">not</emphasis> apply to the experimental
+          WDDM Direct3D video driver available
+          for Vista and Windows 7 guests, see <xref linkend="KnownIssues" /> for
+          details.<footnote><para>The experimental WDDM driver was added with
+          VirtualBox 4.1.</para></footnote></para>
         </note>
 
@@ -1164,15 +1166,15 @@
           <listitem>
             <para>The Guest Additions must be installed.<note>
-                <para>For the basic Direct 3D acceleration to work in a Windows Guest,
+                <para>For the basic Direct3D acceleration to work in a Windows Guest,
                 VirtualBox needs to replace Windows system files in the
                 virtual machine. As a result, the Guest Additions installation
-                program offers Direct 3D acceleration as an option that must
+                program offers Direct3D acceleration as an option that must
                 be explicitly enabled. Also, you must install the Guest
-                Additions in "Safe Mode".
-                <note><para>This does NOT apply to experimental WDDM Direct 3D video driver 
-                available for Vista and Windows 7 guests.</para></note> 
-                See <xref linkend="KnownIssues" />
-                for details.</para>
-              </note></para>
+                Additions in "Safe Mode". This does <emphasis role="bold">not</emphasis>
+                apply to the experimental WDDM Direct3D video
+                driver available for Vista and Windows 7 guests,
+                see <xref linkend="KnownIssues" />
+                for details.</para></note>
+              </para>
           </listitem>
 
@@ -1191,16 +1193,17 @@
         </orderedlist></para>
 
-      <para>With VirtualBox 4.1 Windows Aero theme support is added for
+      <para>With VirtualBox 4.1, Windows Aero theme support is added for
       Windows Vista and Windows 7 guests. To enable Aero theme support, 
       the experimental VirtualBox WDDM video driver must be installed, 
       which is available with the Guest Additions installation.
-      Since WDDM video driver is still experimental at this time, it is
+      Since the WDDM video driver is still experimental at this time, it is
       not installed by default and must be <emphasis role="bold">manually
       selected</emphasis> in the Guest Additions installer by answering "No"
       int the "Would you like to install basic Direct3D support" dialog 
-      displayed when the Direct 3D feature is selected.
-      <note><para>Unlike current basic Direct 3D support, WDDM video driver
-      installation does NOT require "Safe Mode"</para></note>
-      <note><para>Aero theme is not enabled by default, to enable it<itemizedlist>
+      displayed when the Direct3D feature is selected.
+      <note><para>Unlike the current basic Direct3D support, the WDDM video
+      driver installation does <emphasis role="bold">not</emphasis> require
+      the "Safe Mode".</para></note>
+      <para>The Aero theme is not enabled by default. To enable it<itemizedlist>
           <listitem>
             <para>In Windows Vista guest: right-click on the desktop, in the 
@@ -1213,5 +1216,5 @@
             in the "Personalization" window</para></listitem>
           </itemizedlist>
-        </para></note>
+        </para>
       </para>
 
Index: /trunk/doc/manual/en_US/user_KnownIssues.xml
===================================================================
--- /trunk/doc/manual/en_US/user_KnownIssues.xml	(revision 38046)
+++ /trunk/doc/manual/en_US/user_KnownIssues.xml	(revision 38047)
@@ -48,7 +48,9 @@
       installed by VirtualBox and keep restoring the original Windows system
       DLLs. <note>
-          <para>This does NOT apply to experimental WDDM Direct 3D video
-          driver available for Vista and Windows 7 guests.</para>
-        </note></para>
+      <para>This does <emphasis role="bold">not</emphasis> apply to the
+      experimental WDDM Direct3D video
+      driver available for Vista and Windows 7 guests shipped with
+        VirtualBox 4.1.</para>
+      </note></para>
     </listitem>
 
Index: /trunk/doc/manual/user_ChangeLogImpl.xml
===================================================================
--- /trunk/doc/manual/user_ChangeLogImpl.xml	(revision 38046)
+++ /trunk/doc/manual/user_ChangeLogImpl.xml	(revision 38047)
@@ -107,4 +107,10 @@
         <para>GUI: added a setting for the promiscuous mode policy for
           internal networks, bridged networks and host-only networks</para>
+      </listitem>
+
+      <listitem>
+        <para>GUI: added slider for setting the CPU execution cap allowing to
+          limit the amount of CPU time spent for the execution of the guest,
+          see <xref linkend="settings-processor"/>.</para>
       </listitem>