[orca/gnome-3-16] Add documentation for the 'Automatic focus mode' checkboxes

[Joanmarie Diggs <joanied src gnome org>]

commit c83034cc9e5978aae4d4e1f9bbc63194f0e392eb
Author: Joanmarie Diggs <jdiggs igalia com>
Date:   Sat Aug 29 01:48:08 2015 -0400

    Add documentation for the 'Automatic focus mode' checkboxes

 help/C/preferences_gecko.page |   47 +++++++++++++++++++++++++++++++++++++++++
 1 files changed, 47 insertions(+), 0 deletions(-)
---
diff --git a/help/C/preferences_gecko.page b/help/C/preferences_gecko.page
index a64ec1d..a3ec260 100644
--- a/help/C/preferences_gecko.page
+++ b/help/C/preferences_gecko.page
@@ -44,6 +44,30 @@
        </note>
     </section>
     <section>
+      <title>Automatic focus mode during caret navigation</title>
+      <p>
+        If this checkbox is checked, <app>Orca</app> will automatically turn on
+        focus mode when you use caret navigation commands to navigate to a form
+        field. For example, pressing <key>Down</key> would allow you to move
+        into an entry but once you had done so, Orca would switch to focus mode
+        and subsequent presses of <key>Down</key> would be controlled by the web
+        browser and not by Orca. If this checkbox is not checked, <app>Orca</app>
+        would continue to control what happens when you press <key>Down</key>,
+        thus making it possible to arrow out of the entry and continue reading.
+      </p>
+      <p>
+        Default value: not checked
+      </p>
+      <note style="tip">
+        <title>Manually switching between browse mode and focus mode</title>
+        <p>
+          In order to start or stop interacting with the focused form field,
+          use <keyseq><key>Orca Modifier</key><key>A</key></keyseq> to switch
+          between browse mode and focus mode.
+        </p>
+       </note>
+    </section>
+    <section>
       <title>Enable structural navigation</title>
       <p>
         This checkbox toggles <app>Orca</app>'s
@@ -63,6 +87,29 @@
        </note>
     </section>
     <section>
+      <title>Automatic focus mode during structural navigation</title>
+      <p>
+        If this checkbox is checked, <app>Orca</app> will automatically turn on
+        focus mode when you use structural navigation commands to navigate to a
+        form field. For example, pressing <key>E</key> to move to the next entry
+        would move focus there and also turn focus mode on so that your next press
+        of <key>E</key> would type an "e" into that entry. If this checkbox is not
+        checked, then <app>Orca</app> will leave you in browse mode and your next
+        press of <key>E</key> would move you to the next entry on the page.
+      </p>
+      <p>
+        Default value: not checked
+      </p>
+      <note style="tip">
+        <title>Manually switching between browse mode and focus mode</title>
+        <p>
+          In order to start or stop interacting with the focused form field,
+          use <keyseq><key>Orca Modifier</key><key>A</key></keyseq> to switch
+          between browse mode and focus mode.
+        </p>
+       </note>
+    </section>
+    <section>
       <title>Automatically start speaking a page when it is first loaded</title>
       <p>
         If this checkbox is checked, <app>Orca</app> will perform a Say All on