Changeset 34945 in vbox

Timestamp:

Dec 10, 2010 11:50:37 AM (14 years ago)

Author:

vboxsync

Message:

Manual: changelog, document scale mode

Location:

trunk/doc/manual

Files:

• en_US/user_GuestAdditions.xml (modified) (2 diffs)
• en_US/user_Introduction.xml (modified) (2 diffs)
• en_US/user_KnownIssues.xml (modified) (1 diff)
• user_ChangeLogImpl.xml (modified) (6 diffs)

trunk/doc/manual/en_US/user_GuestAdditions.xml

@@ -70 +70 @@
             as well as accelerated video performance.</para>
 
-            <para>In addition, with Windows and recent Linux and Solaris
-            guests you can resize the virtual machine's window if the Guest
-            Additions are installed. The video resolution in the guest will be
-            automatically adjusted (as if you had manually entered an
-            arbitrary resolution in the guest's display settings).</para>
+            <para>In addition, with Windows, Linux and Solaris guests, you can
+            resize the virtual machine's window if the Guest Additions are
+            installed. The video resolution in the guest will be automatically
+            adjusted (as if you had manually entered an arbitrary resolution
+            in the guest's display settings). Please see <xref
+            linkend="intro-resize-window" /> also.</para>
 
             <para>Finally, if the Guest Additions are installed, 3D graphics
@@ -1509 +1510 @@
 
     <para>Starting with version 4.0, the Guest Additions for Windows allow for
-    automatic updating (only already installed Guest Additions 4.0 or
-    later). Also, copying files from host to the guest as well as remotely
-    creating guest directories is available.</para>
+    automatic updating (only already installed Guest Additions 4.0 or later).
+    Also, copying files from host to the guest as well as remotely creating
+    guest directories is available.</para>
 
     <para>To use these feature, use the VirtualBox command line or the GUI.
-    See <xref linkend="mountingadditionsiso" /> for automatically updating
-    the Guest Additions or <xref linkend="vboxmanage-guestcontrol" /> for
+    See <xref linkend="mountingadditionsiso" /> for automatically updating the
+    Guest Additions or <xref linkend="vboxmanage-guestcontrol" /> for
     executing guest programs, copying files from the host or creating guest
     directories.</para>

trunk/doc/manual/en_US/user_Introduction.xml

@@ -468 +468 @@
 
             <listitem>
-              <para>SUSE Linux 9 and 10, openSUSE 10.3, 11.0, 11.1,
-              11.2, 11.3</para>
+              <para>SUSE Linux 9 and 10, openSUSE 10.3, 11.0, 11.1, 11.2,
+              11.3</para>
             </listitem>
 
@@ -1057 +1057 @@
       Image Manager, all as described in <xref
       linkend="configbasics" />.</para>
+    </sect2>
+
+    <sect2 id="intro-resize-window">
+      <title>Resizing the machine's window</title>
+
+      <para>You can resize the virtual machine's window when it is running. In
+      that case, one of three things will happen:<orderedlist>
+          <listitem>
+            <para>If you have <emphasis role="bold">"scale mode"</emphasis>
+            enabled, then the virtual machine's screen will be scaled to the
+            size of the window. This can be useful if you have many machines
+            running and want to have a look at one of them while it is running
+            in the background. Alternatively, it might be useful to enlarge a
+            window if the VM's output screen is very small, for example
+            because you are running an old operating system in it.</para>
+
+            <para>To enable scale mode, press the <emphasis role="bold">host
+            key + C</emphasis>, or select "Scale mode" from the "Machine" menu
+            in the VM window. To leave scale mode, press the host key + C
+            again.</para>
+
+            <para>Please see <xref linkend="KnownIssues" /> for additional
+            remarks.</para>
+          </listitem>
+
+          <listitem>
+            <para>If you have the Guest Additions installed and they support
+            automatic <emphasis role="bold">resizing</emphasis>, the Guest
+            Additions will automatically adjust the screen resolution of the
+            guest operating system. For example, if you are running a Windows
+            guest with a resolution of 1024x768 pixels and you then resize the
+            VM window to make it 100 pixels wider, the Guest Additions will
+            change the Windows display resolution to 1124x768.</para>
+
+            <para>Please see <xref linkend="guestadditions" /> for more
+            information about the Guest Additions.</para>
+          </listitem>
+
+          <listitem>
+            <para>Otherwise, if the window is bigger than the VM's screen, the
+            screen will be centered. If it is smaller, then scroll bars will
+            be added to the machine window.</para>
+          </listitem>
+        </orderedlist></para>
     </sect2>
 

trunk/doc/manual/en_US/user_KnownIssues.xml

@@ -107 +107 @@
 
     <listitem>
-      <para><emphasis role="bold">Seamless mode</emphasis> does not work
-      correctly with Linux guests that have 3D effects enabled (such as with
-      compiz-enabled window managers).</para>
+      <para>Neither <emphasis role="bold">scale mode</emphasis> nor <emphasis
+      role="bold">seamless mode</emphasis> work correctly with guests using
+      OpenGL 3D features (such as with compiz-enabled window managers).</para>
     </listitem>
 

trunk/doc/manual/user_ChangeLogImpl.xml

@@ -10 +10 @@
 
       <listitem>
-        <para>Reorganization of VirtualBox into a base package and Extension Packs; see <xref linkend="intro-installing" />.</para>
-      </listitem>
-
-      <listitem>
-        <para>New settings/disk file layout for VM portability; see <xref linkend="vboxconfigdata" />.</para>
+        <para>Reorganization of VirtualBox into a base package and Extension Packs; see <xref linkend="intro-installing" /></para>
+      </listitem>
+
+      <listitem>
+        <para>New settings/disk file layout for VM portability; see <xref linkend="vboxconfigdata" /></para>
       </listitem>
 
@@ -24 +24 @@
             </listitem>
             <listitem>
-              <para>New display mode with downscaled guest display</para>
+              <para>New "scale" display mode with scaled guest display; see <xref linkend="intro-resize-window" /></para>
             </listitem>
             <listitem>
@@ -43 +43 @@
 
       <listitem>
-        <para>Open Virtualization Format Archive (OVA) support; see <xref linkend="ovf" />.</para>
+        <para>Open Virtualization Format Archive (OVA) support; see <xref linkend="ovf" /></para>
       </listitem>
 
@@ -58 +58 @@
             <listitem>
               <para>Intel HD Audio, for better support of modern guest operating systems
-                (e.g. 64-bit Windows; bug #2785).</para>
+                (e.g. 64-bit Windows; bug #2785)</para>
             </listitem>
           </itemizedlist>
@@ -66 +66 @@
       <listitem>
         <para>Resource control: added support for limiting a VM's CPU time and IO
-        bandwidth.</para>
+          bandwidth; see <xref linkend="storage-bandwidth-limit" /></para>
       </listitem>
 
@@ -91 +91 @@
      <listitem>
         <para>Guest Additions: support for multiple virtual screens in Linux
-           and Solaris guests using X.Org server 1.3 and later.</para>
+           and Solaris guests using X.Org server 1.3 and later</para>
       </listitem>