[orca/gnome-3-16] Update the forms how-to docs to reflect that Orca now has browse and focus modes

[Joanmarie Diggs <joanied src gnome org>]

commit 0f0c8913e6b6836606610bc962a3e887babbc0d2
Author: Joanmarie Diggs <jdiggs igalia com>
Date:   Sat Aug 29 03:07:59 2015 -0400

    Update the forms how-to docs to reflect that Orca now has browse and focus modes

 help/C/howto_forms.page |   43 +++++++++++++++++++++++--------------------
 1 files changed, 23 insertions(+), 20 deletions(-)
---
diff --git a/help/C/howto_forms.page b/help/C/howto_forms.page
index efdad1c..60c31df 100644
--- a/help/C/howto_forms.page
+++ b/help/C/howto_forms.page
@@ -18,10 +18,8 @@
   <p>
     When interacting with web pages and other documents using <app>Orca</app>,
     you are interacting with the document itself; not a buffered copy of that
-    document. Thus there is no special mode to get into or out of when you
-    wish to fill out a form. Instead, simply navigate to each field whose
-    contents you wish to change, and interact with the widget as if it were in
-    a dialog box.
+    document. <app>Orca</app>'s browse and focus modes let you switch between
+    reading and filling out forms.
   </p>
   <section>
     <title>Navigating Amongst Form Fields</title>
@@ -31,7 +29,7 @@
     <list>
       <item>
         <p>
-           Use <key>Tab</key> and <keyseq><key>Shift</key><key>Tab</key></keyseq>,
+           Use <key>Tab</key> and <keyseq><key>Shift</key><key>Tab</key></keyseq>
            to navigate amongst focusable objects, regardless of type.
         </p>
       </item>
@@ -48,36 +46,33 @@
         </p>
       </item>
    </list>
+   <note style="tip">
+     <p>
+       In order to use <app>Orca</app>'s caret navigation or structural navigation
+       commands to navigate to a form field, you must be in browse mode. If you are
+       in focus mode, you can switch to browse mode by pressing <keyseq><key>Orca
+       Modifier</key><key>A</key></keyseq>.
+     </p>
+   </note>
   </section>
   <section>
     <title>Exiting Form Fields</title>
     <p>
-      Because there is no special mode in <app>Orca</app> for interacting with
-      forms, the most frequently-asked question is how to exit a focused form
-      field. For this, too, you have several options:
+      To exit a form field, you have several options:
     </p>
     <list>
       <item>
         <p>
           Use <key>Tab</key>/<keyseq><key>Shift</key><key>Tab</key></keyseq>
           if you wish to leave the currently-focused form field and move to the
-          next/previous focusable object, regardless of what that object happens
-          to be.
+          next/previous focusable object, regardless of type.
         </p>
       </item>
       <item>
         <p>
           Use <app>Orca</app>'s <link xref="commands_structural_navigation#forms">
-          structural navigation</link> to move to the next/previous form field:
-          <keyseq><key>Orca Modifier</key><key>Tab</key></keyseq>/<keyseq>
-          <key>Orca Modifier</key><key>Shift</key><key>Tab</key></keyseq>.
-        </p>
-      </item>
-      <item>
-        <p>
-          Use <app>Orca</app>'s commands for moving to the next/previous object
-          or chunk of text: <keyseq><key>Orca Modifier</key><key>Right</key>
-          </keyseq>/<keyseq><key>Orca Modifier</key><key>Left</key></keyseq>.
+          structural navigation commands for forms</link> to move to the next or
+          previous form field.
         </p>
       </item>
       <item>
@@ -87,6 +82,14 @@
         </p>
       </item>
     </list>
+   <note style="tip">
+     <p>
+       In order to use <app>Orca</app>'s caret navigation or structural navigation
+       commands to exit a form field, you must be in browse mode. If you are in
+       focus mode, you can switch to browse mode by pressing <keyseq><key>Orca
+       Modifier</key><key>A</key></keyseq>.
+     </p>
+   </note>
   </section>
 </page>