[gnome-user-docs] g-h: Wrote sound-alert and a11y-visualalert

[Shaun McCance <shaunm src gnome org>]

commit 3bb0a44b3dce194e91aeaf580d8f2387839581a3
Author: Shaun McCance <shaunm gnome org>
Date:   Thu Mar 31 00:01:25 2011 -0400

    g-h: Wrote sound-alert and a11y-visualalert

 gnome-help/C/a11y-visualalert.page |   21 ++++++++++++++++++++-
 gnome-help/C/media.page            |    1 +
 gnome-help/C/sound-alert.page      |   23 +++++++++++++++++++++--
 3 files changed, 42 insertions(+), 3 deletions(-)
---
diff --git a/gnome-help/C/a11y-visualalert.page b/gnome-help/C/a11y-visualalert.page
index 418df9a..e86ae7f 100644
--- a/gnome-help/C/a11y-visualalert.page
+++ b/gnome-help/C/a11y-visualalert.page
@@ -3,8 +3,9 @@
       id="a11y-visualalert">
   <info>
     <link type="guide" xref="a11y#sound"/>
+    <link type="seealso" xref="sound-alert"/>
 
-    <revision pkgversion="3.0" date="2011-03-26" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-30" status="candidate"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
@@ -16,4 +17,22 @@
   </info>
 
   <title>Flash the screen for alert sounds</title>
+
+  <p>Your computer will play a simple alert sound for certain types of
+  messages and events. If you have a hard time hearing these sounds, you
+  can have either the entire screen or your current window visually flash
+  whenever the alert sound is played.</p>
+
+  <p>This can also be useful if you're in an environment where you need your
+  computer to be silent, such as in a library. See <link xref="sound-alert"/>
+  to learn how to mute the alert sound, then enable visual alerts.</p>
+
+  <steps>
+    <item><p>Click your name in the top bar and select <gui>System Settings</gui>.</p></item>
+    <item><p>Click <gui>Universal Access</gui>.</p></item>
+    <item><p>On the <gui>Hearing</gui> tab, switch on <gui>Visual Alerts</gui>.
+    Select whether you want the entire screen or just your current window
+    to flash.</p></item>
+  </steps>
+
 </page>
diff --git a/gnome-help/C/media.page b/gnome-help/C/media.page
index 75924dd..08b23b3 100644
--- a/gnome-help/C/media.page
+++ b/gnome-help/C/media.page
@@ -23,6 +23,7 @@
 <title>Sound, video &amp; pictures</title>
 
 <section id="sound" style="2column">
+ <info><title type="link" role="trail">Sound</title></info>
  <title>Basic sound</title>
 </section>
 
diff --git a/gnome-help/C/sound-alert.page b/gnome-help/C/sound-alert.page
index 7f0d918..274733b 100644
--- a/gnome-help/C/sound-alert.page
+++ b/gnome-help/C/sound-alert.page
@@ -3,15 +3,34 @@
       id="sound-alert">
   <info>
     <link type="guide" xref="media#sound"/>
-    <revision pkgversion="3.0" date="2011-03-21" status="stub"/>
+    <revision pkgversion="3.0" date="2011-03-30" status="candidate"/>
 
     <credit type="author">
       <name>Shaun McCance</name>
       <email>shaunm gnome org</email>
     </credit>
 
-    <desc></desc>
+    <desc>Choose the sound to play for messages, set the alert
+    volume, or disable alert sounds.</desc>
   </info>
 
   <title>Choose or disable the alert sound</title>
+
+  <p>Your computer will play a simple alert sound for certain types of
+  messages and events. You can choose different sound clips for alerts,
+  set the alert volume independently of your system volume, or disable
+  alert sounds entirely.</p>
+
+  <steps>
+    <item><p>Click your name in the top bar and select <gui>System Settings</gui>.</p></item>
+    <item><p>Click <gui>Sound</gui>.</p></item>
+    <item><p>On the <gui>Sound Effects</gui> tab, select an alert sound. Each sound
+    will play when you click on it so you can hear what it sounds like.</p></item>
+  </steps>
+
+  <p>Use the volume slider on the <gui>Sound Effects</gui> tab to set
+  the volume of the alert sound. This won't affect the volume of your
+  music, movies, and other audio playback.</p>
+
+  <p>To disable alert sounds entirely, just select <gui>Mute</gui>.</p>
 </page>