[gnome-user-docs] Review shell-* pages for 3.14



commit 2ad8c3023364d5942031578aa345648be1ff6a57
Author: David King <amigadave amigadave com>
Date:   Mon Sep 22 19:17:30 2014 +0100

    Review shell-* pages for 3.14

 gnome-help/C/shell-apps-favorites.page        |    7 +-
 gnome-help/C/shell-apps-open.page             |   40 ++++++-----
 gnome-help/C/shell-exit.page                  |   11 ++-
 gnome-help/C/shell-introduction.page          |    1 +
 gnome-help/C/shell-lockscreen.page            |   30 +++++---
 gnome-help/C/shell-terminology.page           |   32 +++++----
 gnome-help/C/shell-windows-lost.page          |   46 +++++++-----
 gnome-help/C/shell-windows-maximize.page      |   14 +++--
 gnome-help/C/shell-windows-states.page        |   70 ++++++++++--------
 gnome-help/C/shell-windows-switching.page     |   96 +++++++++++++------------
 gnome-help/C/shell-windows-tiled.page         |   33 +++++----
 gnome-help/C/shell-windows.page               |   33 +++++----
 gnome-help/C/shell-workspaces-movewindow.page |   12 +--
 gnome-help/C/shell-workspaces-switch.page     |    7 +-
 gnome-help/C/shell-workspaces.page            |   57 +++++++--------
 15 files changed, 267 insertions(+), 222 deletions(-)
---
diff --git a/gnome-help/C/shell-apps-favorites.page b/gnome-help/C/shell-apps-favorites.page
index 7153ef1..a9fb8d9 100644
--- a/gnome-help/C/shell-apps-favorites.page
+++ b/gnome-help/C/shell-apps-favorites.page
@@ -7,7 +7,8 @@
     <link type="seealso" xref="shell-apps-open"/>
     <link type="guide" xref="shell-overview#apps"/>
 
-    <revision pkgversion="3.6.0" version="0.2" date="2012-10-14" status="review"/>
+    <revision pkgversion="3.6.0" date="2012-10-14" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -30,8 +31,8 @@
 
   <title>Pin your favorite apps to the dash</title>
 
-  <p>To add an application to the <link xref="shell-terminology">dash</link> for
-  easy access:</p>
+  <p>To add an application to the <link xref="shell-terminology">dash</link>
+  for easy access:</p>
 
   <steps>
     <item>
diff --git a/gnome-help/C/shell-apps-open.page b/gnome-help/C/shell-apps-open.page
index e18d613..64dbf3c 100644
--- a/gnome-help/C/shell-apps-open.page
+++ b/gnome-help/C/shell-apps-open.page
@@ -7,7 +7,9 @@
     <link type="guide" xref="shell-overview#apps" />
     <link type="guide" xref="index" group="#first"/>
 
-    <revision pkgversion="3.6.0" version="0.2" date="2012-10-14" status="review"/>
+    <revision pkgversion="3.6.0" date="2012-10-14" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
+
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -38,9 +40,9 @@ icon to choose a window to focus or get new window. Mention middle-click?</p>
 
   <p if:test="!platform:gnome-classic">Move your mouse pointer to the
   <gui>Activities</gui> corner at the top left of the screen to show the
-  <gui>Activities</gui> overview. This is where you can find all of your
-  applications. You can also open the overview by pressing the
-  <key xref="keyboard-key-super">Super</key> key.</p>
+  <gui xref="shell-terminology">Activities</gui> overview. This is where you
+  can find all of your applications. You can also open the overview by pressing
+  the <key xref="keyboard-key-super">Super</key> key.</p>
   
   <p if:test="platform:gnome-classic">You can start applications from the
   <link xref="shell-terminology"><gui>Applications</gui> menu</link> at the top
@@ -74,22 +76,24 @@ icon to choose a window to focus or get new window. Mention middle-click?</p>
     <item>
       <p>You can launch an application in a separate
       <link xref="shell-workspaces">workspace</link> by dragging its icon from
-      the dash (or from the list of applications), and dropping it onto one of
-      the workspaces on the right-hand side of the screen. The application will
-      open in the chosen workspace.</p>
-      <p>You can launch an application in a <em>new</em> workspace by
-      middle-clicking its icon in the dash or in the application list.</p>
+      the dash, and dropping it onto one of the workspaces on the right-hand
+      side of the screen. The application will open in the chosen
+      workspace.</p>
+      <p>You can launch an application in a <em>new</em> workspace by dragging
+      its icon to the empty workspace at the bottom of the workspace
+      switcher, or to the small gap between two workspaces.</p>
     </item>
   </list>
 
-<note style="tip">
- <title>Quickly running a command</title>
-  <p>Another way of launching an application is to press
-  <keyseq><key>Alt</key><key>F2</key></keyseq>, enter its <em>command name</em>,
-  and then press the <key>Enter</key> key.</p>
-  <p>For example, to launch <app>Rhythmbox</app>, press
-  <keyseq><key>Alt</key><key>F2</key></keyseq> and type 'rhythmbox' (without the
-  single-quotes). The name of the app is the command to launch the program.</p>
-</note>
+  <note style="tip">
+    <title>Quickly running a command</title>
+    <p>Another way of launching an application is to press
+    <keyseq><key>Alt</key><key>F2</key></keyseq>, enter its
+    <em>command name</em>, and then press the <key>Enter</key> key.</p>
+    <p>For example, to launch <app>Rhythmbox</app>, press
+    <keyseq><key>Alt</key><key>F2</key></keyseq> and type
+    '<cmd>rhythmbox</cmd>' (without the single-quotes). The name of the app is
+    the command to launch the program.</p>
+  </note>
 
 </page>
diff --git a/gnome-help/C/shell-exit.page b/gnome-help/C/shell-exit.page
index a5e8785..d81606d 100644
--- a/gnome-help/C/shell-exit.page
+++ b/gnome-help/C/shell-exit.page
@@ -12,6 +12,7 @@
 
     <revision pkgversion="3.6.0" date="2012-09-15" status="review"/>
     <revision pkgversion="3.10" date="2013-11-02" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -32,7 +33,8 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Learn how to leave your user account, by logging out, switching users, and so on.</desc>
+    <desc>Learn how to leave your user account, by logging out, switching
+    users, and so on.</desc>
     <!-- Should this be a guide which links to other topics? -->
   </info>
 
@@ -54,9 +56,10 @@
   yourself logged in and just switch users. If you switch users, all of
   your applications will continue running, and everything will be where you
   left it when you log back in.</p>
-  <p>To <gui>Log Out</gui> or <gui>Switch User</gui>, click the system menu on
-  the right side of the top bar, click your name and then choose the right
-  option.</p>
+
+  <p>To <gui>Log Out</gui> or <gui>Switch User</gui>, click the
+  <link xref="shell-terminology">system menu</link> on the right side of the
+  top bar, click your name and then choose the right option.</p>
 
   <note if:test="!platform:gnome-classic">
     <p>The <gui>Log Out</gui> and <gui>Switch User</gui> entries only appear in
diff --git a/gnome-help/C/shell-introduction.page b/gnome-help/C/shell-introduction.page
index 94b8f5a..957363e 100644
--- a/gnome-help/C/shell-introduction.page
+++ b/gnome-help/C/shell-introduction.page
@@ -10,6 +10,7 @@
 
     <revision pkgversion="3.6.0" version="0.2" date="2012-10-13" status="review"/>
     <revision pkgversion="3.10" date="2013-11-02" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="outdated"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
diff --git a/gnome-help/C/shell-lockscreen.page b/gnome-help/C/shell-lockscreen.page
index 3661234..1005c8f 100644
--- a/gnome-help/C/shell-lockscreen.page
+++ b/gnome-help/C/shell-lockscreen.page
@@ -1,11 +1,12 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic" style="task"
       id="shell-lockscreen">
-  <info>
 
+  <info>
     <link type="guide" xref="shell-overview#desktop" />
 
     <revision pkgversion="3.6.1" version="0.1" date="2012-11-11" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
 
     <credit type="author copyright">
       <name>Michael Hill</name>
@@ -13,24 +14,31 @@
       <years>2012</years>
     </credit>
 
-    <desc>The decorative and functional lock screen conveys useful information.</desc>
+    <desc>The decorative and functional lock screen conveys useful
+    information.</desc>
   </info>
 
   <title>The Lock Screen</title>
-  <p>The lock screen means that you can see what is happening while your computer
- is locked, and it allows you to get a summary of what has been happening while
- you have been away. The lock screen curtain shows an attractive image on the
- screen while your computer is locked, and provides useful information:</p>
+
+  <p>The lock screen means that you can see what is happening while your
+  computer is locked, and it allows you to get a summary of what has been
+  happening while you have been away. The lock screen curtain shows an
+  attractive image on the screen while your computer is locked, and provides
+  useful information:</p>
+
   <list>
     <item><p>the name of the logged-in user</p></item>
     <item><p>date and time, and certain notifications</p></item>
     <item><p>battery and network status</p></item>
-    <item><p>the ability to control media playback - change the volume, skip a track or pause your music 
without having to enter a password</p></item>
+    <item><p>the ability to control media playback - change the volume, skip a
+    track or pause your music without having to enter a password</p></item>
   </list>
 
-<p>To unlock your computer, raise the lock screen curtain by dragging it upward
-with the cursor, or by pressing <key>Esc</key> or <key>Enter</key>. This will
-reveal the login screen, where you can enter your password to unlock. You can
-also switch users if your computer is configured for more than one.</p>
+  <p>To unlock your computer, raise the lock screen curtain by dragging it
+  upward with the cursor, or by pressing <key>Esc</key> or <key>Enter</key>.
+  This will reveal the login screen, where you can enter your password to
+  unlock. Alternatively, just start typing your password and the curtain will
+  be automatically raised as you type. You can also switch users if your
+  computer is configured for more than one.</p>
 
 </page>
diff --git a/gnome-help/C/shell-terminology.page b/gnome-help/C/shell-terminology.page
index 5f1e7bf..32b018b 100644
--- a/gnome-help/C/shell-terminology.page
+++ b/gnome-help/C/shell-terminology.page
@@ -9,6 +9,7 @@
 
     <revision pkgversion="3.8.0" version="0.4" date="2013-04-23" status="outdated"/>
     <revision pkgversion="3.10" date="2013-11-02" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -25,12 +26,13 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>An overview of terms used to describe different parts of the desktop.</desc>
+    <desc>An overview of terms used to describe different parts of the
+    desktop.</desc>
   </info>
 
   <title>Activities, dash, top bar… What are they?</title>
 
-<!-- THIS SHOULD BE ALPHABETICALLY SORTED… it is. -->
+<!-- THIS SHOULD BE ALPHABETICALLY SORTED… -->
 
   <terms>
     <item>
@@ -51,12 +53,6 @@
       the <gui>Activities Overview</gui> item from the menu.</p>
     </item>
     <item>
-      <title>Super-Tab window switcher</title>
-      <p>When you hold down the <key xref="keyboard-key-super">Super</key> key
-      and then press <key>Tab</key>, a <em>window switcher</em> appears. This
-      shows the applications that are currently open.</p>
-    </item>
-    <item>
       <title>Dash</title>
       <p>The <em>dash</em> is the list of your favorite applications that is
       shown on the left-hand side of the <gui>Activities</gui> overview.
@@ -82,8 +78,8 @@
       screen, telling you that something just happened. For example, when
       someone chatting with you sends a message, a notification will pop up to
       tell you. If you don't want to deal with a message right now, it is
-      hidden in your message tray. Move your mouse to the bottom of the screen
-      (or press
+      hidden in your <em>message tray</em>. Move your mouse to the bottom of
+      the screen (or press
       <keyseq><key xref="keyboard-key-super">Super</key><key>M</key></keyseq>)
       to see your message tray.</p>
     </item>
@@ -103,6 +99,12 @@
       then select the <gui>Settings</gui> panel.</p>
     </item>
     <item>
+      <title>Super-Tab window switcher</title>
+      <p>When you hold down the <key xref="keyboard-key-super">Super</key> key
+      and then press <key>Tab</key>, a <em>window switcher</em> appears. This
+      shows the applications that are currently open.</p>
+    </item>
+    <item>
       <title>System menu</title>
       <p>The <em>system menu</em> is on the right side of the top bar. You can
       update some of your settings, find information about your
@@ -118,6 +120,11 @@
       runs along the very top of the screen. The <gui>Applications</gui> menu
       is on one end of the top bar and the system menu is on the other.</p>
     </item>
+    <item if:test="platform:gnome-classic">
+      <title>Window list</title>
+      <p>The <em>window list</em> is the bar at the very bottom of the screen,
+      which shows buttons for all your open windows.</p>
+    </item>
     <item>
       <title>Workspace</title>
       <p>You can put windows on different <em>workspaces</em>. They are a
@@ -129,11 +136,6 @@
       shown on the right-hand side of the <gui>Windows</gui> view in the
       <gui>Activities</gui> overview.</p>
     </item>
-    <item if:test="platform:gnome-classic">
-      <title>Window list</title>
-      <p>The <em>window list</em> is the bar at the very bottom of the screen,
-      which shows buttons for all your open windows.</p>
-    </item>
   </terms>
 
 </page>
diff --git a/gnome-help/C/shell-windows-lost.page b/gnome-help/C/shell-windows-lost.page
index 112cbca..b501929 100644
--- a/gnome-help/C/shell-windows-lost.page
+++ b/gnome-help/C/shell-windows-lost.page
@@ -6,7 +6,9 @@
   <info>
     <link type="guide" xref="shell-windows#working-with-windows"/>
 
-    <revision pkgversion="3.8.0" version="0.3" date="2013-04-23" status="review"/>
+    <revision pkgversion="3.8.0" date="2013-04-23" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
+
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -24,13 +26,13 @@
   <title>Find a lost window</title>
 
   <p>A window on a different workspace, or hidden behind another window, is
-  easily found using the <link xref="shell-terminology"><gui>Activities</gui>
-  overview</link>:</p>
+  easily found using the <gui xref="shell-terminology">Activities</gui>
+  overview:</p>
 
   <list>
     <item>
-      <p>Open the <em><gui>Activities</gui> overview</em>. If the missing
-      window is on the current
+      <p>Open the <gui>Activities</gui> overview. If the missing window is on
+      the current
       <link xref="shell-windows#working-with-workspaces">workspace</link>, it
       will be shown here in thumbnail. Simply click the thumbnail to redisplay
       the window, or</p>
@@ -46,20 +48,28 @@
     </item>
   </list>
 
+  <comment>
+    <cite date="2014-09-22">David King</cite>
+    <p>Mention search providers, especially with reference to gnome-terminal,
+    and how they can be used to find open terminals.</p>
+  </comment>
+
   <p>Using the window switcher:</p>
 
-<list>
- <item>
-  <p>Press <keyseq><key xref="keyboard-key-super">Super</key><key>Tab</key>
-  </keyseq> to display the <link xref="shell-terminology">window switcher</link>.
-  Continue to hold down the <key>Super</key> key and press <key>Tab</key> to
-  cycle through the open windows, or <keyseq><key>Shift</key><key>Tab</key>
-  </keyseq> to cycle backwards.</p>
- </item>
- <item if:test="!platform:gnome-classic">
-  <p>If an application has multiple open windows, hold down <key>Super</key> and
-  press <key>`</key> (or the key above <key>Tab</key>) to step through them.</p>
- </item>
-</list>
+  <list>
+    <item>
+      <p>Press
+      <keyseq><key xref="keyboard-key-super">Super</key><key>Tab</key></keyseq>
+      to display the <link xref="shell-terminology">window switcher</link>.
+      Continue to hold down the <key>Super</key> key and press <key>Tab</key>
+      to cycle through the open windows, or
+      <keyseq><key>Shift</key><key>Tab</key> </keyseq> to cycle backwards.</p>
+    </item>
+    <item if:test="!platform:gnome-classic">
+      <p>If an application has multiple open windows, hold down
+      <key>Super</key> and press <key>`</key> (or the key above <key>Tab</key>)
+      to step through them.</p>
+    </item>
+  </list>
 
 </page>
diff --git a/gnome-help/C/shell-windows-maximize.page b/gnome-help/C/shell-windows-maximize.page
index 015d9c2..f14c1b9 100644
--- a/gnome-help/C/shell-windows-maximize.page
+++ b/gnome-help/C/shell-windows-maximize.page
@@ -7,9 +7,8 @@
     <link type="guide" xref="shell-windows#working-with-windows"/>
     <link type="seealso" xref="shell-windows-tiled"/>
 
-    <desc>Double-click or drag a titlebar to maximize or restore a window.</desc>
-
     <revision pkgversion="3.4.0" date="2012-03-14" status="candidate"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -17,6 +16,9 @@
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Double-click or drag a titlebar to maximize or restore a
+    window.</desc>
   </info>
 
   <title>Maximize and unmaximize a window</title>
@@ -30,8 +32,8 @@
   <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 <key xref="keyboard-key-super">Super</key> key and
-  press <key>&#8593;</key>, or press <keyseq><key>Alt</key><key>F10</key></keyseq>.
-  </p>
+  press <key>&#8593;</key>, or press
+  <keyseq><key>Alt</key><key>F10</key></keyseq>.</p>
 
   <p if:test="platform:gnome-classic">You can also maximize a window by
   clicking the maximize button in the titlebar.</p>
@@ -42,6 +44,8 @@
   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>
+    <p>Hold down the <key>Super</key> key and drag anywhere in a window to move
+    it.</p>
   </note>
+
 </page>
diff --git a/gnome-help/C/shell-windows-states.page b/gnome-help/C/shell-windows-states.page
index d4c9625..b7a39fb 100644
--- a/gnome-help/C/shell-windows-states.page
+++ b/gnome-help/C/shell-windows-states.page
@@ -4,12 +4,10 @@
       id="shell-windows-states">
 
   <info>
-
     <link type="guide" xref="shell-windows#working-with-windows"/>
 
-    <desc>Arrange windows in a workspace to help you work more efficiently.</desc>
-
     <revision pkgversion="3.4.0" date="2012-03-24" status="candidate"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
@@ -18,36 +16,44 @@
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
-  </info>
-
-<title>Move and resize windows</title>
-
-<p>You can move and resize windows to help you work more efficiently.
-In addition to the dragging behavior you might expect, GNOME features
-shortcuts and modifiers to help you arrange windows quickly.</p>
 
-<list>
-<item><p>Move a window by dragging the titlebar, or hold down <key>Alt</key>
-and drag anywhere in the window. Hold down <key>Shift</key> while moving to
-snap the window to the edges of the screen and other windows.</p></item>
-
-<item><p>Resize a window by dragging the edges or corner of the window.
-Hold down <key>Shift</key> while resizing to snap the window to the edges
-of the screen and other windows.</p>
-
-<p if:test="platform:gnome-classic">You can also resize a maximized window by
-clicking the maximize button in the titlebar.</p></item>
-
-<item><p>Move or resize a window using only the keyboard. Press
-<keyseq><key>Alt</key><key>F7</key></keyseq> to move a window or
-<keyseq><key>Alt</key><key>F8</key></keyseq> to resize. Use the arrow keys
-to move or resize, then press <key>Enter</key> to finish, or press
-<key>Esc</key> to return to the original position and size.</p></item>
+    <desc>Arrange windows in a workspace to help you work more
+    efficiently.</desc>
+  </info>
 
-<item><p><link xref="shell-windows-maximize">Maximize a window</link> by
-dragging it to the top of the screen. Drag a window to one side of the
-screen to maximize it along the side, allowing you to <link
-xref="shell-windows-tiled">tile windows side by side</link>.</p></item>
-</list>
+  <title>Move and resize windows</title>
+
+  <p>You can move and resize windows to help you work more efficiently. In
+  addition to the dragging behavior you might expect, GNOME features shortcuts
+  and modifiers to help you arrange windows quickly.</p>
+
+  <list>
+    <item>
+      <p>Move a window by dragging the titlebar, or hold down
+      <key xref="keyboard-key-super">Super</key> and drag anywhere in the
+      window. Hold down <key>Shift</key> while moving to snap the window to the
+      edges of the screen and other windows.</p>
+    </item>
+    <item>
+      <p>Resize a window by dragging the edges or corner of the window. Hold
+      down <key>Shift</key> while resizing to snap the window to the edges
+      of the screen and other windows.</p>
+      <p if:test="platform:gnome-classic">You can also resize a maximized
+      window by clicking the maximize button in the titlebar.</p>
+    </item>
+    <item>
+      <p>Move or resize a window using only the keyboard. Press
+      <keyseq><key>Alt</key><key>F7</key></keyseq> to move a window or
+      <keyseq><key>Alt</key><key>F8</key></keyseq> to resize. Use the arrow
+      keys to move or resize, then press <key>Enter</key> to finish, or press
+      <key>Esc</key> to return to the original position and size.</p>
+    </item>
+    <item>
+      <p><link xref="shell-windows-maximize">Maximize a window</link> by
+      dragging it to the top of the screen. Drag a window to one side of the
+      screen to maximize it along the side, allowing you to
+      <link xref="shell-windows-tiled">tile windows side by side</link>.</p>
+    </item>
+  </list>
 
 </page>
diff --git a/gnome-help/C/shell-windows-switching.page b/gnome-help/C/shell-windows-switching.page
index 57aa642..e8a7ca2 100644
--- a/gnome-help/C/shell-windows-switching.page
+++ b/gnome-help/C/shell-windows-switching.page
@@ -10,6 +10,7 @@
 
     <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
     <revision pkgversion="3.12" date="2014-03-07" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -30,57 +31,62 @@
 
 <comment>
   <cite date="2012-02-19">shaunm</cite>
-  <p>More prose, talk about Alt+`. Maybe a screenshot. 3.0.1</p>
+  <p>More prose. Maybe a screenshot. 3.0.1</p>
 </comment>
+
   <p>You can see all the running applications that have a graphical user
-  interface in the <link xref="shell-terminology"><em>window switcher</em></link>.
-  This makes switching between tasks a single-step process and provides a full
-  picture of which applications are running.</p>
+  interface in the
+  <link xref="shell-terminology"><em>window switcher</em></link>. This makes
+  switching between tasks a single-step process and provides a full picture of
+  which applications are running.</p>
 
   <p>From a workspace:</p>
 
-<steps>
-  <item><p>Press
-  <keyseq><key xref="keyboard-key-super">Super</key><key>Tab</key></keyseq> to
-  bring up the <gui>window switcher</gui>.</p></item>
-  <item><p>Release <key xref="keyboard-key-super">Super</key> to select the next
-  (highlighted) window in the switcher.</p></item>
-  <item><p>Otherwise, still holding down the <key xref="keyboard-key-super">
-  Super</key> key, press <key>Tab</key> to cycle through the list of open
-  windows, or <keyseq><key>Shift</key><key>Tab</key></keyseq> to cycle
-  backwards.</p></item>
-</steps>
-
-<p if:test="platform:gnome-classic">You can also use the window list on the
+  <steps>
+    <item>
+      <p>Press
+      <keyseq><key xref="keyboard-key-super">Super</key><key>Tab</key></keyseq>
+      to bring up the <gui>window switcher</gui>.</p>
+    </item>
+    <item>
+      <p>Release <key xref="keyboard-key-super">Super</key> to select the next
+      (highlighted) window in the switcher.</p>
+    </item>
+    <item>
+      <p>Otherwise, still holding down the <key xref="keyboard-key-super">
+      Super</key> key, press <key>Tab</key> to cycle through the list of open
+      windows, or <keyseq><key>Shift</key><key>Tab</key></keyseq> to cycle
+      backwards.</p>
+    </item>
+  </steps>
+
+  <p if:test="platform:gnome-classic">You can also use the window list on the
   bottom bar to access all your open windows and switch between them.</p>
 
-<note style="tip" if:test="!platform:gnome-classic">
-  <p>Windows in the window switcher are grouped by application. Previews of
-  applications with multiple windows pop down as you click through. Hold down
-  <key xref="keyboard-key-super">Super</key> and press <key>`</key> (or the key
-  above <key>Tab</key>) to step through the list.</p>
-</note>
-
-<note if:test="!platform:gnome-classic">
-  <p>In the window switcher, applications from different workspaces are divided
-  by vertical separators.</p>
-</note>
-
-<list>
-  <item><p>You can also move between the application icons in the window switcher
-  with the <key>&#8594;</key> or <key>&#8592;</key> keys, or select one by
- clicking it with the mouse.</p></item>
-  <item><p>Previews of applications with a single window can be displayed with
-  the <key>&#8595;</key> key.</p></item>
-</list>
-
-<p>From the <gui>Activities</gui> overview:</p>
-<list>
-  <item><p>Click on a <link xref="shell-windows">window</link> to switch to it
-  and leave the overview. If you have multiple
-  <link xref="shell-windows#working-with-workspaces">workspaces</link> open, you
-  can click on each workspace to view the open windows on each workspace.</p>
-  </item>
-</list>
+  <note style="tip" if:test="!platform:gnome-classic">
+    <p>Windows in the window switcher are grouped by application. Previews of
+    applications with multiple windows pop down as you click through. Hold down
+    <key xref="keyboard-key-super">Super</key> and press <key>`</key> (or the
+    key above <key>Tab</key>) to step through the list.</p>
+  </note>
+
+  <note if:test="!platform:gnome-classic">
+    <p>In the window switcher, applications from different workspaces are
+    divided by vertical separators.</p>
+  </note>
+
+  <p>You can also move between the application icons in the window
+  switcher with the <key>&#8594;</key> or <key>&#8592;</key> keys, or
+  select one by clicking it with the mouse.</p>
+
+  <p>Previews of applications with a single window can be displayed with
+  the <key>&#8595;</key> key.</p>
+
+  <p>From the <gui>Activities</gui> overview, click on a
+  <link xref="shell-windows">window</link> to switch to it and leave the
+  overview. If you have multiple
+  <link xref="shell-windows#working-with-workspaces">workspaces</link> open,
+  you can click on each workspace to view the open windows on each
+  workspace.</p>
 
 </page>
diff --git a/gnome-help/C/shell-windows-tiled.page b/gnome-help/C/shell-windows-tiled.page
index 2cca1e3..11b3023 100644
--- a/gnome-help/C/shell-windows-tiled.page
+++ b/gnome-help/C/shell-windows-tiled.page
@@ -3,13 +3,11 @@
       id="shell-windows-tiled">
 
   <info>
-
     <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>
 
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
     <revision pkgversion="3.4.0" date="2012-03-14" status="candidate"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -17,25 +15,28 @@
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Maximize two windows side-by-side.</desc>
   </info>
 
 
 <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>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="keyboard-key-super">Super key</link> and
-press the <key>Left</key> or <key>Right</key> key.</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 <key xref="keyboard-key-super">Super</key> 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>
+  <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>
+  <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 704da4f..8673317 100644
--- a/gnome-help/C/shell-windows.page
+++ b/gnome-help/C/shell-windows.page
@@ -3,12 +3,10 @@
       id="shell-windows">
 
   <info>
-
     <link type="guide" xref="shell-overview#apps" />
 
-    <desc>Move and organize your windows.</desc>
-
     <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -16,17 +14,28 @@
     </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Move and organize your windows.</desc>
   </info>
 
-<title>Windows and workspaces</title>
+  <title>Windows and workspaces</title>
 
   <p>Like other desktops, GNOME uses windows to display your running
-  applications. Using both the <gui>Activities</gui> overview and the
-  <gui>dash</gui>, you can launch new applications and control active windows.</p>
+  applications. Using both the <gui xref="shell-terminology">Activities</gui>
+  overview and the <em>dash</em>, you can launch new applications and control
+  active windows.</p>
+
+  <p>You can also group your applications together within workspaces. Visit the
+  window and workspace help topics below to better learn how to use these
+  features.</p>
 
-  <p>You can also group your applications together within workspaces.
-  Visit the window and workspace help topics below to better
-  learn how to use these features.</p>
+  <comment>
+    <cite date="2014-09-22">David King</cite>
+    <p>Add a page on the dash and move the below content there.
+    shell-apps-favorites discusses favorites in the dash, and shell-apps-open
+    mentions showing the grid of installed applications, and shell-terminology
+    has a section on the dash, but none describe it in much detail.</p>
+  </comment>
 <!-- 
   <p>In the <gui>Activities</gui> overview, the <gui>dash</gui> displays your 
   favorite applications as well as your running applications. 
@@ -46,12 +55,6 @@
   <p>Windows are shown on their corresponding 
   <link xref="shell-windows-workspaces">workspaces</link>.</p>
 -->
-<comment><p>Briefly explain the different window states that exist and how you
-can use and recognize those states. Discuss interesting ways of arranging windows
-(i.e. if there is a "Tile" option or something like that). Mention, in passing,
-how you can move and resize windows in multiple ways.</p>
-<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>
diff --git a/gnome-help/C/shell-workspaces-movewindow.page b/gnome-help/C/shell-workspaces-movewindow.page
index c0fb28e..5e810a8 100644
--- a/gnome-help/C/shell-workspaces-movewindow.page
+++ b/gnome-help/C/shell-workspaces-movewindow.page
@@ -10,6 +10,7 @@
 
     <revision pkgversion="3.8" version="0.3" date="2013-05-10" status="review"/>
     <revision pkgversion="3.10" date="2013-11-04" status="candidate"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -22,7 +23,8 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Go to the <gui>Activities</gui> overview and drag the window to a different workspace.</desc>
+    <desc>Go to the <gui>Activities</gui> overview and drag the window to a
+    different workspace.</desc>
   </info>
 
   <title>Move a window to a different workspace</title>
@@ -31,7 +33,7 @@
     <title>Using the mouse:</title>
     <item>
       <p if:test="!platform:gnome-classic">Open the
-      <link xref="shell-terminology"><gui>Activities</gui> overview</link>.</p>
+      <gui xref="shell-terminology">Activities</gui> overview.</p>
       <p if:test="platform:gnome-classic">Open the
       <gui xref="shell-terminology">Activities Overview</gui> from the
       <link xref="shell-terminology"><gui style="menu">Applications</gui>
@@ -54,12 +56,6 @@
     </item>
   </steps>
 
-  <comment>
-    <cite date="2013-11-04">Kat</cite>
-    <p>TODO: verify that Ctrl+Shift+Alt+Up/Down is supposed to work for moving
-    a window and add if it is.</p>
-  </comment>
-
   <steps>
     <title>Using the keyboard:</title>
     <item>
diff --git a/gnome-help/C/shell-workspaces-switch.page b/gnome-help/C/shell-workspaces-switch.page
index dcc7242..18b3709 100644
--- a/gnome-help/C/shell-workspaces-switch.page
+++ b/gnome-help/C/shell-workspaces-switch.page
@@ -8,6 +8,7 @@
     <link type="seealso" xref="shell-workspaces"/>
 
     <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -50,11 +51,11 @@
   <item>
     <p>Press
     <keyseq><key xref="keyboard-key-super">Super</key><key>Page Up</key></keyseq>
-    to move to a workspace which is above the current workspace in the workspace
-    selector.</p>
+    to move to a workspace which is above the current workspace in the
+    workspace selector.</p>
   </item>
   <item>
-   <p>Press <keyseq><key>Super</key><key>Page Down</key></keyseq> to move to a
+    <p>Press <keyseq><key>Super</key><key>Page Down</key></keyseq> to move to a
     workspace which is below the current workspace in the workspace selector.
     </p>
   </item>
diff --git a/gnome-help/C/shell-workspaces.page b/gnome-help/C/shell-workspaces.page
index 7a5627b..3e7d5e6 100644
--- a/gnome-help/C/shell-workspaces.page
+++ b/gnome-help/C/shell-workspaces.page
@@ -4,13 +4,11 @@
       id="shell-workspaces">
 
   <info>
-
     <link type="guide" xref="shell-windows#working-with-workspaces" group="#first"/>
 
-    <desc>Workspaces are a way of grouping windows on your desktop.</desc>
-
     <revision pkgversion="3.8.0" date="2013-04-23" status="review"/>
     <revision pkgversion="3.10.3" date="2014-01-26" status="review"/>
+    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -19,6 +17,7 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
+    <desc>Workspaces are a way of grouping windows on your desktop.</desc>
   </info>
 
 <title>What is a workspace, and how will it help me?</title>
@@ -46,33 +45,33 @@
 <p>Using workspaces:</p>
 
 <list>
- <item>
-  <p if:test="!platform:gnome-classic">In the <gui>Activities</gui> overview,
-  move your cursor to the right-most side of the screen.</p>
-  <p if:test="platform:gnome-classic">Press the
-  <key xref="keyboard-key-super">Super</key> key to open the
-  <gui>Activities</gui> overview and then move your cursor to the right-most
-  side of the screen.</p>
+  <item>
+    <p if:test="!platform:gnome-classic">In the
+    <gui xref="shell-terminology">>Activities</gui> overview, move your cursor
+    to the right-most side of the screen.</p>
+    <p if:test="platform:gnome-classic">Press the
+    <key xref="keyboard-key-super">Super</key> key to open the
+    <gui>Activities</gui> overview and then move your cursor to the right-most
+    side of the screen.</p>
+  </item>
+  <item>
+    <p if:test="!platform:gnome-classic">A vertical panel will appear showing
+    workspaces in use, plus an empty workspace. This is the
+    <link xref="shell-terminology">workspace selector</link>.</p>
+    <p if:test="platform:gnome-classic">A vertical panel will appear showing
+    available workspaces. This is the <link xref="shell-terminology">workspace
+    selector</link>.</p>
+  </item>
+  <item if:test="!platform:gnome-classic">
+    <p>To add a workspace, drag and drop a window from an existing workspace
+    onto the empty workspace in the <link xref="shell-terminology">workspace
+    selector</link>. This workspace now contains the window you have dropped,
+    and a new empty workspace will appear below it.</p>
+  </item>
+  <item if:test="!platform:gnome-classic">
+    <p>To remove a workspace, simply close all of its windows or move them to
+    other workspaces.</p>
   </item>
- <item>
-  <p if:test="!platform:gnome-classic">A vertical panel will appear showing
-  workspaces in use, plus an empty workspace. This is the 
-  <link xref="shell-terminology">workspace selector</link>.</p>
-  <p if:test="platform:gnome-classic">A vertical panel will appear showing
-  available workspaces. This is the <link xref="shell-terminology">workspace
-  selector</link>.</p>
- </item>
- <item if:test="!platform:gnome-classic">
-  <p>To add a workspace, drag and drop a window from an existing workspace onto
-  the empty workspace in the
-  <link xref="shell-terminology">workspace selector</link>. 
-  This workspace now contains the window you have dropped, and a new empty 
-  workspace will appear below it.</p>
- </item>
- <item if:test="!platform:gnome-classic">
-  <p>To remove a workspace, simply close all of its windows or move them to other
-  workspaces.</p>
- </item>
 </list>
 
 <p if:test="!platform:gnome-classic">There is always at least one workspace.</p>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]