general formatting and Orca edits

svn path=/trunk/; revision=858

1 files changed, 181 insertions, 621 deletions

diff --git a/gnome2-accessibility-guide/C/low-vision.xml b/gnome2-accessibility-guide/C/low-vision.xml
index 8dae8c8..81e24cd 100644
--- a/gnome2-accessibility-guide/C/low-vision.xml
+++ b/gnome2-accessibility-guide/C/low-vision.xml
@@ -1,60 +1,31 @@
 <chapter id="low-vision">
 <title>Low Vision or Blindness</title>
-
 <para>
-From low vision to blindness, the range of visual 
-limitations is broad. Symptoms of low vision include 
-dimness, haziness, extreme far-/near-sightedness, 
-color blindness, and tunnel vision, among others. 
-People with these disabilities are 
-concerned with being able to see text or images on a 
-computer screen and being able to perform tasks that 
-require eye-hand coordination, such as moving a 
-computer mouse. Text size and color can make a big 
-difference in legibility for people with low vision.
+From low vision to blindness, the range of visual limitations is broad. Symptoms of low vision include dimness, haziness, extreme far-/near-sightedness, color blindness, and tunnel vision, among others. People with these disabilities are concerned with being able to see text or images on a computer screen and being able to perform tasks that 
+require eye-hand coordination, such as moving a computer mouse. Text size and color can make a big difference in legibility for people with low vision.
 </para>
-
 <para>
-The technologies that can assist those with low vision 
-or blindness are:
+The technologies that can assist those with low vision or blindness are:
 </para>
 <itemizedlist>
 <listitem>
 <para>
-<emphasis>
-Screen Magnifier
-</emphasis>
- - this is like a magnifying glass. People using them 
-are able to control what area of the computer screen 
-they want enlarged, and can move the magnifier to view 
-different areas of the screen. They are also known as 
-screen enlargers or large print programs.
+<emphasis>Screen Magnifier</emphasis> - this is like a magnifying glass. People using them 
+are able to control what area of the computer screen they want enlarged, and can move the magnifier to view different areas of the screen. They are also known as screen enlargers or large print programs.
 </para>
 </listitem>
-
 <listitem>
 <para>
-<emphasis>
-Screen Reader
-</emphasis>
- - this makes on-screen information available as 
-synthesized speech and/or a refreshable Braille display. 
-They generally only translate text-based information. 
-Graphics and other non-textual objects can be 
+<emphasis>Screen Reader</emphasis> - this makes on-screen information available as 
+synthesized speech and/or a refreshable Braille display. They generally only translate text-based information. Graphics and other non-textual objects can be 
 translated if there is alternative text 
 describing the item. They are also known as 
 blind access utilities or screen reviewers.
 </para>
 </listitem>
-
 <listitem>
 <para>
-<emphasis>
-Desktop Appearance Enhancement
-</emphasis>
- - users can configure the desktop to be easy to read; 
-for example, by increasing text size and using high 
-contrast themes.
+<emphasis>Desktop Appearance Enhancement</emphasis> - users can configure the desktop to be easy to read; for example, by increasing text size and using high-contrast themes.
 </para>
 </listitem>
 </itemizedlist>
@@ -67,104 +38,66 @@ contrast themes.
 <indexterm>
 <primary>Orca</primary>
 </indexterm>
-
 <para>
-The <application>Orca Screen Reader and Magnifier
-</application> application enables users with limited 
-vision or no vision to use the GNOME Desktop and 
-associated applications. <application>Orca</application>
-provides the following functionality: 
+The <application>Orca Screen Reader and Magnifier</application> application enables users with limited or no vision to use the GNOME Desktop and associated applications. <application>Orca</application> provides the following functionality: 
 </para>
-
 <itemizedlist>
 <listitem>
 <para>
 Screen Reader
 </para>
-
 <para>
-The screen reader enables non-visual access to standard 
-applications in the GNOME Desktop, using speech and 
-Braille output.
+The screen reader enables non-visual access to standard applications in the GNOME Desktop by using speech and Braille output.
 </para>
 </listitem>
-
 <listitem>
 <para>
 Magnifier
 </para>
-
 <para>
-The magnifier provides automated focus tracking and 
-full-screen magnification to aid low-vision users.
+The magnifier provides automated focus tracking and full-screen magnification to aid low-vision users.
 </para>
 </listitem>
 </itemizedlist>
-
 <para>
-The following sections provide information about Orca 
-and how to use it.
+The following sections provide information about <application>Orca</application> and how to use it.
 </para>
 
 <section>
 <title>Introduction to Orca</title>
 <section>
 <title>What is Orca?</title>
-
 <para>
-Orca is a flexible, extensible, and powerful assistive
-technology for people with visual impairments. Using 
-various combinations of speech synthesis, Braille and 
-magnification, Orca helps provide access to applications
-and toolkits that support the AT-SPI (e.g., the GNOME 
-Desktop). Orca is also free open source software.
+Orca is a flexible, extensible, and powerful assistive technology for people with visual impairments. Using various combinations of speech synthesis, Braille and magnification, Orca helps provide access to applications
+and toolkits that support the AT-SPI (e.g., the GNOME Desktop). <application>Orca</application> is also free open source software.
 </para>
 </section>
 
 <section>
 <title>Why the name Orca?</title>
-
 <para>
-One of the first DOS screen readers was Flipper, made by
-Omnichron Corporation in Berkeley, CA. It was named 
-Flipper in part because the blind wife of the programmer 
-envisioned computers as being programmed by flipping 
-switches (an accurate image of a bygone era). Then came 
-another DOS screen reader, this one from Henter-Joyce in 
-Florida - "Jobs Access With Speech" (or JAWS). And so 
-on....
+One of the first DOS screen readers was Flipper, made by Omnichron Corporation in Berkeley, CA. It was named Flipper in part because the blind wife of the programmer 
+envisioned computers as being programmed by flipping switches (an accurate image of a bygone era). Then came another DOS screen reader, this one from Henter-Joyce in 
+Florida - "Jobs Access With Speech" (or JAWS). And so on....
 </para>
-
 <para>
-Although no obvious connection exists between blindness 
-and creatures from the sea, there is certainly a naming 
-tradition for screen-reader software. Hence Orca, which
-is a lot tougher-sounding than Nemo, Ariel, Willy, 
-or Mr. Limpet.
+Although no obvious connection exists between blindness and creatures from the sea, there is certainly a naming tradition for screen-reader software. Hence <application>Orca</application>, which is a lot tougher-sounding than Nemo, Ariel, Willy, or Mr. Limpet.
 </para>
 </section>
 
 <section>
 <title>What's the schedule?</title>
-
 <para>
-Orca is part of the GNOME platform and Orca's releases
-are coupled with the releases of the GNOME platform.
+<application>Orca</application> is part of the GNOME platform and <application>Orca</application>'s releases are coupled with the releases of the GNOME platform.
 </para>
 </section>
 
 <section>
 <title>How do I request a new feature?</title>
 <para>
-<ulink url="http://bugzilla.gnome.org/buglist.cgi?
-query=product:orca+">
-Bugs</ulink> and feature/enhancement requests (RFEs) 
-should be reported to the 
-<ulink url="http://bugzilla.gnome.org">
-GNOME Bug Tracking System
-</ulink>. Patches are always welcome, and instructions
-for creating patches can be found in the 
-<ulink url="http://developer.gnome.org/tools/svn.html">
+<ulink url="http://bugzilla.gnome.org/buglist.cgi?query=product:orca+">Bugs</ulink> and feature/enhancement requests (RFEs) 
+should be reported to the <ulink url="http://bugzilla.gnome.org">GNOME Bug Tracking System
+</ulink>. Patches are always welcome, and instructions for creating patches can be found in the <ulink url="http://developer.gnome.org/tools/svn.html">
 GNOME Introduction to Subversion (SVN)
 </ulink>.
 </para>
@@ -172,31 +105,18 @@ GNOME Introduction to Subversion (SVN)
 
 <section>
 <title>Where is the discussion list?</title>
-
 <para>
-You can get in touch with developers and other users by
-<ulink url="mailto:orca-list@gnome.org">
-sending an e-mail
-</ulink> to the
-<ulink url="http://mail.gnome.org/mailman/listinfo/
-orca-list">
-Orca mailing list</ulink> 
-( 
-<ulink url="http://mail.gnome.org/archives/orca-list">
-Archives
-</ulink>).
+You can get in touch with developers and other users by <ulink url="mailto:orca-list@gnome.org">sending an e-mail</ulink> to the <ulink url="http://mail.gnome.org/mailman/listinfo/orca-list">Orca mailing list</ulink> 
+(
+<ulink url="http://mail.gnome.org/archives/orca-list">Archives</ulink>).
 </para>
 </section>
 
 <section>
 <title>Is Braille supported?</title>
 <para>
-Yes! Braille is supported via BrlTTY and it is tightly 
-integrated with Orca. BrlTTY offers support for nearly
-every refreshable Braille display known to man. Please 
-refer to the 
-<ulink url="ghelp:orca#braille">
-Braille page
+Yes! Braille is supported via BrlTTY and it is tightly integrated with Orca. BrlTTY offers support for nearly every refreshable Braille display known to man. Refer to the 
+<ulink url="ghelp:orca#braille">Braille page
 </ulink> for more information.
 </para>
 </section>
@@ -204,70 +124,44 @@ Braille page
 <section>
 <title>Are Grade 2 Braille contractions supported?</title>
 <para>
-Yes, Orca fully supports contracted Braille output.
+Yes, <application>Orca</application> fully supports contracted Braille output.
 </para>
 </section>
 
 <section>
 <title>What voices are available?</title>
 <para>
-Orca provides interfaces to both 
-<userinput>gnome-speech</userinput> and 
-<userinput>emacspeak</userinput> speech services. As 
-such, the available voices for Orca are only restricted 
-by the speech engines supported by the available speech 
-services. For free speech engines, you typically have a 
-choice of the eSpeak, Festival, and FreeTTS speech 
-engines. For commercial engines, you have a choice of 
-additional engines such as Fonix DECtalk, Loquendo, 
-Eloquence, Cepstral and IBMTTS, with others on the way.
-Periodically check the <userinput>gnome-speech
-</userinput> package for more progress in this area.
+<application>Orca</application> provides interfaces to both <userinput>gnome-speech</userinput> and <userinput>emacspeak</userinput> speech services. As such, the available voices for <application>Orca</application> are only restricted by the speech engines supported by the available speech services. For free speech engines, you typically have a choice of the eSpeak, Festival, and FreeTTS speech engines. For commercial engines, you have a choice of 
+additional engines such as Fonix DECtalk, Loquendo, Eloquence, Cepstral and IBMTTS, with others on the way. Periodically check the <userinput>gnome-speech</userinput> package for more progress in this area.
 </para>
 </section>
 
 <section>
 <title>What languages are supported?</title>
 <para>
-The 
-<ulink url="http://l10n.gnome.org/teams">
-GNOME translation teams</ulink> are composed of many 
-passionate volunteers from around the world. These teams 
-do a great job and keep an up-to-date status report. 
-Please see the 
-<ulink url="http://l10n.gnome.org/module/orca">
-Orca translation status page</ulink> for the large 
-number of languages into which Orca has been translated.
+The <ulink url="http://l10n.gnome.org/teams">
+GNOME translation teams</ulink> are composed of many passionate volunteers from around the world. These teams do a great job and keep an up-to-date status report. See the <ulink url="http://l10n.gnome.org/module/orca">
+Orca translation status page</ulink> for the large number of languages into which <application>Orca</application> has been translated.
 </para>
 <para> 
 Note: support for a language also depends on 
-the speech synthesis engine also supporting the same 
-language.
+the speech synthesis engine also supporting the same language.
 </para>
 </section>
 
 <section>
 <title>How well does magnification work?</title>
 <para>
-Orca currently uses the 
-<userinput>gnome-mag</userinput> 
-magnification service.
-<userinput>gnome-mag</userinput> has incorporated
-support for smoother full-screen magnification, which 
-relies upon newer extensions in the X Window System 
-server. These extensions do not always function well on 
-all platforms, so smooth full-screen magnification may 
-not always work.
+<application>Orca</application> currently uses the <userinput>gnome-mag</userinput> 
+magnification service. <userinput>gnome-mag</userinput> has incorporated support for smoother full-screen magnification, which 
+relies upon newer extensions in the X Window System server. These extensions do not always function well on all platforms, so smooth full-screen magnification may not always work.
 </para>
 </section>
 
 <section>
 <title>How is web access coming along?</title>
 <para>
-Orca targets the Firefox web browser (version 3) for 
-providing accessible web browsing. Both the Orca and 
-Firefox teams are fully dedicated in this cooperative
-effort.
+<application>Orca</application> targets the <application>Firefox</application> web browser (version 3) for providing accessible web browsing. Both the <application>Orca</application> and <application>Firefox</application> teams are fully dedicated in this cooperative effort.
 </para>
 </section>
 </section>
@@ -277,87 +171,43 @@ effort.
 <section>
 <title>Initial Setup</title>
 <para>
-When you run Orca for the first time, it will 
-automatically enter setup mode. If you want to run setup 
+When you run <application>Orca</application> for the first time, it will automatically enter setup mode. If you want to run setup 
 at some later point, you can pass the
-<userinput>--setup</userinput> option to Orca the next 
-time you run it. Furthermore, while Orca is running, 
-you can press 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Space</keycap>
-</keycombo> to bring up the Orca setup window. Finally, 
-Orca provides a text setup utility that you can start 
-by passing the 
-<userinput>--text-setup</userinput> option to Orca. All 
-of these options will create a 
-<userinput>~/.orca/user-settings.py</userinput> file 
-that holds your preferences and will also enable the 
-accessibility infrastructure. You need to log out and 
-log back in for the new settings to take effect.
+<userinput>--setup</userinput> option to <application>Orca</application> the next 
+time you run it. Furthermore, while <application>Orca</application> is running, 
+you can press <keycombo><keycap>Insert</keycap><keycap>Space</keycap></keycombo> to bring up the <application>Orca</application> setup window. Finally, <application>Orca</application> provides a text setup utility that you can start by passing the 
+<userinput>--text-setup</userinput> option to <application>Orca</application>. All of these options will create a <userinput>~/.orca/user-settings.py</userinput> file that holds your preferences and will also enable the accessibility infrastructure. You need to log out and log back in for the new settings to take effect.
 </para>
 </section>
 
 <section>
 <title>How do I run Orca?</title>
 <para>
-Run Orca by typing <userinput>orca</userinput> in a 
-terminal session window. You can do so from a virtual 
-console window if you do not yet have access to the GUI.
-With the GUI installed you can also press
-<keycombo>
-<keycap>Alt</keycap>
-<keycap>F2</keycap>
-</keycombo> to bring up the Run dialog and then enter
-<userinput>orca</userinput>
-as the command (followed by any optional parameters). 
-Orca will automatically enter text setup mode if you run 
-it from a virtual console window or your GUI 
-environment is not yet set up for accessibility.
+Run <application>Orca</application> by typing <userinput>orca</userinput> in a terminal session window. You can do so from a virtual 
+console window if you do not yet have access to the GUI. With the GUI installed you can also press <keycombo><keycap>Alt</keycap>
+<keycap>F2</keycap></keycombo> to bring up the Run dialog and then enter <userinput>orca</userinput> as the command (followed by any optional parameters). <application>Orca</application> will automatically enter text setup mode if you run it from a virtual console window or your GUI environment is not yet set up for accessibility.
 </para>
 </section>
 
 <section>
 <title>Quitting Orca</title>
 <para>
-To quit Orca, press 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Q</keycap>
-</keycombo>. 
-A confirmation dialog will appear. Select Yes to quit. 
-If the system seems unresponsive, you can try a few
-things:
+To quit <application>Orca</application>, press <keycombo><keycap>Insert</keycap>
+<keycap>Q</keycap></keycombo>. A confirmation dialog will appear. Select <guilabel>Yes</guilabel> to quit. If the system seems unresponsive, you can try a few things:
 </para>
 <itemizedlist>
 <listitem>
 <para>
-Run <userinput>orca --quit</userinput> from a terminal 
-window, such as a virtual console: press 
-<keycombo>
-<keycap>Ctrl</keycap>
-<keycap>Alt</keycap>
-<keycap>F1</keycap>
-</keycombo> (on most Linux platforms) to get to a 
-virtual console, enter your commands, and then use 
-<keycombo>
-<keycap>Alt</keycap>
-<keycap>F7</keycap>
-</keycombo> 
-to get back to the desktop. This will kill the Orca
-process and reclaim system resources. You can then 
-rerun Orca using the previously outlined methods.
+Run <userinput>orca --quit</userinput> from a terminal window, such as a virtual console; press <keycombo><keycap>Ctrl</keycap>
+<keycap>Alt</keycap><keycap>F1</keycap>
+</keycombo> (on most Linux platforms) to get to a virtual console, enter your commands, and then use <keycombo><keycap>Alt</keycap>
+<keycap>F7</keycap></keycombo> to get back to the desktop. This will kill the <application>Orca</application> process and reclaim system resources. You can then 
+rerun <application>Orca</application> using the previously outlined methods.
 </para>
 <para>
-Press 
-<keycombo>
-<keycap>Ctrl</keycap>
-<keycap>Alt</keycap>
-<keycap>Backspace</keycap>
-</keycombo> 
-to end your login session and get back to the
-graphical login prompt (not implemented in all 
-Linux distributions).
+Press <keycombo><keycap>Ctrl</keycap>
+<keycap>Alt</keycap><keycap>Backspace</keycap>
+</keycombo> to end your login session and get back to the graphical login prompt (not implemented in all Linux distributions).
 </para>
 </listitem>
 </itemizedlist>
@@ -370,28 +220,18 @@ Linux distributions).
 <section>
 <title>How do I define my own keybindings?</title>
 <para>
-You can redefine your key bindings for Orca
-in two main ways. The first way is to choose between the 
-Desktop and Laptop layouts, which can be selected on the 
-General page of the Orca Configuration GUI (press 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Space</keycap>
-</keycombo> 
-to bring up Orca Preferences). For more refined 
+You can redefine your key bindings for <application>Orca</application> in two main ways. The first way is to choose between the 
+Desktop and Laptop layouts, which can be selected on the General page of the <application>Orca</application> configuration dialog (press <keycombo><keycap>Insert</keycap><keycap>Space</keycap></keycombo> to bring up Orca Preferences). For more refined 
 control, you can set individual key bindings 
-on the Key Bindings page of the Orca Configuration 
+on the Key Bindings page of the <application>Orca</application> configuration 
 dialog.
 </para>
 </section>
 
 <section>
-<title>Use a keyboard command to make Orca speak or 
-Braille-output the current date and time</title>
+<title>Use a keyboard command to make Orca speak or Braille-output the current date and time</title>
 <para>
-Place the following lines in 
-<userinput>~/.orca/orca-customizations.py</userinput>. 
-If this file doesn't exist yet, go ahead and create it.
+Place the following lines in <userinput>~/.orca/orca-customizations.py</userinput>. If this file doesn't exist yet, go ahead and create it.
 </para>
 <screen>
 <![CDATA[
@@ -431,13 +271,7 @@ orca.settings.keyBindingsMap["default"] = myKeyBindings
 </screen>
 
 <para>
-Note that in this case 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>D</keycap>
-</keycombo> 
-will be used to report current information about the 
-time and date.
+Note that in this case <keycombo><keycap>Insert</keycap><keycap>D</keycap></keycombo> will be used to report current information about the time and date.
 </para>
 </section>
 
@@ -445,132 +279,78 @@ time and date.
 <title>How do I set up my own custom scripts?</title>
 <para>
 Create an empty file named 
-<userinput>~/.orca/orca-scripts/__init__.py</userinput> 
-and place your custom scripts in 
+<userinput>~/.orca/orca-scripts/__init__.py</userinput> and place your custom scripts in 
 <userinput>~/.orca/orca-scripts</userinput>
-, Orca will pick up any scripts from there before 
-looking in the installed area.
+, <application>Orca</application> will pick up any scripts from there before looking in the installed area.
 </para>
 </section>
 
 <section>
 <title>Orca Configuration</title>
 <para>
-The Orca Configuration dialog allows you to customize 
-the behavior and features of Orca, such as speech, 
-Braille, and magnification. For example, you can select 
-which speech synthesis engine you want to use, whether 
-Braille is enabled or not, and which magnification 
-preferences 
-you want. You can select between laptop/desktop keyboard 
-layouts and you can also examine 
-and modify the existing keyboard layout with granular 
-control. To bring up the Orca Configuration dialog, 
-press 
-<keycombo>
-<keycap>&lt;ORCA MODIFIER&gt;</keycap>
-<keycap>Space</keycap>
-</keycombo>, where 
-<userinput>&lt;ORCA MODIFIER&gt;</userinput> is 
-<keycap>Insert</keycap> 
-when you use the desktop key bindings, and 
-<keycap>Caps Lock</keycap> 
-when you use the laptop key bindings.
+The <application>Orca</application> configuration dialog allows you to customize 
+the behavior and features of <application>Orca</application>, such as speech, Braille, and magnification. For example, you can select which speech synthesis engine you want to use, whether 
+Braille is enabled or not, and which magnification preferences you want. You can select between Laptop/Desktop keyboard 
+layouts and you can also examine and modify the existing keyboard layout with granular 
+control. To bring up the <application>Orca</application> configuration dialog, press 
+<keycombo><keycap>&lt;ORCA MODIFIER&gt;</keycap><keycap>Space</keycap></keycombo>, where <userinput>&lt;ORCA MODIFIER&gt;</userinput> is <keycap>Insert</keycap> 
+when you use the Desktop key bindings, and 
+<keycap>Caps Lock</keycap> when you use the Laptop key bindings.
 </para>
 
 <para>
-The Orca Configuration dialog is a multi-tab 
+The <application>Orca</application> configuration dialog is a multi-tab 
 container for several pages, each of which is 
 described in the following sections.
 </para>
 
 <section>
 <title>General Page</title>
-<para>The General page allows you to customize general
-aspects of Orca. These include the following:
+<para>The General page allows you to customize general aspects of <application>Orca</application>. These include the following:
 </para>
 
 <section>
 <title>Keyboard Layout</title>
 <para>
-The keyboard layout section lets you choose between a small keyboard layout (laptop) or large keyboard layout with a numeric keypad (desktop). If you choose Laptop the Orca system key is CapsLock; for the Desktop layout
-the Orca system key is Insert.
+The keyboard layout section lets you choose between a small keyboard layout (Laptop) or large keyboard layout with a numeric keypad (Desktop). If you choose Laptop the <application>Orca</application> system key is CapsLock; for the Desktop layout the system key is Insert.
 </para>
 </section>
 
 <section>
 <title>Show Orca Main Window</title>
 <para>
-The Orca main window provides you with a graphical way 
-to display the Orca Configuration dialog (also obtained 
-by <keycombo><keycap>Insert</keycap>
-<keycap>Space</keycap></keycombo>). Many users do not like the Orca main window because it shows up in the window manager's tab order when you press 
-<keycombo>
-<keycap>Alt</keycap>
-<keycap>Tab</keycap>
-</keycombo> to switch windows. By deselecting the <guilabel>Show Orca Main Window</guilabel> option, you can tell Orca to not show the Orca main window.
+The <application>Orca</application> main window provides you with a graphical way 
+to display the <application>Orca</application> configuration dialog (also obtained by <keycombo><keycap>Insert</keycap>
+<keycap>Space</keycap></keycombo>). Many users do not like the <application>Orca</application> main window because it shows up in the window manager's tab order when you press <keycombo><keycap>Alt</keycap>
+<keycap>Tab</keycap></keycombo> to switch windows. By deselecting the <guilabel>Show Orca Main Window</guilabel> option, you can tell <application>Orca</application> to not show its main window.
 </para>
 </section>
 
 <section>
 <title>Quit Orca without Confirmation</title>
 <para>
-Normally when you press 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Q</keycap>
-</keycombo> 
-or press the 
-<guibutton>Quit</guibutton>
-button in the Orca main window, Orca will pop up a 
-confirmation dialog asking you if you want to quit. 
-Unchecking this option prevents the confirmation 
-window from appearing.
+Normally when you press <keycombo><keycap>Insert</keycap><keycap>Q</keycap></keycombo> or press the <guibutton>Quit</guibutton> button in the <application>Orca</application> main window,  a confirmation dialog will prompt if you really want to quit. Unchecking this option prevents the confirmation window from appearing.
 </para>
 </section>
 
 <section>
 <title>Disable gksu keyboard grab</title>
 <para>
-When running system administration commands from the 
-launch menu, many distributions use an application
-known as 
-<application>gksu</application>
-to authorize the user to run these commands ( 
-<application>gksu</application>
-is the dialog that asks you for your password). When it 
-runs, 
-<application>gksu</application>
-enables what is known as a "keyboard grab," which is a 
-feature to prevent keyboard actions from going to any 
-other application on the desktop, including Orca. The 
-result of a keyboard grab is that Orca will not receive 
-any keyboard events, preventing Orca from functioning 
-normally.
-</para>
-<para>By selecting the 
-<guibutton>Disable gksu Keyboard Grab</guibutton>
-button, you will turn off the keyboard grab behavior, 
-allowing Orca to function normally with system 
-administration applications.
+When running system administration commands from the launch menu, many distributions use an application known as <application>gksu</application> to authorize the user to run these commands (<application>gksu</application> is the dialog that asks you for your password). When it runs, <application>gksu</application> enables what is known as a "keyboard grab," which is a 
+feature to prevent keyboard actions from going to any other application on the desktop, including <application>Orca</application>. The result of a keyboard grab is that <application>Orca</application> will not receive any keyboard events, preventing <application>Orca</application> from functioning normally.
+</para>
+<para>
+By selecting the <guibutton>Disable gksu Keyboard Grab</guibutton> button, you will turn off the keyboard grab behavior, 
+allowing <application>Orca</application> to function normally with system administration applications.
 </para>
 
 <note>
 <para>
 The keyboard grab is a security attempt by
-<application>gksu</application>to prevent nefarious
-applications from "sniffing" the keyboard and obtaining
-your password. Please be advised that disabling 
-<application>gksu</application>'s keyboard grab feature
-can expose you to such nefarious behavior.
+<application>gksu</application> to prevent malicious applications from "sniffing" the keyboard and obtaining your password. Please be advised that disabling <application>gksu</application>'s keyboard grab feature can expose you to such nefarious behavior.
 </para>
-
 <para>
-If you do not feel comfortable with this, you can always 
-use the root account for system administration purposes. 
-To do so, you need to enable the root account for login, 
-and then log out and back in again as root whenever you 
-want to perform a system administration command.
+If you do not feel comfortable with this, you can always use the root account for system administration purposes. To do so, you need to enable the root account for login, and then log out and back in again as root whenever you want to perform a system administration command.
 </para>
 </note>
 </section>
@@ -578,16 +358,7 @@ want to perform a system administration command.
 <section>
 <title>Present Tooltips</title>
 <para>
-When checked, this option will tell Orca to present
-information about tooltips when they appear as the 
-result of mouse hovering. Specific actions to force 
-tooltips to appear, such as pressing 
-<keycombo>
-<keycap>Ctrl</keycap>
-<keycap>F1</keycap>
-</keycombo> 
-when an object has focus, will always result in tooltips 
-being presented, regardless of this setting.
+When checked, this option will tell <application>Orca</application> to present information about tooltips when they appear as the result of mouse hovering. Specific actions to force tooltips to appear, such as pressing <keycombo><keycap>Ctrl</keycap><keycap>F1</keycap></keycombo> when an object has focus, will always result in tooltips being presented, regardless of this setting.
 </para>
 </section>
 </section>
@@ -595,40 +366,25 @@ being presented, regardless of this setting.
 <section>
 <title>Speech Page</title>
 <para>
-The speech page allows you to customize how Orca uses
-speech synthesis.
+The speech page allows you to customize how <application>Orca</application> uses speech synthesis.
 </para>
 
 <section>
 <title>Enable Speech</title>
 <para>
-The first control of note on the speech page is the
-<guilabel>Enable Speech</guilabel> check box. This 
-check box toggles whether or not Orca will make use of 
-a speech synthesizer. This option, along with the 
-ability to enable Braille and magnifier support, allows 
-Orca to be tailored to meet the specific needs of a 
-wide variety of users.
+The first control of note on the speech page is the <guilabel>Enable Speech</guilabel> check box. This check box toggles whether or not <application>Orca</application> will make use of a speech synthesizer. This option, along with the ability to enable Braille and magnifier support, allows <application>Orca</application> to be tailored to meet the specific needs of a wide variety of users.
 </para>
 </section>
 
 <section>
 <title>Speech System and Speech Synthesizer</title>
 <para>
-The next two controls deal with selecting the speech 
-system and synthesizer. Orca provides support for a 
-growing number of speech systems. At the time of this
-writing these include GNOME-speech, Emacspeak, and an
-experimental backend for Speech Dispatcher. Depending
-on how your machine is configured, you may have all or
-none of these options. Typically, you will only have
-GNOME-speech available.
+The next two controls deal with selecting the speech system and synthesizer. <application>Orca</application> provides support for a growing number of speech systems. At the time of this writing these include GNOME-speech, Emacspeak, and an
+experimental backend for Speech Dispatcher. Depending on how your machine is configured, you may have all or none of these options. Typically, you will only have GNOME-speech available.
 </para>
 
 <para>
-First, determine which speech system you would like to 
-use - GNOME-speech works best at this time. After making 
-your selection, tab to the speech synthesizer combo box 
+First, determine which speech system you would like to use - GNOME-speech works best at this time. After making your selection, tab to the speech synthesizer combo box 
 and choose from the list of available synthesizers.
 </para>
 </section>
@@ -636,63 +392,36 @@ and choose from the list of available synthesizers.
 <section>
 <title>Voice Settings</title>
 <para>
-If your synthesizer supports it, Orca can utilize
-multiple voices in order to identify special cases 
-within an application, such as hyperlinks or uppercase 
-text. The voice settings and person combo boxes can be 
-adjusted to customize these settings to your liking. 
-For example, assume you were using Fonix DECtalk and 
-wanted the Betty voice to denote uppercase. To 
-accomplish this, you could do the following:
+If your synthesizer supports it, <application>Orca</application> can utilize multiple voices in order to identify special cases within an application, such as hyperlinks or uppercase text. The voice settings and person combo boxes can be 
+adjusted to customize these settings to your liking. For example, assume you were using Fonix DECtalk and wanted the Betty voice to denote uppercase. To accomplish this, you could do the following:
 </para>
 <orderedlist numeration='arabic'>
 <listitem>
 <para>
-Tab to the voice settings combo box, and press the
-down arrow until the uppercase voice is selected.
+Tab to the voice settings combo box, and press the down arrow until the uppercase voice is selected.
 </para>
 </listitem>
 <listitem>
 <para>
-Tab to the person combo box, and press the down arrow 
-to choose the Betty voice.
+Tab to the person combo box, and press the down arrow to choose the Betty voice.
 </para>
 </listitem>
 </orderedlist>
 <para>
-The next three sliders in the tab order allow adjustment 
-of the synthesizer's rate, pitch and volume, 
-respectively.
+The next three sliders in the tab order allow adjustment of the synthesizer's rate, pitch and volume, respectively.
 </para>
 <para>
-Note that you can quickly raise/lower the pitch by
-pressing 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Up Arrow</keycap>
-</keycombo> and 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Down Arrow</keycap>
-</keycombo>. You can also modify the speaking rate by
-pressing 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Left Arrow</keycap>
-</keycombo> and 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Right Arrow</keycap>
-</keycombo>.
+Note that you can quickly raise/lower the pitch by pressing <keycombo><keycap>Insert</keycap><keycap>Up Arrow</keycap></keycombo> and <keycombo><keycap>Insert</keycap>
+<keycap>Down Arrow</keycap></keycombo>. You can also modify the speaking rate by pressing 
+<keycombo><keycap>Insert</keycap><keycap>Left Arrow</keycap></keycombo> and <keycombo>
+<keycap>Insert</keycap><keycap>Right Arrow</keycap></keycombo>.
 </para>
 </section>
 
 <section>
 <title>Punctuation Level</title>
 <para>
-The <guilabel>Punctuation Level</guilabel> radio button 
-group is used to adjust the amount of punctuation 
-spoken by the synthesizer. The available levels are 
+The <guilabel>Punctuation Level</guilabel> radio button group is used to adjust the amount of punctuation spoken by the synthesizer. The available levels are 
 None, Some, Most and All.
 </para>
 </section>
@@ -700,65 +429,38 @@ None, Some, Most and All.
 <section>
 <title>Verbosity</title>
 <para>
-The Verbosity setting determines the amount of 
-information that will be spoken in certain situations.
-For example, if it is set to <guilabel>Verbose
-</guilabel>, the synthesizer
-will speak shortcut keys for items in pull-down menus.
-When it is set to <guilabel>Brief</guilabel>, 
-these shortcut keys are not announced.
+The Verbosity setting determines the amount of information that will be spoken in certain situations. For example, if it is set to <guilabel>Verbose</guilabel>, the synthesizer
+will speak shortcut keys for items in pull-down menus. When it is set to <guilabel>Brief</guilabel>, these shortcut keys are not announced.
 </para>
 </section>
 
 <section>
 <title>Table Row Speech</title>
 <para>
-The table row speech option determines the way in which 
-Orca will read items within tables. The available 
+The table row speech option determines the way in which <application>Orca</application> will read items within tables. The available 
 settings are <guilabel>Speak Current Row
-</guilabel> or <guilabel>Speak Current Cell</guilabel>.
-The ability to adjust this behavior can be useful in 
-many situations. For example, consider the process of 
-browsing email messages in Evolution. In this instance 
-it may be preferable to set table speech to
-<guilabel>Speak Current Row</guilabel>, so 
-arrowing through the list of messages causes all 
-relevant info, such as the sender, subject, and whether 
-the message has attachments, is read automatically. 
-While the current row setting is active, it is still 
-possible to read individual cells by using the left and 
-right arrows.
-</para>
-<para>
-Note that you can quickly toggle this behavior by
-pressing 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>F11</keycap>
-</keycombo>.
+</guilabel> or <guilabel>Speak Current Cell</guilabel>. The ability to adjust this behavior can be useful in many situations. For example, consider the process of 
+browsing email messages in Evolution. In this instance it may be preferable to set table speech to <guilabel>Speak Current Row</guilabel>, so arrowing through the list of messages causes all relevant info, such as the sender, subject, and whether the message has attachments, is read automatically. 
+While the current row setting is active, it is still possible to read individual cells by using the left and right arrows.
+</para>
+<para>
+Note that you can quickly toggle this behavior by pressing <keycombo><keycap>Insert</keycap><keycap>F11</keycap></keycombo>.
 </para>
 </section>
 
 <section>
 <title>Speak Indentation</title>
 <para>
-When working with code or editing documents, it is
-often desirable to be aware of justification as well as
-indentation. Selecting the 
-<guilabel>Speak Indentation and Justification</guilabel>
-check box will cause Orca to provide this information.
+When working with code or editing documents, it is often desirable to be aware of justification as well as indentation. Selecting the <guilabel>Speak Indentation and Justification</guilabel> check box will cause <application>Orca</application> to provide this information.
 </para>
 </section>
 
 <section>
 <title>Speak Blank Lines</title>
 <para>
-Some users desire to hear the word "blank" when 
-navigating through empty lines in a document. Other 
-users do not. If the    
+Some users desire to hear the word "blank" when navigating through empty lines in a document. Other users do not. If the    
 <guilabel>Speak Blank Lines</guilabel> 
-check box is selected, Orca will announce any blank 
-lines.
+check box is selected, <application>Orca</application> will announce any blank lines.
 </para>
 </section>
 </section>
@@ -766,25 +468,14 @@ lines.
 <section>
 <title>Braille Page</title>
 <para> 
-The Braille page allows you to customize various
-aspects of Braille output. Orca does not automatically 
-start BrlTTY - you typically need to do this yourself, 
-and it usually occurs during OS startup.
+The Braille page allows you to customize various aspects of Braille output. <application>Orca</application> does not automatically start BrlTTY - you typically need to do this yourself, and it usually occurs during OS startup.
 </para>
 
 <section>
 <title>Enable Braille Support</title>
 <para>
 The first control on the Braille page is the 
-<guilabel>Enable Braille Support</guilabel> check box.
-This toggles whether or not Orca will make use of a 
-Braille display. This option, along with the ability
-to enable Braille and magnifier support, allows
-Orca to be tailored to meet the needs of a wide variety
-of users. By default, this check box is enabled. If
-BrlTTY is not running, Orca will recover gracefully and
-will not communicate with the Braille display. If you
-configure BrlTTY later on, you need to restart Orca in
+<guilabel>Enable Braille Support</guilabel> check box. This toggles whether or not <application>Orca</application> will make use of a Braille display. This option, along with the ability to enable Braille and magnifier support, allows <application>Orca</application> to be tailored to meet the needs of a wide variety of users. By default, this check box is enabled. If BrlTTY is not running, <application>Orca</application> will recover gracefully and will not communicate with the Braille display. If you configure BrlTTY later on, you need to restart <application>Orca</application> in
 order for it to use Braille.
 </para>
 </section>
@@ -792,42 +483,27 @@ order for it to use Braille.
 <section>
 <title>Enable Braille Monitor</title>
 <para>
-Orca's Braille monitor provides an on-screen
-representation of what takes place on the Braille
-display. This feature is mostly for demonstration
-purposes, but is also useful for Orca developers who do
-not have access to a Braille display.
+<application>Orca</application>'s Braille monitor provides an on-screen representation of what takes place on the Braille display. This feature is mostly for demonstration
+purposes, but is also useful for <application>Orca</application> developers who do not have access to a Braille display.
 </para>
 </section>
 
 <section>
 <title>Abbreviated Role Names</title>
 <para>
-The <guilabel>Abbreviated Role Names</guilabel> check 
-box determines the manner in which role names are 
-displayed and can be used to help conserve real estate 
-on the Braille display. This option is best explained by
-example:
+The <guilabel>Abbreviated Role Names</guilabel> check box determines the manner in which role names are displayed and can be used to help conserve real estate on the Braille display. This option is best explained by example:
 </para>
 <para>
-Let us assume that a slider had focus, and that the 
-abbreviated role names box was not checked. In that
-case, the word "slider" would be shown on the display, 
-to reflect the fact that the current control was indeed 
-a slider. If the abbreviated role names box was checked,
-the word "slider" would be abbreviated to "sldr".
+Let us assume that a slider had focus, and that the abbreviated role names box was not checked. In that case, the word "slider" would be shown on the display, to reflect the fact that the current control was indeed 
+a slider. If the abbreviated role names box was checked, the word "slider" would be abbreviated to "sldr".
 </para>
 </section>
 
 <section>
 <title>Verbosity</title>
 <para>
-The <guilabel>Verbosity</guilabel> radio button group
-determines the amount of information that will be
-output to Braille in certain situations. For example, if 
-it is set to Verbose, keyboard shortcut and role name 
-information is displayed. This information is not 
-displayed in Brief mode.
+The <guilabel>Verbosity</guilabel> radio button group determines the amount of information that will be output to Braille in certain situations. For example, if it is set to Verbose, keyboard shortcut and role name 
+information is displayed. This information is not displayed in Brief mode.
 </para>
 </section>
 </section>
@@ -835,8 +511,7 @@ displayed in Brief mode.
 <section>
 <title>Key Echo Page</title>
 <para>
-The Key Echo page allows you to specify the behavior
-of Orca when pressing keys on the page and whether 
+The Key Echo page allows you to specify the behavior of <application>Orca</application> when pressing keys on the page and whether 
 words are spoken as you complete them.
 </para>
 
@@ -844,25 +519,13 @@ words are spoken as you complete them.
 <title>Enable Key Echo</title>
 <para>
 The first control on the key echo page is the 
-<guilabel>Enable Key Echo</guilabel> check box. When 
-this box is checked, five additional check boxes become
-available. These are 
-<guilabel>Enable Alphanumeric and Punctuation Keys
-</guilabel>, 
-<guilabel>Enable Modifier Keys</guilabel>, 
-<guilabel>Enable Locking Keys</guilabel>, 
-<guilabel>Enable Function Keys</guilabel>, and 
-<guilabel>Enable Action Keys</guilabel>.
+<guilabel>Enable Key Echo</guilabel> check box. When this box is checked, five additional check boxes become available. These are <guilabel>Enable Alphanumeric and Punctuation Keys</guilabel>, <guilabel>Enable Modifier Keys</guilabel>, <guilabel>Enable Locking Keys</guilabel>, <guilabel>Enable Function Keys</guilabel>, and <guilabel>Enable Action Keys</guilabel>.
 </para>
 <para>
-The alphanumeric and punctuation option determines if
-letter, number and punctuation characters are echoed as
-you type them.
+The alphanumeric and punctuation option determines if letter, number and punctuation characters are echoed as you type them.
 </para>
-
 <para>
-Modifier keys are those such as 
-<keycap>Shift</keycap>, 
+Modifier keys are those such as <keycap>Shift</keycap>,
 <keycap>Control</keycap>, and 
 <keycap>Alt</keycap>.
 </para>
@@ -875,13 +538,11 @@ Locking keys include
 </para>
 
 <para>
-Enabling function key echo will announce F1 - F12 when
-they are pressed.
+Enabling function key echo will announce F1 - F12 when they are pressed.
 </para>
 
 <para>
-The action keys group consists of keys that perform
-some logical action, as 
+The action keys group consists of keys that perform some logical action, as 
 <keycap>Backspace</keycap>, 
 <keycap>Return</keycap> and 
 <keycap>Tab</keycap>.
@@ -892,17 +553,11 @@ some logical action, as
 <title>Enable Echo by Word</title>
 <para>
 The last toggle on the Key Echo page is the 
-<guilabel>Enable Echo by Word</guilabel> check box. This
-option is always available, regardless of whether any 
-of the key echo options are checked. When enabled, 
-whole words are spoken as typing progresses.
+<guilabel>Enable Echo by Word</guilabel> check box. This option is always available, regardless of whether any of the key echo options are checked. When enabled, whole words are spoken as typing progresses.
 </para>
 
 <para>
-In summary, the Key Echo scheme can offer a great
-deal of flexibility. For example, one user might choose
-to enable all Key Echo options, while another might
-prefer to use word echo, but only have locking keys
+In summary, the Key Echo scheme can offer a great deal of flexibility. For example, one user might choose to enable all Key Echo options, while another might prefer to use word echo, but only have locking keys
 announced.
 </para>
 </section>
@@ -911,21 +566,13 @@ announced.
 <section>
 <title>Magnifier Page</title>
 <para>
-The magnifier page allows you to enable/disable
-magnification and specify how magnification is
-performed.
+The magnifier page allows you to enable/disable magnification and specify how magnification is performed.
 </para>
 
 <section>
 <title>Enable Magnifier</title>
 <para>
-The first control on the magnifier page is the 
-<guilabel>Enable Magnifier</guilabel> check box. This
-toggles whether or not Orca will provide
-magnification. This option, along with the ability to
-enable speech and Braille support, allow Orca to
-be tailored to meet the needs of a wide variety of
-users.
+The first control on the magnifier page is the <guilabel>Enable Magnifier</guilabel> check box. This toggles whether or not <application>Orca</application> will provide magnification. This option, along with the ability to enable speech and Braille support, allow <application>Orca</application> to be tailored to meet the needs of a wide variety of users.
 </para>
 </section>
 
@@ -1000,73 +647,46 @@ where to put the magnified area. Typically
 <section>
 <title>Key Bindings Page</title>
 <para>
-The key bindings page allows you to examine and
-modify the key bindings for Orca.
+The key bindings page allows you to examine and modify the key bindings for <application>Orca</application>.
 </para>
 
 <section>
 <title>Orca Modifier Key(s)</title>
 <para>
-The first control on the Key Bindings page allows
-you to examine which key (or keys) acts as the "Orca
-modifier" (Orca system key). The Orca modifier is the 
-key that you press and hold in conjunction with other 
-keys to give commands to Orca. For desktop keyboards, 
-the Orca modifier defaults to 
-<keycap>Insert</keycap>. 
-For laptop keyboards, the Orca modifier defaults to the 
-<keycap>Caps Lock</keycap> key.
+The first control on the Key Bindings page allows you to examine which key (or keys) acts as the "Orca modifier" (<application>Orca</application> system key). The <application>Orca</application> modifier is the key that you press and hold in conjunction with other 
+keys to give commands to <application>Orca</application>. For Desktop keyboards, the modifier defaults to <keycap>Insert</keycap>. 
+For Laptop keyboards, the modifier defaults to the <keycap>Caps Lock</keycap> key.
 </para>
 <para>
-You cannot modify the Orca modifier key(s) using
-the Configuration dialog at this time.
+You cannot modify the <application>Orca</application> modifier key(s) using the configuration dialog at this time.
 </para>
 </section>
 
 <section>
 <title>Key Bindings Table</title>
 <para>
-The key bindings table provides a list of Orca
+The key bindings table provides a list of <application>Orca</application>
 operations and the keys that are bound to them.
 </para>
 <para>
-The "Function" column header is a description of
-the Ora operation to be performed.
+The "Function" column header is a description of the operation to be performed.
 </para>
-
 <para>
 The "Key Binding" header is the primary way to
-invoke the function from the keyboard. Note that the
-function description may include the word Orca. This
-indicates that the Orca modifier key should be held down
-along with the other key(s).
+invoke the function from the keyboard. Note that the function description may include the word <literal>Orca</literal>. This indicates that the <application>Orca</application> modifier key should be held down along with the other key(s).
 </para>
-
 <para>
 The "Alternate" header provides an alternate
 mechanism for invoking the function from the
 keyboard.
 </para>
-
 <para>
 To modify either the "Key Binding" or the
-"Alternate" bindings, arrow to the cell and press 
-<keycap>Return</keycap>. Then, press a key combination
-and press <keycap>Return</keycap> to confirm the new 
-combination. When you do so, the new keystroke will be 
-saved and the check box in the 
-<guilabel>Modified</guilabel> column will indicate that
-the key binding has been modified.
+"Alternate" bindings, arrow to the cell and press <keycap>Return</keycap>. Then, press a key combination and press <keycap>Return</keycap> to confirm the new combination. When you do so, the new keystroke will be saved and the check box in the <guilabel>Modified</guilabel> column will indicate that the key binding has been modified.
 </para>
-
 <para>
-To undo a modified keybinding, arrow to the modified 
-column, uncheck the checkbox, and press the 
-<guibutton>Apply</guibutton> button ( 
-<keycombo>
-<keycap>Alt</keycap>
-<keycap>A</keycap>
-</keycombo>).
+To undo a modified keybinding, arrow to the modified column, uncheck the checkbox, and press the <guibutton>Apply</guibutton> button (<keycombo><keycap>Alt</keycap>
+<keycap>A</keycap></keycombo>).
 </para>
 </section>
 </section>
@@ -1074,29 +694,17 @@ column, uncheck the checkbox, and press the
 <section>
 <title>Text Attributes Page</title>
 <para>
-Orca will speak known text attribute information
-about an object when you press 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>F</keycap>
-</keycombo> ( 
-<keycombo>
-<keycap>Caps Lock</keycap>
-<keycap>F</keycap>
-</keycombo> 
-for laptop systems).
+<application>Orca</application> will speak known text attribute information about an object when you press 
+<keycombo><keycap>Insert</keycap>
+<keycap>F</keycap></keycombo> (<keycombo>
+<keycap>Caps Lock</keycap><keycap>F</keycap>
+</keycombo> for Laptop systems).
 </para>
-
 <para>
-Because the number of text attributes is large, and
-not everyone cares about every attribute, the "Text
-Attributes" tab of the Configuration dialog allows you 
-to customize which text attributes Orca will present.
+Because the number of text attributes is large, and not everyone cares about every attribute, the "Text Attributes" tab of the <application>Orca</application> configuration dialog allows you to customize which text attributes will be presented.
 </para>
-
 <para>
-On this tab is a text attribute list, where each row
-consists of three columns:
+On this tab is a text attribute list, where each row consists of three columns:
 </para>
 <orderedlist numeration='arabic'>
 <listitem>
@@ -1111,46 +719,25 @@ whether this text attribute should be spoken or not.
 <listitem>
 <para>
 An editable "Spoken unless" string value. By
-default, not all text attributes will have this set. If
-present, what it means (assuming the user wants this
-text attribute spoken) is that the value of the
-attribute will only be spoken if it's a different value
-than this value.
+default, not all text attributes will have this set. If present, what it means (assuming the user wants this text attribute spoken) is that the value of the attribute will only be spoken if it's a different value than this value.
 </para>
 </listitem>
 </orderedlist>
 <para>
 For example, by default the "underline" text
-attribute has a value of "none". If the user has this
-attribute checked and the user presses 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>F</keycap>
-</keycombo> and the text in question is not underlined, 
-then this attribute is not spoken. If you always want 
-this attribute to be spoken regardless of whether the 
-text is underlined, then the attribute should be 
-checked and the "Spoken unless" value cleared.
+attribute has a value of "none". If the user has this attribute checked and the user presses <keycombo><keycap>Insert</keycap>
+<keycap>F</keycap></keycombo> and the text in question is not underlined, then this attribute is not spoken. If you always want 
+this attribute to be spoken regardless of whether the text is underlined, then the attribute should be checked and the "Spoken unless" value cleared.
 </para>
 <para>
-There is also a <guibutton>Reset</guibutton> button ( 
-<keycombo>
-<keycap>Alt</keycap>
-<keycap>R</keycap>
-</keycombo>) that will set the
-list values back to their initial state when the dialog 
-was first displayed.
+There is also a <guibutton>Reset</guibutton> button (<keycombo><keycap>Alt</keycap>
+<keycap>R</keycap></keycombo>) that will set the list values back to their initial state when the dialog was first displayed.
 </para>
-
 <para>
-When you initially display the text attribute pane,
-all your checked attributes are put at the top of the 
-list. They are given in the order that they will be 
-spoken and output to Braille.
+When you initially display the text attribute pane, all your checked attributes are put at the top of the list. They are given in the order that they will be spoken and output to Braille.
 </para>
 <para>
-If you decide to check others or wish to adjust the
-order, there are four buttons to help you do this:
+If you decide to check others or wish to adjust the order, there are four buttons to help you do this:
 </para>
 <itemizedlist>
 <listitem>
@@ -1158,8 +745,7 @@ order, there are four buttons to help you do this:
 <keycombo>
 <keycap>Alt</keycap>
 <keycap>T</keycap>
-</keycombo>) - moves the selected attribute to the top 
-of the list.
+</keycombo>) - moves the selected attribute to the top of the list.
 </para>
 </listitem>
 <listitem>
@@ -1183,22 +769,16 @@ of the list.
 <keycombo>
 <keycap>Alt</keycap>
 <keycap>B</keycap>
-</keycombo>) - moves the selected attribute to the 
-bottom of the list.
+</keycombo>) - moves the selected attribute to the bottom of the list.
 </para>
 </listitem>
 </itemizedlist>
 <para>
-Text attributes can also be set on an individual
-application basis. The text attribute pane is also part 
-of the application specific settings dialog that is 
-started when you give a particular application focus 
-and press 
-<keycombo>
-<keycap>Insert</keycap>
-<keycap>Ctrl</keycap>
-<keycap>Space</keycap>
-</keycombo>.</para>
+Text attributes can also be set on an individual application basis. The text attribute pane is also part of the application specific settings dialog that is 
+started when you give a particular application focus and press <keycombo>
+<keycap>Insert</keycap><keycap>Ctrl</keycap>
+<keycap>Space</keycap></keycombo>.
+</para>
 </section>
 </section>
 </section>
@@ -1208,63 +788,43 @@ and press
 <section>
 <title>Accessible Applications</title>
 <para>
-Orca is designed to work with applications and toolkits
-that support the Assistive Technology Service Provider
-Interface (AT-SPI). This includes the GNOME Desktop and 
-its applications, OpenOffice, Firefox, and the Java 
-platform. Some applications work better than others, 
-however, and the Orca community continually works to 
-provide superior access to more and more applications.
+<application>Orca</application> is designed to work with applications and toolkits
+that support the Assistive Technology Service Provider Interface (AT-SPI). This includes the GNOME Desktop and its bundled applications: OpenOffice, Firefox, and the Java platform. Some applications work better than others, however, and the <application>Orca</application> community continually works to provide superior access to more and more applications.
 </para>
 </section>
 
 <section>
 <title>Using Adobe's Acrobat Reader</title>
 <para>
-We are currently working on a script for Adobe's
-Acrobat Reader, and the initial version has been 
-contributed to Orca v2.17.5. Note that there is still 
-work to do, and we are very encouraged by Adobe's 
-commitment to accessibility.
+We are currently working on a script for Adobe's Acrobat Reader, and the initial version has been contributed to <application>Orca</application> v2.17.5. Note that there is still work to do, and we are very encouraged by Adobe's commitment to accessibility.
 </para>
 
 <section>
 <title>Installation</title>
 <para>
-If you get Adobe Acrobat Reader directly from the 
-<ulink url='http://www.adobe.com/products/acrobat/
-readstep2.html'>Adobe site</ulink>,
+If you get Adobe Acrobat Reader directly from the <ulink url='http://www.adobe.com/products/acrobat/readstep2.html'>Adobe site</ulink>,
 you may find that the software will not
-launch. The symptoms: If launched from the Applications
-menu, it appears that nothing has happened. If launched
-from a terminal window, you receive a long series of 
-syntax error messages. Should this occur, you will need 
-to edit your /usr/bin/acroread file as described in this 
-<ulink url='http://ubuntuforums.org/showthread.php
+launch. If launched from the Applications
+menu, it may appear that nothing has happened, or if launched from a terminal window you may receive a long series of 
+syntax error messages. Should this occur, you will need to edit your /usr/bin/acroread file as described in this <ulink url='http://ubuntuforums.org/showthread.php
 ?t=233514'>Ubuntu forum thread</ulink>.
 </para>
 <para>
-If you instead choose to install Acrobat Reader from
-your distribution's packages, be sure to install both
-acroread and acroread-plugins. Without the plugins 
-package, you will not have the access to the "Reading" 
-category in the 
-<menuchoice>
+If you instead choose to install Acrobat Reader from your distribution's packages, be sure to install both <application>acroread</application> and <application>acroread-plugins</application>. Without the plugins 
+package, you will not have the access to the "Reading" category in the <menuchoice>
 <guimenuitem>Edit-</guimenuitem>
 <guimenuitem>Preferences</guimenuitem>
 </menuchoice> dialog.
 </para>
 <para>
 Note: If you use Ubuntu and cannot locate the
-acroread package, you will likely need to edit your
-/etc/apt/sources.list to include the 'multiverse'
-repository. Then run 
+<application>acroread</application> package, you will likely need to edit your
+/etc/apt/sources.list to include the 'multiverse' repository. Then run 
 <userinput>apt-get update</userinput>. 
-Having done so, you should then be able to install both 
-acroread and acroread-plugins.
+Having done so, you should then be able to install both <application>acroread</application> and <application>acroread-plugins</application>.
 </para>
 </section>
-
+             <--- 5/21/08 vpa // here --->
 <section>
 <title>Enabling Accessibility and Caret Navigation</title>
 <para>