[gnome-user-docs] Updates to some window management pages

[Shaun McCance <shaunm src gnome org>]

commit 240e839cba5f1028b90359c3432e7af95862da01
Author: Shaun McCance <shaunm gnome org>
Date:   Wed Mar 14 17:35:52 2012 -0400

    Updates to some window management pages

 gnome-help/C/shell-windows-maximize.page |   56 ++++++++++++------------------
 gnome-help/C/shell-windows-tiled.page    |   51 ++++++++++++---------------
 gnome-help/C/shell-windows.page          |    6 +++
 3 files changed, 51 insertions(+), 62 deletions(-)
---
diff --git a/gnome-help/C/shell-windows-maximize.page b/gnome-help/C/shell-windows-maximize.page
index 2a00407..9152992 100644
--- a/gnome-help/C/shell-windows-maximize.page
+++ b/gnome-help/C/shell-windows-maximize.page
@@ -4,52 +4,40 @@
       id="shell-windows-maximize">
 
   <info>
-
     <link type="guide" xref="shell-windows#working-with-windows"/>
+    <link type="seealso" xref="shell-windows-tiled"/>
 
-    <desc>Double-click on the title bar.</desc>
-    <!-- See shell-windows-states -->
+    <desc>Double-click or drag a titlebar to maximize or restore a window.</desc>
     
-    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
+    <revision pkgversion="3.4.0" date="2012-03-14" status="candidate"/>
 
     <credit type="author">
-      <name>GNOME Documentation Project</name>
-      <email>gnome-doc-list gnome org</email>
+      <name>Shaun McCance</name>
+      <email>shaunm gnome org</email>
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Maximize and unmaximize (restore) a window</title>
-
-    <p> To maximize or unmaximize a window:</p>
-<list>
- <item><p>Double-click on the title bar of the window.</p></item>
-</list>
-
-<p>Alternatively, to maximize a window:</p>
-
-<list>
- <item><p>Click on the title bar of an application and drag it to the top of the
- screen.  When the mouse pointer touches the top of the screen, the entire screen
- becomes highlighted.  Release the mouse button to maximize the window.</p></item>
-</list>
+  <title>Maximize and unmaximize a window</title>
 
-<p>To restore the window to its original size:</p>
+  <p>You can maximize a window to take up all of the space on your desktop
+  and unmaximize a window to restore it to its normal size. You can also
+  maximize windows vertically along the left and right sides of the screen,
+  so you can easily look at two windows at once. See
+  <link xref="shell-windows-tiled"/> for details.</p>
 
-<list>
- <item><p>Click on the title bar of the application, and drag it down from the
- top bar.  After the window separates from the top bar it will restore itself to
- an unmaximized state.</p></item>
-</list>
+  <p>To maximize a window, grab the titlebar and drag it to the top of the
+  screen, or just double-click the titlebar. To maximize a window using the
+  keyboard, hold down the <link xref="windows-key">windows key</link> and
+  press <key>Up</key>, or press <keyseq><key>Alt</key><key>F10</key></keyseq>.</p>
 
-    <note style="tip">
-      <p>Press <key>Alt</key> +click+hold+drag anywhere in a window. This will
-      allow you to move the window. Some people may find this easier than
-      clicking on the title bar of an application.</p>
-      <p>You can also use your keyboard to maximize a window. Press
-      <keyseq><key>Alt</key><key>Space</key></keyseq> to bring up the window
-      menu, and press <key>x</key>.</p>
-    </note>
+  <p>To restore a window to its unmaximized size, drag it away from the edges
+  of the screen. If the window is fully maximized, you can double-click the
+  titlebar to restore it. You can also use the same keyboard shortcuts you
+  used to maximize the window.</p>
 
+  <note style="tip">
+    <p>Hold down the <key>Alt</key> key and drag anywhere in a window to move it.</p>
+  </note>
 </page>
diff --git a/gnome-help/C/shell-windows-tiled.page b/gnome-help/C/shell-windows-tiled.page
index ae19fe3..daa9633 100644
--- a/gnome-help/C/shell-windows-tiled.page
+++ b/gnome-help/C/shell-windows-tiled.page
@@ -1,5 +1,5 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" style="ui"
+      type="topic" style="task"
       id="shell-windows-tiled">
 
   <info>
@@ -7,40 +7,35 @@
     <link type="guide" xref="shell-windows#working-with-windows"/>
     <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
 
-    <desc>"Maximize" two windows side by side.</desc>
+    <desc>Maximize two windows side-by-side.</desc>
     
-    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
+    <revision pkgversion="3.4.0" date="2012-03-14" status="candidate"/>
+
     <credit type="author">
-      <name>GNOME Documentation Project</name>
-      <email>gnome-doc-list gnome org</email>
+      <name>Shaun McCance</name>
+      <email>shaunm gnome org</email>
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
 
-<title>Tiled windows</title>
-
-<comment><p>Discuss interesting ways of arranging windows (i.e. if there is a
- "Tile" option or something like that.</p></comment>
- 
-<p>Your workflow may require two windows arranged side by side for comparison
- purposes. To fill the screen with two vertically-tiled windows:</p>
-
-<list>
- <item><p>Click on the <gui>title bar</gui> of a window and drag it toward the
-  left edge of the screen.  When the <gui>mouse pointer</gui> touches the edge,
-  the left half of the screen becomes highlighted. Release the mouse button and
-  the window will fill the left half of the screen.</p></item>
- <item><p>Drag another window to the right side: when the right half of the
-  screen is highlighted, release. Each of the two windows fills half the
-  screen.</p></item>
-</list>
-
-    <note style="tip">
-      <p>Pressing <key>Alt</key> + click anywhere in a window will allow you to
-       move the window. Some people may find this easier than clicking on the
-       <gui>title bar</gui> of an application.</p>
-    </note>
+<title>Tile windows</title>
+
+<p>You can maximize a window on only the left or right side of the screen,
+allowing you to place two windows side-by-side to quickly switch between
+them.</p>
+
+<p>To maximize a window along a side of the screen, grab the titlebar and drag
+it to the left or right side until half of the screen is highlighted. Using the
+keyboard, hold down the <link xref="windows-key">windows key</link> and press
+the <key>Left</key> or <key>Right</key> key.</p>
+
+<p>To restore a window to its original size, drag it away from the side of
+the screen, or use the same keyboard shortcut you used to maximize.</p>
+
+<note style="tip">
+  <p>Hold down the <key>Alt</key> key and drag anywhere in a window to move it.</p>
+</note>
 
 </page>
diff --git a/gnome-help/C/shell-windows.page b/gnome-help/C/shell-windows.page
index 92dc238..c8f5ac3 100644
--- a/gnome-help/C/shell-windows.page
+++ b/gnome-help/C/shell-windows.page
@@ -45,10 +45,16 @@ Right clicking on the application icon for a running application will bring all
 <p>Very brief overview of what you can do with windows. Link to relevant topics.</p>
 </comment>
 <section id="working-with-windows" style="2column">
+  <info>
+    <title type="link" role="trail">Windows</title>
+  </info>
  <title>Working with windows</title>
 </section>
 
 <section id="working-with-workspaces" style="2column">
+  <info>
+    <title type="link" role="trail">Workspaces</title>
+  </info>
  <title>Working with workspaces</title>
 </section>