[orca] Added Document help content.

[Joanmarie Diggs <joanied src gnome org>]

commit 8861cf997a766ba7fee98bf94e8e32a3934f8250
Author: Joanmarie Diggs <joanmarie diggs gmail com>
Date:   Mon Jan 10 18:15:40 2011 -0500

    Added Document help content.

 help/C/commands_reading.page |   13 +-----------
 help/C/howto_documents.page  |   46 +++++++++++++++++++++++++++++++++++++++--
 2 files changed, 44 insertions(+), 15 deletions(-)
---
diff --git a/help/C/commands_reading.page b/help/C/commands_reading.page
index ee37eb0..8576f68 100644
--- a/help/C/commands_reading.page
+++ b/help/C/commands_reading.page
@@ -2,7 +2,7 @@
   <info>
     <link type="next" xref="commands_structural_navigation" />
     <link type="guide" xref="commands#reading_documents" />
-    <link type="seealso" xref="howto_reading_text"  />
+    <link type="seealso" xref="howto_documents"  />
     <link type="seealso" xref="howto_text_attributes"  />
     <link type="seealso" xref="howto_whereami"  />
     <title type="sort">1. Reading</title>
@@ -20,17 +20,6 @@
   </info>
   <title>Reading Commands</title>
   <p>
-    To read the contents of any document, use the application's built-in caret
-    navigation mode. As you navigate within the text of the document, <app>Orca</app>
-    will present your new location. As a result, you are likely already familiar with
-    how to read a document using <app>Orca</app>. However, if you would like to review
-    GNOME's caret navigation commands, please see 
-    "<link href="http://library.gnome.org/users/gnome-access-guide/stable/keynav-52.html";>Caret 
-    Navigation Mode</link>" in the
-    <link href="http://library.gnome.org/users/gnome-access-guide/stable";>GNOME 
-    Desktop Accessibility Guide</link>.
-  </p>
-  <p>
     In addition to the caret navigation commands which are part of GNOME,
     <app>Orca</app> provides a number of commands which you can use to read a
     document.
diff --git a/help/C/howto_documents.page b/help/C/howto_documents.page
index e104324..1de2f9d 100644
--- a/help/C/howto_documents.page
+++ b/help/C/howto_documents.page
@@ -14,11 +14,51 @@
       <p>Creative Commons Share Alike 3.0</p>
     </license>
   </info>
-  <title>Documents (WRITE ME)</title>
+  <title>Documents</title>
   <p>
-    Write me
+    To read the contents of any document, use the application's built-in caret
+    navigation mode. As you navigate within the text of the document, <app>Orca</app>
+    will present your new location. As a result, you are likely already familiar with
+    how to read a document using <app>Orca</app>. For instance:
   </p>
+  <list>
+    <item>
+      <p>
+        Use <key>Left</key> and <key>Right</key> to move and read by character.
+      </p>
+    </item>
+    <item>
+      <p>
+        Use <keyseq><key>Ctrl</key><key>Left</key></keyseq> and
+        <keyseq><key>Ctrl</key><key>Right</key></keyseq> to move and read by word.
+      </p>
+    </item>
+    <item>
+      <p>
+        Use <key>Up</key> and <key>Down</key> to move and read by line.
+      </p>
+    </item>
+    <item>
+      <p>
+        Use <key>Shift</key> in combination with the above commands to select and
+        unselect text.
+      </p>
+    </item>
+  </list>
   <p>
-    This document will include SayAll
+    For a complete listing of GNOME's caret navigation commands, see the
+    <link href="ghelp:gnome-access-guide">GNOME Desktop Accessibility Guide</link>.
+  </p>
+  <p>
+    In addition to reading a document by caret navigation, you may find it helpful
+    to read, spell, and obtain the Unicode value for the current text. You can do
+    these things through <app>Orca</app>'s <link xref="howto_flat_review">Flat
+    Review feature</link>.
+  </p>
+  <p>
+    Finally, in order to have <app>Orca</app> speak the entire document from your
+    present location, use the SayAll command. It, along with a more complete
+    listing of <app>Orca</app>'s commands for accessing document text, can
+    be found in the <link xref="commands_reading">Reading Commands</link> guide.
   </p>
 </page>