[orca] Doc rewrite in progress: Added an introduction to Bookmarks.

[Joanmarie Diggs <joanied src gnome org>]

commit 3cc54f74850f5a01e00f93df5e8fa8d58c893456
Author: Joanmarie Diggs <joanmarie diggs gmail com>
Date:   Fri Dec 17 16:41:04 2010 -0500

    Doc rewrite in progress: Added an introduction to Bookmarks.

 help/C/howto_bookmarks.page |   46 +++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 44 insertions(+), 2 deletions(-)
---
diff --git a/help/C/howto_bookmarks.page b/help/C/howto_bookmarks.page
index 1c18245..5dacdfd 100644
--- a/help/C/howto_bookmarks.page
+++ b/help/C/howto_bookmarks.page
@@ -11,8 +11,50 @@
       <p>Creative Commons Share Alike 3.0</p>
     </license>
   </info>
-  <title>Bookmarks (WRITE ME)</title>
+  <title>Bookmarks</title>
   <p>
-    Write me
+    <app>Orca</app>'s Bookmarks support allows you to indicate that an object
+    is of interest. It includes the following features:
+  </p>
+  <list>
+    <item>
+      <p>
+        You are not limited to a single object: You can set up to six bookmarks
+        per environment. You can also save bookmarks so that they will persist
+        from Orca session to Orca session.
+      </p>
+    </item>
+    <item>
+      <p>
+        Having set a bookmark you can navigate to it later, and do so regardless
+        of whether or not you have chosen to permanently save the bookmarks
+        associated with your current environment. Navigation can be based on the
+        number of the bookmark should you wish to jump directly to a specific
+        item. Alternatively, you can navigate to the next or previous bookmark
+        just like you can a <link xref="howto_structural_navigation">Structural
+        Navigation</link> object.
+      </p>
+    </item>
+    <item>
+      <p>
+        Bookmarkable objects can be widgets within an application or objects on
+        the web page you are reading. Which environment you are in determines
+        what happens as you navigate amongst bookmarks: If you are in web
+        content, the caret will be moved to the bookmark so that you can
+        continue reading; otherwise, <link xref="howto_flat_review">Flat
+        Review</link> will be activated with the bookmark becoming the current
+        review item.
+      </p>
+    </item>
+    <item>
+      <p>
+        Finally, there is Where Am I information for bookmarks which lets you
+        know where the specified bookmark is relative to your current location.
+      </p>
+    </item>
+  </list>
+  <p>
+    The specific keybindings associated with each of the above tasks can be
+    found in <link xref="commands_bookmarks">Bookmark Commands</link>.
   </p>
 </page>