[gnome-user-docs/gnome-3-0] applying patch from M. Hill, shell-* pages.



commit 69df268fba62a16dea685bbce10a9891d930ba27
Author: Michael Hill <mdhillca gmail com>
Date:   Tue Jun 7 15:18:56 2011 -0400

    applying patch from M. Hill, shell-* pages.

 gnome-help/C/shell-windows-lost.page          |   22 +++++---
 gnome-help/C/shell-windows-maximize.page      |   37 +++++++-----
 gnome-help/C/shell-windows-states.page        |   75 ++++++++++++-------------
 gnome-help/C/shell-windows-switching.page     |   39 +++++--------
 gnome-help/C/shell-workspaces-movewindow.page |   21 +++----
 gnome-help/C/shell-workspaces-switch.page     |   12 ++--
 gnome-help/C/shell-workspaces.page            |   17 +++--
 7 files changed, 113 insertions(+), 110 deletions(-)
---
diff --git a/gnome-help/C/shell-windows-lost.page b/gnome-help/C/shell-windows-lost.page
index caf6f67..78ef856 100644
--- a/gnome-help/C/shell-windows-lost.page
+++ b/gnome-help/C/shell-windows-lost.page
@@ -7,7 +7,7 @@
   
     <link type="guide" xref="shell-windows#working-with-windows"/>
     
-    <desc>Check the activities overview or look at other workspaces.</desc>
+    <desc>Check the activities overview or other workspaces.</desc>
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
     <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
     <credit type="author">
@@ -19,22 +19,28 @@
   </info>
 
 <title>Find a lost window</title>
-<p>You may have put the window on a different workspace, or it might be hidden behind another window. You can find it again by using the activities overview.</p>
+<p>A window on a different workspace, or hidden behind another window, is easily found using the <gui>activities overview</gui>:</p>
 
 <steps>
  <item>
-  <p>Open the <link xref="shell-terminology">activities overview</link> and make sure the <gui>Windows</gui> view is selected (rather than <gui>Applications</gui>). If the window you're looking for is on the <link xref="shell-windows#working-with-workspaces">workspace</link> that you're currently using, it will be displayed here. Simply click the window once you've found it to display it again.</p>
+  <p>Open the <link xref="shell-terminology">activities overview</link> and make sure the <gui>Windows</gui> view is selected. 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>
  </item>
  <item>
-  <p>If it is not displayed here, it might be on a different workspace. Click on the different workspaces (in the list on the right-hand side of the screen) to try to find your window.</p>
+  <p>Click on the different workspaces in the <gui>workspace switcher</gui> on the right-hand side of the screen to try to find your window; or</p>
  </item>
  <item>
-  <p>You can also right-click on the application in the dash. All open windows of an application will be listed. You can click on the window you wish to switch to in the list.</p>
+  <p>Right-click on the application in the dash and its open windows will be listed. Click on the window in the list to switch to it.</p>
  </item>
 </steps>
 
-<p>A faster method of finding a window is to use the <keyseq><key>Alt</key><key>Tab</key></keyseq> window switcher. Hold down the <key>Alt</key> key and press <key>Tab</key>. Still holding-down the <key>Alt</key> key, press <gui>Tab</gui> to cycle through the list of open windows, or <keyseq><key>Tab</key><key>Shift</key></keyseq> to cycle through it backwards.</p>
-
-<p>If an application has multiple open windows, there is an arrow below the application icon which is seen when tabbing through the apps. Pressing the down arrow on your keyboard will allow you to tab through the multiple windows.</p>
+<p>Using the <gui>window switcher</gui>:</p>
+<list>
+ <item>
+  <p>Press <keyseq><key>Alt</key><key>Tab</key></keyseq> to display the <gui>window switcher</gui>. Continue to hold down the <key>Alt</key> key and press <key>Tab</key> to cycle through the open windows, or <keyseq><key>Shift</key><key>Tab</key></keyseq> to cycle through it backwards.</p>
+ </item>
+ <item>
+<p>If an application has multiple open windows, press <keyseq><key>Alt</key><key>`</key></keyseq> 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 f757895..f3957ea 100644
--- a/gnome-help/C/shell-windows-maximize.page
+++ b/gnome-help/C/shell-windows-maximize.page
@@ -7,7 +7,7 @@
 
     <link type="guide" xref="shell-windows#working-with-windows"/>
 
-    <desc>Double click on the top title bar.</desc>
+    <desc>Double-click on the title bar.</desc>
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
     <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
     <!-- See shell-windows-states -->
@@ -22,30 +22,35 @@
 
   <title>Maximize and unmaximize (restore) a window</title>
 
-    <p> To maximize or unmaximize a window, you can:</p>
-     <list>
+    <p> To maximize or unmaximize a window:</p>
+<list>
  <item><p>
   Double-click on the title bar of the window.
  </p></item>
-       <item>
-       <p>
-        To maximize a window, click on the <gui>title bar</gui> of an application, and drag it to the top of the screen.  When the <gui>mouse pointer</gui> touches the very top of the screen, the entire screen becomes highlighted.  Release the mouse button to maximize the screen.
-       </p>
-       </item>
-
-      <item>
-       <p>
-        To restore the window to its original size, click on the <gui>title bar</gui> of the application, and drag it down from the <gui>top bar</gui>.  After the window separates from the <gui>top bar</gui> it will restore itself to an unmaximized state.
-       </p>
-      </item>
-    </list>
+</list>
+
+<p>Alternatively, to maximize a window:</p>
+
+<list>
+ <item><p>
+Click on the <gui>title bar</gui> of an application and drag it to the top of the screen.  When the <gui>mouse pointer</gui> touches the top of the screen, the entire screen becomes highlighted.  Release the mouse button to maximize the window.
+ </p></item>
+</list>
+
+<p>To restore the window to its original size:</p>
+
+<list>
+ <item><p>
+Click on the <gui>title bar</gui> of the application, and drag it down from the <gui>top bar</gui>.  After the window separates from the <gui>top bar</gui> it will restore itself to an unmaximized state.
+ </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 needing to click in the <gui>title bar</gui> 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 then press <key>x</key>.
+         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>
 
diff --git a/gnome-help/C/shell-windows-states.page b/gnome-help/C/shell-windows-states.page
index ac62c69..9ca3d46 100644
--- a/gnome-help/C/shell-windows-states.page
+++ b/gnome-help/C/shell-windows-states.page
@@ -18,42 +18,37 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>Window operations and modes</title>
+<title>Window operations</title>
 <comment>
   <cite date="2011-04-04">shaunm</cite>
   <p>Make more task-based. Maybe split up. Overview doesn't seem
   as useful as it could be. Revisit hide/minimize terminology.
   3.0.1.</p>
 </comment>
-<p>
-   Windows work in a very similar way to windows on other operating systems.
-</p>
+<p>Windows can be resized or concealed to suit workflow.</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></comment>
 
 <section id="min-rest-close">
 <title>Minimize, restore and close</title>
 
-<terms>
-
-  <item>
-    <title>Minimize</title>
-    <p> To minimize a window, you can:</p>
+    <p> To minimize or hide a window:</p>
     <list>
       <item>
        <p>
-         Press <keyseq><key>Alt</key><key>Space</key></keyseq> to bring up the window menu.  Then press <key>n</key>.
+         Press <keyseq><key>Alt</key><key>Space</key></keyseq> to bring up the window menu.  Then press <key>n</key>. The window 'disappears' into the top left corner.
        </p>
-       <note>
-         <p> The window 'disappears' into the top left hand corner.  It can be <link xref="shell-windows-lost">retrieved</link> from the <gui>Activities</gui> overview or by pressing <keyseq><key>Alt</key><key>Tab</key></keyseq> to tab through the different open application windows.
+  </item>
+ </list>
+
+    <p>To restore the window:</p>
+    <list>
+      <item>
+         <p>Click on it in the <gui>activities overview</gui> or <link xref="shell-windows-lost">retrieve</link> it from the <gui>window switcher</gui> by pressing <keyseq><key>Alt</key><key>Tab</key></keyseq>.
    </p>
-       </note>
       </item>
     </list>
-  </item>
 
-    <item>
-    <title>Close</title>
     <p> To close the window:</p>
      <list>
       <item>
@@ -72,43 +67,47 @@
        </p>
       </item>
     </list>
-  </item>
-</terms>
+
+
+
 </section>
 
 <section id="resize">
-<title>Resize a window</title>
+<title>Resize</title>
 
 <note style="important">
  <p>
-   To resize a window, your window first needs to be <em>unmaximized</em>.
+   A window cannot be resized if it is <em>maximized</em>.
  </p>
 </note>
-<p>
-   The simplest way to resize your window in the horizontal and/or vertical direction is to move the mouse pointer up to the top left corner of the window until it changes into a 'corner-pointer'.  When it becomes a 'corner-pointer', click+hold+drag to resize the window in any direction.
+<p>To resize your window horizontally and/or vertically:</p>
+<list>
+ <item>
+ <p>Move the mouse pointer into any corner of the window until it changes into a 'corner-pointer'. Click+hold+drag to resize the window in any direction.
 </p>
-
-<p>
-You can also resize only in the horizontal direction by moving the mouse pointer to the left side of the window until it changes into a 'side-pointer'.   When it becomes a 'side-pointer', click+hold+drag to resize the window in the horizontal direction.
+ </item>
+</list>
+<p>To resize only in the horizontal direction:</p>
+<list>
+ <item>
+ <p>Move the mouse pointer to either side of the window until it changes into a 'side-pointer'.   Click+hold+drag to resize the window horizontally.
 </p>
+ </item>
+</list>
+<p>To resize only in the vertical direction:</p>
+<list>
+ <item>
+ <p>Move the mouse pointer to the top or bottom of the window until it changes into a 'top-pointer' or 'bottom-pointer' respectively.   Click+hold+drag to resize the window vertically.
+ </p>
+ </item>
+</list>
 
-<p>
-To resize in the vertical direction, move the mouse pointer to the top or bottom of the window until it changes into a 'top-pointer' or 'bottom-pointer' respectively.   When it does, click+hold+drag to resize the window in the vertical direction.
-</p>
 </section>
 
 <section id="arrange">
-<title>Ways to arrange windows in your workspace</title>
-<p>
-  You can automatically arrange two windows side by side.  <key>Alt</key> + click and drag one window towards the left until the cursor touches the left side of the screen.  The left half of the screen becomes highlighted.  Unclick, and your window should automatically take up exactly half your screen.  Do the same thing for another window, dragging it to the right side.
+<title>Arranging windows in your workspace</title>
+<p>Two windows can be arranged side by side for easy comparison.  Drag a window by its titlebar toward the left side of the screen: the left half of the screen becomes highlighted.  Unclick, and the window resizes to fill half the screen.  Repeat for another window, dragging it to the right side and releasing.
   </p>
 </section>
 
-<section id="hide">
-<title>Hide windows from view</title>
-<p>
-  To hide a window from view, you can just <link xref="shell-windows-states#min-rest-close">minimize</link> it.  It will 'disappear' into the top left hand corner of the window.  To be able to access it, enter the <gui>Activities</gui> view.
-</p>
-</section>
-
 </page>
diff --git a/gnome-help/C/shell-windows-switching.page b/gnome-help/C/shell-windows-switching.page
index face174..a12dbe3 100644
--- a/gnome-help/C/shell-windows-switching.page
+++ b/gnome-help/C/shell-windows-switching.page
@@ -26,51 +26,44 @@
   <p>More prose, talk about Alt+`. Maybe a screenshot. 3.0.1</p>
 </comment>
 
-<terms>
+<p>From a workspace:</p>
 
- <item>
-    <title>From a workspace:</title>
 <list>
 <item><p>
-Press <keyseq><key>Alt</key><key>Tab</key></keyseq> to switch between windows.
-</p>
+Press <keyseq><key>Alt</key><key>Tab</key></keyseq> to bring up the <gui>window switcher</gui>. Including all applications in the <gui>window switcher</gui> makes switching between tasks a single-step process and provides a full picture of what applications are running.</p></item>
+<item><p>Release the <key>Alt</key> to select the next (highlighted) window in the switcher.</p></item>
+<item><p>Otherwise, still holding-down the <key>Alt</key> key, press <gui>Tab</gui> to cycle through the list of open windows, or <keyseq><key>Tab</key><key>Shift</key></keyseq> to cycle through it backwards.</p>
+</item>
+</list>
 
 <note style="tip">
 <p>
- The windows are grouped by application and the previews of the applications with multiple windows are available as you click through. The previews show up after a short delay, but you can get them immediately by clicking the â?? arrow key. 
+ Windows in the <gui>window switcher</gui> are grouped by application; previews of applications with multiple windows pop down as you click through. Press <keyseq><key>Alt</key><key>`</key></keyseq> to step through the list. 
 </p>
 </note>
 
-
 <note>
 <p>
-The applications running on other workspaces are displayed after a vertical separator. Including all applications in the <keyseq><key>Alt</key><key>Tab</key></keyseq> makes switching between tasks a single step process and provides you with a full picture of what applications are running. 
+In the <gui>window switcher</gui>, applications from different workspaces are divided by vertical separators.
 </p>
 </note>
-</item>
 
+<list>
 <item><p> 
-You can move between the preview windows with the â?? or â?? arrow keys or with the mouse pointer.
-</p></item>
-<item><p> 
- Previews of applications with a single window are only available when the â?? arrow is explicitly hit. 
+You can also move between the application icons in the <gui>window switcher</gui> with the â?? or â?? arrow keys, or by clicking it with the mouse.
 </p></item>
 <item><p> 
- 
-     It is possible to switch to any window by moving to it with the mouse and clicking. 
+ Previews of applications with a single window can be displayed with the â?? arrow key. 
 </p></item>
 </list>
 
-</item>
-
-
-
-<item>
-  <title>From the <gui>Activities</gui> overview:</title>
-<p>
+<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>
-</terms>
+</list>
 
 </page>
diff --git a/gnome-help/C/shell-workspaces-movewindow.page b/gnome-help/C/shell-workspaces-movewindow.page
index 3862dfd..98f5e3a 100644
--- a/gnome-help/C/shell-workspaces-movewindow.page
+++ b/gnome-help/C/shell-workspaces-movewindow.page
@@ -21,38 +21,35 @@
     
   </info>
 
-<title>Move windows to a different workspace</title>
+<title>Move a window to a different workspace</title>
 
-<p>You can move a window between workspaces:</p>
+<p>Using the mouse:</p>
 
 <steps>
  <item>
   <p>Open the <gui>Activities</gui> overview and make sure you're looking at the <gui>Windows</gui> view.</p>
  </item>
  <item>
-  <p>Click and drag the window to the right of the screen.</p>
+  <p>Click and drag the window toward the right of the screen.</p>
  </item>
  <item>
-  <p>The panel with the workspaces will appear.</p>
+  <p>The <gui>workspace selector</gui> will appear.</p>
  </item>
  <item>
-  <p>Drop the window onto the empty workspace. This will move the window to a new workspace and a new empty workspace will be created.</p>
+  <p>Drop the window onto an empty workspace.  This workspace now contains the window you dropped into it, and a new empty workspace appears at the bottom of the workspace panel.</p>
  </item>
 </steps>
 
-<p>A faster way of moving windows between workspaces is by using the keyboard:</p>
+<p>Using the keyboard:</p>
+
 <steps>
  <item><p>Click on the window to make it <em>live</em>.</p></item>
  <item>
-  <list>
-   <item>
-    <p>Press <keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>&#8593;</key></keyseq> to move the window to a workspace which is above the current workspace.</p>
+    <p>Press <keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>&#8593;</key></keyseq> to move the window to a workspace which is above the current workspace the <gui>workspace selector</gui>.</p>
    </item>
    <item>
-    <p>Press <keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>	&#8595;</key></keyseq> to move the window to a workspace which is below the current workspace.</p>
+    <p>Press <keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>	&#8595;</key></keyseq> to move the window to a workspace which is below the current workspace the <gui>workspace selector</gui>.</p>
    </item>
-  </list>
- </item>
 </steps>
 
 </page>
diff --git a/gnome-help/C/shell-workspaces-switch.page b/gnome-help/C/shell-workspaces-switch.page
index ea20a79..950a106 100644
--- a/gnome-help/C/shell-workspaces-switch.page
+++ b/gnome-help/C/shell-workspaces-switch.page
@@ -8,7 +8,7 @@
     <link type="guide" xref="shell-windows#working-with-workspaces"/>
     <link type="seealso" xref="shell-workspaces"/>
     
-    <desc>Go to the Activities overview and click one of the workspaces in the list on the right-hand side of the screen.</desc>
+    <desc>Use the <gui>workspace switcher</gui> in the Activities overview.</desc>
 
     <revision pkgversion="3.0" date="2011-04-04" status="final"/>
     <revision pkgversion="3.0" version="3.0.1" date="2011-04-06" status="outdated"/>
@@ -25,21 +25,21 @@
 
 <terms>
 <item>
- <title>From the <gui>Activities</gui> overview:</title>
- <p>If you have multiple workspaces open, you can click on each workspace to view the open windows on each workspace.</p>
+ <title>Using the mouse:</title>
+ <p>In the <gui>Activities</gui> overview, click on a workspace in the <gui>workspace switcher</gui> on the right side of the screen to view the open windows on that workspace. Click on any window thumbnail to activate the workspace.</p>
 </item>
 
 <item>
- <title>From workspace and <gui>Activity</gui> overview:</title>
+ <title>Using the keyboard:</title>
  
  <list>
   <item>
    <p>
-Press <keyseq><key>Ctrl</key><key>Alt</key><key>&#8593;</key></keyseq> to move to a workspace which is above the current workspace.
+Press <keyseq><key>Ctrl</key><key>Alt</key><key>&#8593;</key></keyseq> to move to a workspace which is above the current workspace in the <gui>workspace switcher</gui>.
    </p>
   </item>
   <item>
-   <p>Press <keyseq><key>Ctrl</key><key>Alt</key><key>&#8595;</key></keyseq> to move to a workspace which is below the current workspace.</p>
+   <p>Press <keyseq><key>Ctrl</key><key>Alt</key><key>&#8595;</key></keyseq> to move to a workspace which is below the current workspace in the <gui>workspace switcher</gui>.</p>
   </item>
  </list>
  
diff --git a/gnome-help/C/shell-workspaces.page b/gnome-help/C/shell-workspaces.page
index 7030f91..5da044f 100644
--- a/gnome-help/C/shell-workspaces.page
+++ b/gnome-help/C/shell-workspaces.page
@@ -28,16 +28,19 @@
 
 <p>Workspaces refer to the grouping of windows on your desktop. You can create many workspaces, which act like virtual desktops. Workspaces are meant to reduce clutter and make the desktop easier to navigate.</p>
 
-<p>You could use workspaces to organize your work. For example, you could have all your communication windows, such as e-mail and your chat program on one workspace and the work you are doing on a different workspace. Your music manager could be on a third workspace.</p>
-
- <p>In the <gui>Activities</gui> overview, move your cursor to the right-most side of the screen. A vertical panel will appear with your current workspaces plus an extra empty (having no open application windows on it) workspace.
- </p>
- <list>
+<p>Workspaces can be used to organize your work. For example, you could have all your communication windows, such as e-mail and your chat program on one workspace and the work you are doing on a different workspace. Your music manager could be on a third workspace.</p>
+
+<p>Using workspaces:</p>
+ 
+<list>
+ <item>
+ <p>In the <gui>activities overview</gui>, move your cursor to the right-most side of the screen. A vertical panel will appear showing workspaces in use, plus an empty workspace. This is the <gui>workspace switcher</gui>.
+ </p></item>
  <item><p>
-  To add a workspace, move a window from an existing workspace onto the empty workspace in the right panel.  To do this, click on an application window in a workspace and drag and drop it onto the empty workspace.  This workspace now contains the window you dropped into it, and a new empty workspace should appear at the bottom of the workspace panel.
+  To add a workspace, drag and drop a window from an existing workspace onto the empty workspace in the switcher. This workspace now contains the window you dropped into it, and a new empty workspace will appear below it.
   </p></item>
   <item><p>
-   To remove a workspace simply close all the window in it, or move the window onto a previous workspace.
+   To remove a workspace simply close all of its windows or move them to other workspaces.
    </p>
    </item>
 </list>



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