[orca] Continued work on bug 631123 - Orca documentation needs to be updated, converted to Mallard, augment

[Joanmarie Diggs <joanied src gnome org>]

commit 20076b22ff9c3201568a1d6df8a1fc0e03de4601
Author: Joanmarie Diggs <joanmarie diggs gmail com>
Date:   Fri Dec 17 18:07:36 2010 -0500

    Continued work on bug 631123 - Orca documentation needs to be updated, converted to Mallard, augmented, and moved to the Orca module
    
    * filled in some missing GUI items
    * added a link on the main page to the GNOME Desktop Accessibility
      Guide
    * corrected some typos

 help/C/commands_flat_review.page     |    4 ++--
 help/C/commands_reading.page         |    2 +-
 help/C/howto_orca_find.page          |    2 +-
 help/C/index.page                    |   15 +++++++++++----
 help/C/preferences_general.page      |   31 ++++++++++++++++++++++++++++++-
 help/C/preferences_key_bindings.page |    4 ++--
 help/C/preferences_key_echo.page     |    2 +-
 help/C/preferences_magnifier.page    |    7 ++++++-
 8 files changed, 54 insertions(+), 13 deletions(-)
---
diff --git a/help/C/commands_flat_review.page b/help/C/commands_flat_review.page
index 2ee70d3..8c4e79b 100644
--- a/help/C/commands_flat_review.page
+++ b/help/C/commands_flat_review.page
@@ -19,7 +19,7 @@
   <title>Flat Review Commands</title>
   <p>
     Orca's <link xref="howto_flat_review">Flat Review</link> commands are
-    designed for spatially reviwing elements displayed on the screen. They
+    designed for spatially reviewing elements displayed on the screen. They
     also provide a means for reading the current line, word, and character
     when navigating in the text of a document.
   </p>
@@ -141,7 +141,7 @@
           <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq> (double-clicked)</p></item>
         </list>
       </item>
-      <item><p>Speak unicode value of current character:</p>
+      <item><p>Speak Unicode value of current character:</p>
         <list>
           <item><p>Desktop: <keyseq><key>KP 2</key></keyseq> (triple-clicked)</p></item>
           <item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq> (triple-clicked)</p></item>
diff --git a/help/C/commands_reading.page b/help/C/commands_reading.page
index db3b4a5..e6e9c83 100644
--- a/help/C/commands_reading.page
+++ b/help/C/commands_reading.page
@@ -32,7 +32,7 @@
   </p>
   <p>
     In addition to the caret navigation commands which are part of GNOME,
-    you can use the following <app>Orca</app> commands to read a docment:
+    you can use the following <app>Orca</app> commands to read a document:
   </p>
   <section id="flat_review">
     <title>Reading Your Current Location</title>
diff --git a/help/C/howto_orca_find.page b/help/C/howto_orca_find.page
index eba8e2d..b0eee93 100644
--- a/help/C/howto_orca_find.page
+++ b/help/C/howto_orca_find.page
@@ -84,7 +84,7 @@
     match without having to return to the Orca Find dialog box.
   </p>
   <p>
-    Beause it is a <link xref="howto_flat_review">Flat Review</link> feature,
+    Because it is a <link xref="howto_flat_review">Flat Review</link> feature,
     when there is a match, Flat Review will automatically be activated and the
     matching item or text will become the current review item. Note that focus
     within the application will not be modified, nor will the caret be
diff --git a/help/C/index.page b/help/C/index.page
index 1fb3d69..fcf29e8 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -16,13 +16,20 @@
     <app>Orca</app> Screen Reader
   </title>
   <p>
+     If you are a new user of the GNOME Desktop, you wish to begin with the
+     <link href="http://library.gnome.org/users/gnome-access-guide/stable/";>
+     GNOME Desktop Accessibility Guide</link> which will introduce you to all
+     of the accessibility features in GNOME, including keyboard navigation and
+     accessible login.
+  </p>
+  <p>
      If you are new to screen readers or are unfamiliar with <app>Orca</app>,
      the guides which follow should get you started with performing common
      tasks using <app>Orca</app>. If, on the other hand, you are already
-     familiar with how to use a screen reader and just need to know what
-     options and tools <app>Orca</app> provides, you may prefer to read the
-     guides covering <link xref="preferences"><app>Orca</app>'s Preferences
-     dialogs</link> and <link xref="commands"><app>Orca</app>'s commands</link>.
+     familiar with how to use a screen reader and just need to know what options
+     and tools <app>Orca</app> provides, you may prefer to read the guides
+     covering <link xref="preferences"><app>Orca</app>'s Preferences dialogs
+     </link> and <link xref="commands"><app>Orca</app>'s commands</link>.
   </p>
   <section id="getting_started" style="2column">
     <title>Getting Started</title>
diff --git a/help/C/preferences_general.page b/help/C/preferences_general.page
index 7bb214e..ce193f9 100644
--- a/help/C/preferences_general.page
+++ b/help/C/preferences_general.page
@@ -162,6 +162,35 @@
       </desc>
     </info>
     <title>Profiles</title>
-    <p>WRITEME</p>
+    <p>
+      The <gui>Profiles</gui> group of controls make it possible for you
+      to maintain and use multiple configurations. Here you will find the
+      following:
+    </p>
+    <list>
+      <item>
+        <p>
+          The <gui>Active Profile</gui> combo box displays the current profile
+          and allows you to select a different profile to load.
+        </p>
+      </item>
+      <item>
+        <p>
+          The <gui>Load</gui> button will cause <app>Orca</app> to load the
+          profile indicated in the <gui>Active Profile</gui> combo box.
+        </p>
+      </item>
+      <item>
+        <p>
+          The <gui>Save As</gui> button allows you to save the current set of
+          options from the preferences dialog box to a named profile.
+        </p>
+      </item>
+        <p>
+          The <gui>Start-up Profile</gui> combo box allows you to select the
+          profile which should be automatically loaded each time you launch
+          <app>Orca</app>.
+        </p>
+    </list>
   </section>
 </page>
diff --git a/help/C/preferences_key_bindings.page b/help/C/preferences_key_bindings.page
index da5f3ca..c554f0b 100644
--- a/help/C/preferences_key_bindings.page
+++ b/help/C/preferences_key_bindings.page
@@ -53,7 +53,7 @@
           The <gui>Key Binding</gui> is the primary way to invoke the function
           from the keyboard. Note that the key binding may include the word
           "Orca". This indicates that the <key>Orca Modifier</key> key should
-          be held down along with the other keys. You can modifiy the value of
+          be held down along with the other keys. You can modify the value of
           this column by pressing <key>Return</key>, pressing the keys for the
           new binding, and pressing <key>Return</key> again.
         </p>
@@ -61,7 +61,7 @@
       <item>
         <p>
           The <gui>Alternate</gui> column allows you to specify an additional
-          keybinding for this function. You can modifiy the value of this
+          keybinding for this function. You can modify the value of this
           column by pressing <key>Return</key>, pressing the keys for the new
           binding, and pressing <key>Return</key> again.
         </p>
diff --git a/help/C/preferences_key_echo.page b/help/C/preferences_key_echo.page
index 5eba7f0..eca5025 100644
--- a/help/C/preferences_key_echo.page
+++ b/help/C/preferences_key_echo.page
@@ -103,7 +103,7 @@
     <note style="tip">
       <title>Enabling both key echo and character echo</title>
       <p>
-        If you like key echo and you frequenty type accented characters,
+        If you like key echo and you frequently type accented characters,
         consider enabling both. <app>Orca</app>'s character echo logic
         attempts to filter out characters which were spoken as a result
         of key echo, thus minimizing the likelihood of "double speaking"
diff --git a/help/C/preferences_magnifier.page b/help/C/preferences_magnifier.page
index a8901b7..dda4050 100644
--- a/help/C/preferences_magnifier.page
+++ b/help/C/preferences_magnifier.page
@@ -67,7 +67,12 @@
           of the zoom window. Units are in pixels.
         </p>
       </item>
-      <item><p>TODO: Add Hide System Pointer Option</p></item>
+      <item>
+        <p>
+          The <gui>Hide System Pointer</gui> checkbox will hide the unmagnified
+          pointer, leaving just the magnified one visible.
+        </p>
+      </item>
     </list>
   </section>
   <section id="tracking_and_alignment">