GNOME.org
 

[gnome-user-docs] shell pages reviewed for 3.4.0

commit 1909f0278b0651c56f07551f03eb75f5a2afd338
Author: Michael Hill <mdhillca gmail com>
Date:   Mon Feb 20 12:30:38 2012 -0500

    shell pages reviewed for 3.4.0

 gnome-help/C/screen-shot-record.page               |    6 ++--
 gnome-help/C/shell-apps-search.page.old            |    2 +-
 gnome-help/C/shell-introduction.page               |   16 ++++++-----
 gnome-help/C/shell-keyboard-shortcuts.page         |   26 +++++++++++------
 gnome-help/C/shell-notifications.page              |   25 +++++++++++-----
 gnome-help/C/shell-overview.page                   |    2 +-
 ...-status.page => shell-session-status.page.stub} |    2 +-
 gnome-help/C/shell-windows-lost.page               |    2 +-
 gnome-help/C/shell-windows-maximize.page           |    2 +-
 gnome-help/C/shell-windows-states.page             |   24 ++++++++++++----
 gnome-help/C/shell-windows-switching.page          |    2 +-
 gnome-help/C/shell-windows-tiled.page              |   29 +++++++++++--------
 gnome-help/C/shell-windows.page                    |    2 +-
 gnome-help/C/shell-workspaces-movewindow.page      |   27 +++++++++++-------
 gnome-help/C/shell-workspaces-switch.page          |    2 +-
 gnome-help/C/shell-workspaces.page                 |    2 +-
 16 files changed, 106 insertions(+), 65 deletions(-)
---
diff --git a/gnome-help/C/screen-shot-record.page b/gnome-help/C/screen-shot-record.page
index 5ada37f..a898909 100644
--- a/gnome-help/C/screen-shot-record.page
+++ b/gnome-help/C/screen-shot-record.page
@@ -7,7 +7,7 @@
     <link type="guide" xref="tips"/>
     
     <desc>Take a picture or record a video of what's happening on your screen.</desc>
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski gmail com</email>
@@ -68,7 +68,7 @@
 
 <steps>
 <item>
-  <p>Press <keyseq><key>Control</key><key>Shift</key><key>Alt</key><key>R</key></keyseq>
+  <p>Press <keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>R</key></keyseq>
  to start recording what's on your screen.</p>
   <p>A red circle is displayed in the bottom right corner of the screen when the
  recording is in progress.</p>
@@ -76,7 +76,7 @@
 
 <item>
   <p>Once you've finished, press
- <keyseq><key>Control</key><key>Shift</key><key>Alt</key><key>R</key></keyseq>
+ <keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>R</key></keyseq>
  again to stop the recording.</p>
 </item>
 
diff --git a/gnome-help/C/shell-apps-search.page.old b/gnome-help/C/shell-apps-search.page.old
index f687e75..84c9f24 100644
--- a/gnome-help/C/shell-apps-search.page.old
+++ b/gnome-help/C/shell-apps-search.page.old
@@ -5,7 +5,7 @@
   <info>
     <link type="guide" xref="index#apps"/>
     <desc>In the <gui>Activities</gui> overview...</desc>
-    <revision pkgversion="3.0" version="0.1" date="2011-02-26" status="candidate"/>
+    <revision pkgversion="3.0" version="0.1" date="2011-02-26" status="outdated"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
diff --git a/gnome-help/C/shell-introduction.page b/gnome-help/C/shell-introduction.page
index 40bc4c8..9a7bdda 100644
--- a/gnome-help/C/shell-introduction.page
+++ b/gnome-help/C/shell-introduction.page
@@ -10,7 +10,7 @@
     <desc>A visual introduction to your desktop, the top bar, and the
     activities overview.</desc>
     
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -68,12 +68,13 @@ folders.</p>
 
 <p>On the left of the overview, you will find the <em>dash</em>. The dash
 shows you your favorite and running applications. Click any icon in the
-dash to open that application. If the application is already running,
-clicking the icon will bring up the most recently used window.</p>
+dash to open that application; if the application is already running, it will be
+highlighted. Clicking its icon will bring up the most recently used window. You
+can also drag the icon to the overview, or onto any workspace on the right.</p>
 
-<p>To pick a window in a running application, or to open a new window,
-right-click on the application icon. You can also drag the icon to the
-overview, or onto any workspace thumbnail on the right.</p>
+<p>Right-clicking the icon displays a menu that allows you to pick any window in
+a running application, or to open a new window. You can also click the icon
+while holding down <key>Ctrl</key> to open a new window.</p>
 
 <p>When you enter the overview, you will initially be in the windows overview.
 This shows you live thumbnails of all the windows on the current workspace.
@@ -107,7 +108,8 @@ You can also access the date and time settings and open your full
 <app>Evolution</app> calendar directly from the menu.</p>
 
 <list style="compact">
-  <item><p><link xref="clock-calendar">Learn more about the calendar and appointments.</link></p></item>
+  <item><p><link xref="clock-calendar">Learn more about the calendar and
+   appointments.</link></p></item>
 </list>
 </section>
 
diff --git a/gnome-help/C/shell-keyboard-shortcuts.page b/gnome-help/C/shell-keyboard-shortcuts.page
index 0c71047..03fd6c9 100644
--- a/gnome-help/C/shell-keyboard-shortcuts.page
+++ b/gnome-help/C/shell-keyboard-shortcuts.page
@@ -7,7 +7,7 @@
     <link type="guide" xref="keyboard"/>
     <link type="guide" xref="shell-overview"/>
     <desc>Get around the desktop using the keyboard.</desc>
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -19,8 +19,9 @@
 <title>Useful keyboard shortcuts</title>
 
 <comment>
-  <p>In 3.2, can't get Ctrl-Alt-D to work in *any* distro.</p>
+  <p>In 3.4 and below, can't get Ctrl-Alt-D to work in *any* distro.</p>
 </comment>
+
 <table rules="rows" frame="top bottom" ui:expanded="yes">
 <title>Getting around the desktop</title>
   <tr>
@@ -29,11 +30,13 @@
     <td><p>Switch between the <gui>Activities</gui> overview and desktop.</p></td>
   </tr>
   <tr>
-    <td><p><keyseq><key>Alt</key><key>F2</key></keyseq></p></td> <td><p>Pop up command window (for quickly running commands)</p></td>
+    <td><p><keyseq><key>Alt</key><key>F2</key></keyseq></p></td> <td><p>Pop up
+     command window (for quickly running commands)</p></td>
   </tr>
   <tr>
     <td><p><keyseq><key>Alt</key><key>Tab</key></keyseq></p></td>
-    <td><p><link xref="shell-windows-switching">Quickly switch between windows.</link>
+    <td><p><link xref="shell-windows-switching">Quickly switch between
+     windows.</link>
     Hold down <key>Shift</key> for reverse order.</p></td>
   </tr>
   <tr>
@@ -53,16 +56,19 @@
 <!--
  <tr>
     <td><p><keyseq><key>Ctrl</key><key>Alt</key><key>D</key></keyseq></p></td>
-    <td><p>Hide all windows and show the desktop. This shortcut may not work on all distros.</p></td>
+    <td><p>Hide all windows and show the desktop. This shortcut may not work on
+     all distros.</p></td>
   </tr>
 -->
   <tr>
     <td><p><keyseq><key>Ctrl</key><key>Alt</key><key>Up/Down</key></keyseq></p></td>
-    <td><p><link xref="shell-workspaces-switch">Switch between workspaces.</link></p></td>
+    <td><p><link xref="shell-workspaces-switch">Switch between
+     workspaces.</link></p></td>
   </tr>
   <tr>
     <td><p><keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>Up/Down</key></keyseq></p></td>
-    <td><p><link xref="shell-workspaces-movewindow">Move the current window to a different workspace.</link></p></td>
+    <td><p><link xref="shell-workspaces-movewindow">Move the current window to a
+     different workspace.</link></p></td>
   </tr>
   <tr>
     <td><p><keyseq><key>Ctrl</key><key>Alt</key><key>L</key></keyseq></p></td>
@@ -102,11 +108,13 @@
   </tr>
   <tr>
     <td><p><keyseq><key>Alt</key><key>Print</key></keyseq></p></td>
-    <td><p><link xref="screen-shot-record#screenshot">Take a screenshot of a window.</link></p></td>
+    <td><p><link xref="screen-shot-record#screenshot">Take a screenshot of a
+     window.</link></p></td>
   </tr>
   <tr>
     <td><p><keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>R</key></keyseq></p></td>
-    <td><p><link xref="screen-shot-record#screencast">Start and end screencast recording.</link></p></td>
+    <td><p><link xref="screen-shot-record#screencast">Start and end screencast
+     recording.</link></p></td>
   </tr>
 </table>
 
diff --git a/gnome-help/C/shell-notifications.page b/gnome-help/C/shell-notifications.page
index 00d439f..870476c 100644
--- a/gnome-help/C/shell-notifications.page
+++ b/gnome-help/C/shell-notifications.page
@@ -9,7 +9,7 @@
     <desc>Messages pop-up at the bottom of the screen telling you when certain
     events happen.</desc>
 
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
 
     <credit type="author">
       <name>Marina Zhurakhinskaya</name>
@@ -25,17 +25,24 @@
 <title>What is a notification?</title>
   <p>If an application or a system component wants to get your attention, a
  notification will be shown at the bottom of the screen.</p>
-  <p>For example, if you get a new chat message, new updates are available for
- your computer, or your computerâs battery is low, you will get a notification
- informing you.</p>
-  <p>To minimize distraction, the notification will first appear as a single
- line. You can move your mouse over it if you want to see its full content.</p>
+  <p>For example, if you get a new chat message, plug in an external device
+ (like a USB stick), new updates are available for your computer, or your
+ computerâs battery is low, you will get a notification informing you.</p>
+  <p>To minimize distraction, some notifications first appear as a single
+ line. You can move your mouse over them to see their full content.</p>
 
 <media type="image" width="700" src="figures/shell-notification.png"/>
 
+  <p>Other notifications have selectable option buttons. To close one of these
+ notifications without selecting one of its options, click anywhere on the
+ notification.</p>
+
+<media type="image" width="500" src="figures/notification-buttons.png"/>
+
 </section>
 
 <section id="messagingtray">
+
 <title>The message tray</title>
   <p>The message tray gives you a way to get back to your notifications when it
  is convenient for you. It appears when you move your mouse to the bottom right
@@ -47,8 +54,10 @@
  you the chat messages.</p>
   <p>The message tray is always visible in the activities overview.</p>
 
-  <note style="tip"><p>If the <link xref="keyboard-osk">screen keyboard</link> is open,
- you'll need to click the <gui>tray button</gui> to show the message tray.</p></note>
+  <note style="tip"><p>If the <link xref="keyboard-osk">screen keyboard</link>
+   is open, you'll need to click the <gui>tray button</gui> to show the message
+   tray.</p>
+  </note>
 
 </section>
 
diff --git a/gnome-help/C/shell-overview.page b/gnome-help/C/shell-overview.page
index 7107d9c..cb21529 100644
--- a/gnome-help/C/shell-overview.page
+++ b/gnome-help/C/shell-overview.page
@@ -15,7 +15,7 @@
       <link xref="shell-notifications">notifications</link>...
     </desc>
 
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
diff --git a/gnome-help/C/shell-session-status.page b/gnome-help/C/shell-session-status.page.stub
similarity index 94%
rename from gnome-help/C/shell-session-status.page
rename to gnome-help/C/shell-session-status.page.stub
index ae2fa92..58ca839 100644
--- a/gnome-help/C/shell-session-status.page
+++ b/gnome-help/C/shell-session-status.page.stub
@@ -9,7 +9,7 @@
     
     <desc>Change your chat status.</desc>
 
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="stub"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
diff --git a/gnome-help/C/shell-windows-lost.page b/gnome-help/C/shell-windows-lost.page
index 025ad5c..74e8cb3 100644
--- a/gnome-help/C/shell-windows-lost.page
+++ b/gnome-help/C/shell-windows-lost.page
@@ -8,7 +8,7 @@
     <link type="guide" xref="shell-windows#working-with-windows"/>
     
     <desc>Check the activities overview or other workspaces.</desc>
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
diff --git a/gnome-help/C/shell-windows-maximize.page b/gnome-help/C/shell-windows-maximize.page
index 5e50a16..2a00407 100644
--- a/gnome-help/C/shell-windows-maximize.page
+++ b/gnome-help/C/shell-windows-maximize.page
@@ -10,7 +10,7 @@
     <desc>Double-click on the title bar.</desc>
     <!-- See shell-windows-states -->
     
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
diff --git a/gnome-help/C/shell-windows-states.page b/gnome-help/C/shell-windows-states.page
index 385f221..f5483c5 100644
--- a/gnome-help/C/shell-windows-states.page
+++ b/gnome-help/C/shell-windows-states.page
@@ -8,7 +8,7 @@
 
     <desc>Restore, resize, arrange and hide.</desc>
     
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -104,12 +104,24 @@
 
 <title>Arranging windows in your workspace</title>
 
-  <p>Two windows can be placed side by side.  Drag a window by its titlebar
- toward the left side of the screen until the cursor touches the left side. 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>
+<p>To place two windows side by side:</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>
+    
 </section>
 
 </page>
diff --git a/gnome-help/C/shell-windows-switching.page b/gnome-help/C/shell-windows-switching.page
index a8d3c01..e35566f 100644
--- a/gnome-help/C/shell-windows-switching.page
+++ b/gnome-help/C/shell-windows-switching.page
@@ -9,7 +9,7 @@
     <link type="guide" xref="shell-overview#apps"/>
     
     <desc>Press <keyseq><key>Alt</key><key>Tab</key></keyseq>.</desc>
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
diff --git a/gnome-help/C/shell-windows-tiled.page b/gnome-help/C/shell-windows-tiled.page
index d33843e..d5b59bb 100644
--- a/gnome-help/C/shell-windows-tiled.page
+++ b/gnome-help/C/shell-windows-tiled.page
@@ -9,7 +9,7 @@
 
     <desc>"Maximize" two windows side by side.</desc>
     
-    <revision pkgversion="3.4.0" version="3.0.1" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
     <credit type="author">
       <name>GNOME Documentation Project</name>
       <email>gnome-doc-list gnome org</email>
@@ -20,22 +20,27 @@
 
 
 <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>
+
+<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>
+ <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 needing to click in the <gui>title bar</gui> of an application.
-      </p>
+      <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>
 
 </page>
diff --git a/gnome-help/C/shell-windows.page b/gnome-help/C/shell-windows.page
index 8b79517..92dc238 100644
--- a/gnome-help/C/shell-windows.page
+++ b/gnome-help/C/shell-windows.page
@@ -8,7 +8,7 @@
 
     <desc>Move and organize your windows.</desc>
 
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
diff --git a/gnome-help/C/shell-workspaces-movewindow.page b/gnome-help/C/shell-workspaces-movewindow.page
index 5c431dd..4b435c4 100644
--- a/gnome-help/C/shell-workspaces-movewindow.page
+++ b/gnome-help/C/shell-workspaces-movewindow.page
@@ -11,7 +11,7 @@
     <desc>Go to the Activities overview and drag the window to a different 
     workspace.</desc>
 
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
@@ -47,16 +47,21 @@
 <p>Using the keyboard:</p>
 
 <steps>
- <item><p>Cycle through the windows by pressing <keyseq><key>Alt</key><key>Tab</key></keyseq> and <key>&#8595;</key> to select the window you want to move.</p></item>
- <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 on 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 on the
- <gui>workspace selector</gui>.</p>
+  <item><p>Select the window you want to move (e.g. using the
+   <keyseq><key>Alt</key><key>Tab</key></keyseq>
+   <link xref="shell-terminology">window switcher</link>).</p>
+  </item>
+  <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 on
+      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 on
+      the <gui>workspace selector</gui>.</p>
    </item>
 </steps>
 
diff --git a/gnome-help/C/shell-workspaces-switch.page b/gnome-help/C/shell-workspaces-switch.page
index cd21b2a..83a3ae8 100644
--- a/gnome-help/C/shell-workspaces-switch.page
+++ b/gnome-help/C/shell-workspaces-switch.page
@@ -10,7 +10,7 @@
     
     <desc>Use the workspace selector in the Activities overview.</desc>
 
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
diff --git a/gnome-help/C/shell-workspaces.page b/gnome-help/C/shell-workspaces.page
index 7dfd74f..53f977b 100644
--- a/gnome-help/C/shell-workspaces.page
+++ b/gnome-help/C/shell-workspaces.page
@@ -8,7 +8,7 @@
     
     <desc>Workspaces are a way of grouping windows on your desktop.</desc>
 
-    <revision pkgversion="3.4.0" date="2012-02-19" status="outdated"/>
+    <revision pkgversion="3.4.0" date="2012-02-19" status="review"/>
 
     <credit type="author">
       <name>GNOME Documentation Project</name>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]