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



commit 97953bd11dfa056330bdbc5a7df72d6a8762bb94
Author: Joanmarie Diggs <joanmarie diggs gmail com>
Date:   Sun Dec 19 04:31:32 2010 -0500

    Continued work on bug 631123 - Orca documentation needs to be updated, converted to Mallard, augmented, and moved to the Orca module
    
    * Add titles to the various step lists

 help/C/howto_key_bindings.page          |  250 +++++++++++++++----------------
 help/C/howto_keyboard_layout.page       |    7 +-
 help/C/howto_learn_modes.page           |   92 ++++++------
 help/C/howto_profiles.page              |  226 +++++++++++++---------------
 help/C/howto_structural_navigation.page |    3 +-
 help/C/howto_tables.page                |    8 +-
 help/C/howto_text_setup.page            |    4 +-
 help/C/howto_the_orca_modifier.page     |   60 ++++----
 help/C/howto_toggling_caps_lock.page    |    1 +
 help/C/preferences_pronunciation.page   |  122 +++++++---------
 10 files changed, 356 insertions(+), 417 deletions(-)
---
diff --git a/help/C/howto_key_bindings.page b/help/C/howto_key_bindings.page
index 52110c6..6d08c8b 100644
--- a/help/C/howto_key_bindings.page
+++ b/help/C/howto_key_bindings.page
@@ -17,139 +17,127 @@
     Orca has many commands, some of which are bound to a keystroke, others
     of which are unbound. You can bind, rebind, and unbind <app>Orca</app>'s
     commands by following the steps below.</p>
-  <section id="binding">
+  <steps>
     <title>Binding an Unbound Command</title>
-    <p>To add a keystroke to an unbound command:</p>
-    <steps>
-      <item>
-        <p>
-          Get into the <link xref="preferences">Orca Preferences</link> dialog
-          by pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
-        </p>
-      </item>
-      <item>
-        <p>Move to the <gui>Key Bindings</gui> page.</p>
-      </item>
-      <item>
-        <p>
-          Arrow to the cell which contains the command you want to assign a
-          keystroke to.
-        </p>
-      </item>
-      <item>
-        <p>
-          Arrow once to the right. This will place focus in the <gui>Key
-          Binding</gui> column. Press <key>Return</key>.
-        </p>
-      </item>
-      <item>
-        <p>Press the desired key combination.</p></item>
-      <item>
-        <p>
-          Press <key>Return</key> to confirm the new combination. The new
-          keystroke will be saved and the check box in the last column (the
-          <gui>Modified</gui> column) will indicate that the key binding
-          has been modified.
-        </p>
-      </item>
-      <item>
-        <p>Press the <gui>Apply</gui> button.</p>
-      </item>
-    </steps>
-  </section>
-  <section id="rebinding">
+    <item>
+      <p>
+        Get into the <link xref="preferences">Orca Preferences</link> dialog
+        by pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
+      </p>
+    </item>
+    <item>
+      <p>Move to the <gui>Key Bindings</gui> page.</p>
+    </item>
+    <item>
+      <p>
+        Arrow to the cell which contains the command you want to assign a
+        keystroke to.
+      </p>
+    </item>
+    <item>
+      <p>
+        Arrow once to the right. This will place focus in the <gui>Key
+        Binding</gui> column. Press <key>Return</key>.
+      </p>
+    </item>
+    <item>
+      <p>Press the desired key combination.</p></item>
+    <item>
+      <p>
+        Press <key>Return</key> to confirm the new combination. The new
+        keystroke will be saved and the check box in the last column (the
+        <gui>Modified</gui> column) will indicate that the key binding
+        has been modified.
+      </p>
+    </item>
+    <item>
+      <p>Press the <gui>Apply</gui> button.</p>
+    </item>
+  </steps>
+  <steps>
     <title>Changing Existing Bindings</title>
-    <p>To change either the key binding or the alternate binding:</p>
-    <steps>
-      <item>
-        <p>
-          Get into the <link xref="preferences">Orca Preferences</link> dialog by
-          pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
-        </p>
-      </item>
-      <item>
-        <p>Move to the <gui>Key Bindings</gui> page.</p>
-      </item>
-      <item>
-        <p>
-          Arrow to the cell which contains the binding you which to change and press
-          <key>Return</key>.
-        </p>
-      </item>
-      <item>
-          <p>Press the desired key combination.</p>
-      </item>
-      <item>
-        <p>
-          Press <key>Return</key> to confirm the new combination. The new
-          keystroke will be saved and the check box in the last column (the
-          <gui>Modified</gui> column) will indicate that the key binding has
-          been modified.
-        </p>
-      </item>
-      <item>
-        <p>Press the <gui>Apply</gui> button.</p>
-      </item>
-    </steps>
-  </section>
-  <section id="restoring">
+    <item>
+      <p>
+        Get into the <link xref="preferences">Orca Preferences</link> dialog by
+        pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
+      </p>
+    </item>
+    <item>
+      <p>Move to the <gui>Key Bindings</gui> page.</p>
+    </item>
+    <item>
+      <p>
+        Arrow to the cell which contains the binding you which to change and
+        press <key>Return</key>.
+      </p>
+    </item>
+    <item>
+        <p>Press the desired key combination.</p>
+    </item>
+    <item>
+      <p>
+        Press <key>Return</key> to confirm the new combination. The new
+        keystroke will be saved and the check box in the last column (the
+        <gui>Modified</gui> column) will indicate that the key binding has
+        been modified.
+      </p>
+    </item>
+    <item>
+      <p>Press the <gui>Apply</gui> button.</p>
+    </item>
+  </steps>
+  <steps>
     <title>Restoring Original Bindings</title>
-    <p>To restore a modified key binding:</p>
-    <steps>
-      <item>
-        <p>
-          Get into the <link xref="preferences">Orca Preferences</link>
-          dialog by pressing <keyseq><key>Orca Modifier</key><key>Space</key>
-          </keyseq>.
-        </p>
-      </item>
-      <item>
-        <p>Move to the <gui>Key Bindings</gui> page.</p>
-      </item>
-      <item>
-        <p>Arrow to the modified column associated with the key binding.</p>
-      </item>
-      <item>
-        <p>Uncheck the checkbox by pressing <key>Space</key>.</p>
-      </item>
-      <item>
-        <p>Press the <gui>Apply</gui> button.</p>
-      </item>
-    </steps>
-  </section>
-  <section id="unbinding">
+    <item>
+      <p>
+        Get into the <link xref="preferences">Orca Preferences</link>
+        dialog by pressing <keyseq><key>Orca Modifier</key><key>Space</key>
+        </keyseq>.
+      </p>
+    </item>
+    <item>
+      <p>Move to the <gui>Key Bindings</gui> page.</p>
+    </item>
+    <item>
+      <p>Arrow to the modified column associated with the key binding.</p>
+    </item>
+    <item>
+      <p>Uncheck the checkbox by pressing <key>Space</key>.</p>
+    </item>
+    <item>
+      <p>Press the <gui>Apply</gui> button.</p>
+    </item>
+  </steps>
+  <steps>
     <title>Unbinding Bound Commands</title>
-    <p>To unbind any bound command:</p>
-    <steps>
-      <item>
-        <p>
-          Get into the <link xref="preferences">Orca Preferences</link>
-          dialog by pressing <keyseq><key>Orca Modifier</key><key>Space</key>
-          </keyseq>.
-        </p>
-      </item>
-      <item>
-        <p>Move to the <gui>Key Bindings</gui> page.</p>
-      </item>
-      <item>
-        <p>
-          Arrow to the cell which contains the binding you which to delete
-          and press <key>Return</key>.
-        </p>
-      </item>
-      <item>
-        <p>
-          When prompted for the new keybinding, press <key>Delete</key> or
-          <key>BackSpace</key>. You will be told that the key binding has
-          been removed.
-        </p>
-      </item>
-      <item>
-        <p>Press <key>Return</key> to confirm.</p>
-      </item>
-      <item>
-        <p>Press the <gui>Apply</gui> button.</p>
-      </item>
-    </steps>
-  </section>
+    <item>
+      <p>
+        Get into the <link xref="preferences">Orca Preferences</link>
+        dialog by pressing <keyseq><key>Orca Modifier</key><key>Space</key>
+        </keyseq>.
+      </p>
+    </item>
+    <item>
+      <p>Move to the <gui>Key Bindings</gui> page.</p>
+    </item>
+    <item>
+      <p>
+        Arrow to the cell which contains the binding you which to delete
+        and press <key>Return</key>.
+      </p>
+    </item>
+    <item>
+      <p>
+        When prompted for the new keybinding, press <key>Delete</key> or
+        <key>BackSpace</key>. You will be told that the key binding has
+        been removed.
+      </p>
+    </item>
+    <item>
+      <p>Press <key>Return</key> to confirm.</p>
+    </item>
+    <item>
+      <p>Press the <gui>Apply</gui> button.</p>
+    </item>
+  </steps>
 </page>
diff --git a/help/C/howto_keyboard_layout.page b/help/C/howto_keyboard_layout.page
index 1a57320..9b5d82d 100644
--- a/help/C/howto_keyboard_layout.page
+++ b/help/C/howto_keyboard_layout.page
@@ -37,11 +37,10 @@
     <app>Orca</app>'s commands, especially in the areas of Flat Review,
     Where Am I, and Say All.
   </p>
-  <p>
-    If you want to change your keyboard layout, you can do so by performing
-    the following steps:
-  </p>
   <steps>
+    <title>
+      Changing Your Keyboard Layout
+    </title>
     <item>
       <p>
         Get into the <link xref="preferences">Orca Preferences</link> dialog
diff --git a/help/C/howto_learn_modes.page b/help/C/howto_learn_modes.page
index bb4d94b..eecaa21 100644
--- a/help/C/howto_learn_modes.page
+++ b/help/C/howto_learn_modes.page
@@ -23,55 +23,49 @@
     Mode provides you with a list of all the <app>Orca</app> commands
     you can use.
   </p>
-  <section id="learn_mode">
+  <steps>
     <title>Using Learn Mode</title>
-    <p>To use <app>Orca</app>'s Learn Mode:</p>
-    <steps>
-      <item>
-        <p>
-          Get into Learn Mode by pressing <keyseq><key>Orca Modifier</key>
-          <key>H</key></keyseq>.
-        </p>
-      </item>
-      <item>
-        <p>
-          Press any key or keystroke. <app>Orca</app> will announce the
-          keys and any associated command.
-        </p>
-      </item>
-      <item>
-        <p>Press <key>Esc</key> to exit Learn Mode.</p>
-      </item>
-    </steps>
-  </section>
-  <section id="list_shortcuts_mode">
+    <item>
+      <p>
+        Get into Learn Mode by pressing <keyseq><key>Orca Modifier</key>
+        <key>H</key></keyseq>.
+      </p>
+    </item>
+    <item>
+      <p>
+        Press any key or keystroke. <app>Orca</app> will announce the keys and
+        any associated command.
+      </p>
+    </item>
+    <item>
+      <p>Press <key>Esc</key> to exit Learn Mode.</p>
+    </item>
+  </steps>
+  <steps>
     <title>Using List Shortcuts Mode</title>
-    <p>To use <app>Orca</app>'s List Shortcuts Mode:</p>
-    <steps>
-      <item>
-        <p>
-          Get into List Shortcuts Mode by pressing <keyseq><key>Orca
-          Modifier</key><key>H</key></keyseq> twice quickly.
-        </p>
-      </item>
-      <item>
-        <p>
-          Press <key>1</key> if you want a list of shortcuts that apply
-         <app>Orca</app>-wide, or press <key>2</key> if you want a list
-         of shortcuts that are specifically for the application with focus.
-        </p>
-      </item>
-      <item>
-        <p>
-          Press <key>Up</key> or <key>Down</key> to examine the contents
-          of the list.
-        </p>
-      </item>
-      <item>
-        <p>
-          Press <key>Esc</key> to exit List Shortcuts Mode.
-        </p>
-      </item>
-    </steps>
-  </section>
+    <item>
+      <p>
+        Get into List Shortcuts Mode by pressing <keyseq><key>Orca Modifier</key>
+        <key>H</key></keyseq> twice quickly.
+      </p>
+    </item>
+    <item>
+      <p>
+        Press <key>1</key> if you want a list of shortcuts that apply
+        <app>Orca</app>-wide, or press <key>2</key> if you want a list
+        of shortcuts that are specifically for the application with focus.
+      </p>
+    </item>
+    <item>
+      <p>
+        Press <key>Up</key> or <key>Down</key> to examine the contents of the
+        list.
+      </p>
+    </item>
+    <item>
+      <p>
+        Press <key>Esc</key> to exit List Shortcuts Mode.
+      </p>
+    </item>
+  </steps>
 </page>
diff --git a/help/C/howto_profiles.page b/help/C/howto_profiles.page
index 85e30a7..b8ac693 100644
--- a/help/C/howto_profiles.page
+++ b/help/C/howto_profiles.page
@@ -27,129 +27,113 @@
     </desc>
     <media type="image" mime="image/png" src="figures/preferences_profiles.png"/>
   </figure>
-  <section id="save">
+  <steps>
     <title>Saving a New Profile</title>
-    <p>To save a new profile:</p>
-    <steps>
-      <item>
-        <p>
-          Get into the <link xref="preferences">Orca
-          Preferences</link> dialog box.
-        </p>
-      </item>
-      <item>
-        <p>Change whatever settings you wish.</p>
-      </item>
-      <item>
-        <p>
-          On the <gui>General</gui> page, press the <gui>Save As</gui> button.
-        </p>
-      </item>
-      <item>
-        <p>
-          Type the new profile name in the resulting <gui>Save Profile As</gui>
-          dialog box.
-        </p>
-        <p>
-          <media type="image" mime="image/png" src="figures/profiles_save_as.png"/>
-        </p>
-      </item>
-      <item>
-        <p>
-          Press the <gui>OK</gui> button in the <gui>Save Profile As</gui>
-          dialog box.
-        </p>
-      </item>
-    </steps>
-  </section>
-  <section id="load">
+    <item>
+      <p>
+        Get into the <link xref="preferences">Orca Preferences</link> dialog box.
+      </p>
+    </item>
+    <item>
+      <p>Change whatever settings you wish.</p>
+    </item>
+    <item>
+      <p>
+        On the <gui>General</gui> page, press the <gui>Save As</gui> button.
+      </p>
+    </item>
+    <item>
+      <p>
+        Type the new profile name in the resulting <gui>Save Profile As</gui>
+        dialog box.
+      </p>
+      <p>
+        <media type="image" mime="image/png" src="figures/profiles_save_as.png"/>
+      </p>
+    </item>
+    <item>
+      <p>
+        Press the <gui>OK</gui> button in the <gui>Save Profile As</gui>
+        dialog box.
+      </p>
+    </item>
+  </steps>
+  <steps>
     <title>Loading an Existing Profile</title>
-    <p>To load an existing profile:</p>
-    <steps>
-      <item>
-        <p>
-          Get into the <link xref="preferences">Orca Preferences</link> dialog
-          box.
-        </p>
-      </item>
-      <item>
-        <p>
-          On the <gui>General</gui> page, select the profile to load from
-          the <gui>Active Profile</gui> combo box.
-        </p>
-      </item>
-      <item>
-        <p>Press the <gui>Load</gui> button.</p>
-      </item>
-      <item>
-        <p>
-          You will be asked to confirm. Press the <gui>Yes</gui> button.
-        </p>
-        <p>
-          <media type="image" mime="image/png" src="figures/profiles_load.png"/>
-        </p>
-      </item>
-      <item>
-        <p>Press the <gui>OK</gui> button.</p>
-      </item>
-    </steps>
-  </section>
-  <section id="overwrite">
+    <item>
+      <p>
+        Get into the <link xref="preferences">Orca Preferences</link> dialog box.
+      </p>
+    </item>
+    <item>
+      <p>
+        On the <gui>General</gui> page, select the profile to load from the
+        <gui>Active Profile</gui> combo box.
+      </p>
+    </item>
+    <item>
+      <p>Press the <gui>Load</gui> button.</p>
+    </item>
+    <item>
+      <p>
+        You will be asked to confirm. Press the <gui>Yes</gui> button.
+      </p>
+      <p>
+        <media type="image" mime="image/png" src="figures/profiles_load.png"/>
+      </p>
+    </item>
+    <item>
+      <p>Press the <gui>OK</gui> button.</p>
+    </item>
+  </steps>
+  <steps>
     <title>Changing an Existing Profile</title>
-    <p>To make changes to an existing profile:</p>
-    <steps>
-      <item>
-        <p>
-          Follow the steps described above to load the profile you wish to
-          change.
-        </p>
-      </item>
-      <item>
-        <p>Follow the steps described above to save a new profile.</p>
-      </item>
-      <item>
-        <p>
-          When prompted for the new profile name, type the same name as current
-          profile. When you press the <gui>OK</gui> button, you will told there
-          is a name conflict.
-        </p>
-        <p>
-          <media type="image" mime="image/png" src="figures/profiles_conflict.png"/>
-        </p>
-      </item>
-      <item>
-        <p>
-          Press the <gui>Yes</gui> button to confirm you wish to overwrite the
-          existing profile with the new settings.
-        </p>
-      </item>
-    </steps>
-  </section>
-  <section id="startup">
+    <item>
+      <p>
+        Follow the steps described above to load the profile you wish to change.
+      </p>
+    </item>
+    <item>
+      <p>Follow the steps described above to save a new profile.</p>
+    </item>
+    <item>
+      <p>
+        When prompted for the new profile name, type the same name as current
+        profile. When you press the <gui>OK</gui> button, you will told there
+        is a name conflict.
+      </p>
+      <p>
+        <media type="image" mime="image/png" src="figures/profiles_conflict.png"/>
+      </p>
+    </item>
+    <item>
+      <p>
+        Press the <gui>Yes</gui> button to confirm you wish to overwrite the
+        existing profile with the new settings.
+      </p>
+    </item>
+  </steps>
+  <steps>
     <title>Changing the <gui>Start-up Profile</gui></title>
-    <p>To change the profile which is loaded when you start <app>Orca</app>:</p>
-    <steps>
-      <item>
-        <p>
-          Get into the <link xref="preferences">Orca
-          Preferences</link> dialog box.
-        </p>
-      </item>
-      <item>
-        <p>
-          On the <gui>General</gui> page, select the profile to load from the
-          <gui>Start-up Profile</gui> combo box.
-        </p>
-      </item>
-      <item>
-        <p>Press the <gui>OK</gui> button.</p>
-      </item>
-      <item>
-        <p>
-          The next time you launch <app>Orca</app>, the newly-selected profile
-          will be used.
-        </p>
-      </item>
-    </steps>
-  </section>
+    <item>
+      <p>
+        Get into the <link xref="preferences">Orca Preferences</link> dialog box.
+      </p>
+    </item>
+    <item>
+      <p>
+        On the <gui>General</gui> page, select the profile to load from the
+        <gui>Start-up Profile</gui> combo box.
+      </p>
+    </item>
+    <item>
+      <p>Press the <gui>OK</gui> button.</p>
+    </item>
+    <item>
+      <p>
+        The next time you launch <app>Orca</app>, the newly-selected profile
+        will be used.
+      </p>
+    </item>
+  </steps>
 </page>
diff --git a/help/C/howto_structural_navigation.page b/help/C/howto_structural_navigation.page
index 49b6d90..67749f6 100644
--- a/help/C/howto_structural_navigation.page
+++ b/help/C/howto_structural_navigation.page
@@ -83,9 +83,10 @@
     <p>
       In addition to the aforementioned commands, <app>Orca</app> has a number
       of configurable options available specifically for applications in which
-      there is structural navigation support. To access these options:
+      there is structural navigation support.
     </p>
     <steps>
+      <title>Configuring Structural Navigation</title>
       <item>
         <p>
           Give focus to an application for which <app>Orca</app> has
diff --git a/help/C/howto_tables.page b/help/C/howto_tables.page
index 65cb1a4..f6308d5 100644
--- a/help/C/howto_tables.page
+++ b/help/C/howto_tables.page
@@ -92,10 +92,8 @@
       <app>Orca</app>'s Dynamic Header support makes it possible to overcome these
       challenges.
     </p>
-    <p>
-      To set column headers:
-    </p>
     <steps>
+      <title>Setting Column Headers</title>
       <item>
         <p>
           Move to the row which contains all of the column headers.
@@ -108,10 +106,8 @@
         </p>
       </item>
     </steps>
-    <p>
-      To set row headers:
-    </p>
     <steps>
+      <title>Set Row Headers</title>
       <item>
         <p>
           Move to the column which contains all of the row headers.
diff --git a/help/C/howto_text_setup.page b/help/C/howto_text_setup.page
index 3d46083..b0264f6 100644
--- a/help/C/howto_text_setup.page
+++ b/help/C/howto_text_setup.page
@@ -15,10 +15,10 @@
   <title>Using Text Setup</title>
   <p>
     Orca has a text setup feature which allows you to perform basic configuration
-    of <app>Orca</app> even if the graphical desktop is not running. To launch
-    <app>Orca</app>'s text-only guided setup:
+    of <app>Orca</app> even if the graphical desktop is not running.
   </p>
   <steps>
+    <title>Launching <app>Orca</app>'s Text-Only Guided Setup</title>
     <item>
       <p>
         Open a <gui>Run</gui> dialog. For most distros, this can be accomplished
diff --git a/help/C/howto_the_orca_modifier.page b/help/C/howto_the_orca_modifier.page
index 478caba..2c98e34 100644
--- a/help/C/howto_the_orca_modifier.page
+++ b/help/C/howto_the_orca_modifier.page
@@ -43,37 +43,33 @@
       </p>
     </item>
   </list>
-  <section id="changing_the_modifier">
+  <p>
+    If you want to maintain your current keyboard layout but select a different
+    modifier key, you can do so by performing the following steps:
+  </p>
+  <steps>
     <title>Changing the Orca Modifier</title>
-    <p>
-      If you want to maintain your current keyboard layout but select
-      a different modifier key, you can do so by performing the following
-      steps:
-    </p>
-    <steps>
-      <item>
-        <p>
-          Get into the <link xref="preferences">Orca Preferences</link>
-          dialog by pressing <keyseq><key>Orca Modifier</key><key>Space</key>
-          </keyseq>.
-        </p>
-      </item>
-      <item>
-        <p>Move to the <gui>Key Bindings</gui> page.</p>
-      </item>
-      <item>
-        <p>Move to the <gui>Orca Modifier Key(s)</gui> combobox.</p>
-      </item>
-      <item>
-        <p>Arrow to the desired modifier. The available options are:</p>
-        <list>
-          <item><p>Insert, KP_Insert</p></item>
-          <item><p>KP_Insert</p></item>
-          <item><p>Insert</p></item>
-          <item><p>Caps_Lock</p></item>
-        </list>
-      </item>
-      <item><p>Press the <gui>Apply</gui> button.</p></item>
-    </steps>
-  </section>
+    <item>
+      <p>
+        Get into the <link xref="preferences">Orca Preferences</link> dialog by
+        pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
+      </p>
+    </item>
+    <item>
+      <p>Move to the <gui>Key Bindings</gui> page.</p>
+    </item>
+    <item>
+      <p>Move to the <gui>Orca Modifier Key(s)</gui> combobox.</p>
+    </item>
+    <item>
+      <p>Arrow to the desired modifier. The available options are:</p>
+      <list>
+        <item><p>Insert, KP_Insert</p></item>
+        <item><p>KP_Insert</p></item>
+        <item><p>Insert</p></item>
+        <item><p>Caps_Lock</p></item>
+      </list>
+    </item>
+    <item><p>Press the <gui>Apply</gui> button.</p></item>
+  </steps>
 </page>
diff --git a/help/C/howto_toggling_caps_lock.page b/help/C/howto_toggling_caps_lock.page
index f29fe47..d1d56cb 100644
--- a/help/C/howto_toggling_caps_lock.page
+++ b/help/C/howto_toggling_caps_lock.page
@@ -21,6 +21,7 @@
     <key>CapsLock</key>, you can do so by performing the following steps:
   </p>
   <steps>
+    <title>Toggling CapsLock in Laptop Layout</title>
     <item>
       <p>
         Press the Bypass command, <keyseq><key>Orca Modifier</key><key>BackSpace</key>
diff --git a/help/C/preferences_pronunciation.page b/help/C/preferences_pronunciation.page
index ff88e5e..8eaaf22 100644
--- a/help/C/preferences_pronunciation.page
+++ b/help/C/preferences_pronunciation.page
@@ -34,75 +34,55 @@
     application-specific settings, you can customize your entries on an
     as-needed basis for each application you use.
   </p>
-  <section id="add">
-    <title>Add a new dictionary entry</title>
-    <p>
-      To add a new entry into <app>Orca</app>'s pronunciation dictionary:
-    </p>
-    <steps>
-      <item>
-        <p>
-          Press the New Entry button (<keyseq><key>Alt</key><key>N</key>
-          </keyseq>)
-        </p>
-      </item>
-      <item>
-        <p>
-          Type the text of the new entry and press <key>Return</key>
-          to finish editing the actual string.
-        </p>
-      </item>
-      <item>
-        <p>
-          Move to the <gui>Replacement String</gui> column and press
-          <key>Return</key> to begin editing.
-        </p>
-      </item>
-      <item>
-        <p>
-          Type the text that you would like to have spoken instead
-          and press <key>Return</key> to finish editing the replacement
-          string.
-        </p>
-      </item>
-    </steps>
-  </section>
-  <section id="edit">
-    <title>Edit an existing dictionary entry</title>
-    <p>
-      To edit an existing entry in <app>Orca</app>'s pronunciation
-      dictionary:
-    </p>
-    <steps>
-      <item>
-        <p>
-          Move to the cell you wish to edit and press <key>Return</key>
-          to begin editing.
-        </p>
-      </item>
-      <item>
-        <p>
-          Make your changes and then press <key>Return</key> to finish
-          editing.
-        </p>
-      </item>
-    </steps>
-  </section>
-  <section id="delete">
-    <title>Delete an existing dictionary entry</title>
-    <p>
-      To delete an entry from <app>Orca</app>'s pronunciation
-      dictionary:
-    </p>
-    <steps>
-      <item>
-        <p>Move to the entry you wish to delete.</p>
-      </item>
-      <item>
-        <p>
-          Press the Delete button or <keyseq><key>Alt</key><key>D</key></keyseq>.
-        </p>
-      </item>
-    </steps>
-  </section>
+  <steps>
+    <title>Adding a new dictionary entry</title>
+    <item>
+      <p>
+        Press the New Entry button (<keyseq><key>Alt</key><key>N</key></keyseq>)
+      </p>
+    </item>
+    <item>
+      <p>
+        Type the text of the new entry and press <key>Return</key> to finish
+        editing the actual string.
+      </p>
+    </item>
+    <item>
+      <p>
+        Move to the <gui>Replacement String</gui> column and press <key>Return
+        </key> to begin editing.
+      </p>
+    </item>
+    <item>
+      <p>
+        Type the text that you would like to have spoken instead and press <key>
+        Return</key> to finish editing the replacement string.
+      </p>
+    </item>
+  </steps>
+  <steps>
+  <title>Editing an existing dictionary entry</title>
+    <item>
+      <p>
+        Move to the cell you wish to edit and press <key>Return</key> to begin
+        editing.
+      </p>
+    </item>
+    <item>
+      <p>
+        Make your changes and then press <key>Return</key> to finish editing.
+      </p>
+    </item>
+  </steps>
+  <steps>
+    <title>Deleting an existing dictionary entry</title>
+    <item>
+      <p>Move to the entry you wish to delete.</p>
+    </item>
+    <item>
+      <p>
+        Press the Delete button or <keyseq><key>Alt</key><key>D</key></keyseq>.
+      </p>
+    </item>
+  </steps>
 </page>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]