Latest source files for the Accessibility Guide. These files have not been updated yet for GNOME 2.12.

9 files changed, 491 insertions, 347 deletions

diff --git a/gnome2-accessibility-guide/C/accessintro.xml b/gnome2-accessibility-guide/C/accessintro.xml
index cb5476e..30ceb8b 100644
--- a/gnome2-accessibility-guide/C/accessintro.xml
+++ b/gnome2-accessibility-guide/C/accessintro.xml
@@ -13,13 +13,13 @@ to use the software easily and efficiently. Recent legislation such as Section
 508 of the U.S. Rehabilitation Act heightens awareness of the need to provide
 accessible software. </para>
 <para>The GNOME Desktop is easy to use and incorporates many accessibility features. Every
-application and utility in the GNOME Desktop is designed with accessibility and usability in mind. Users
+supported application and utility in the GNOME Desktop is designed with accessibility and usability in mind. Users
 with physical disabilities such as low vision or impaired motor skills can
 use all of the functionality of the GNOME Desktop thanks to the customization tools that are available. The
 customization tools enable you to customize the appearance and behavior of
 the desktop.</para>
 <para>The ability to easily customize the GNOME Desktop contributes greatly to the accessibility of the desktop.
-This guide describes the various customization options that you
-can use to tailor the desktop to suit your particular needs.</para>
+This guide describes the various customization options that you can use to
+tailor the desktop to suit your particular needs.</para>
 </sect1>
 </chapter>
diff --git a/gnome2-accessibility-guide/C/ats.xml b/gnome2-accessibility-guide/C/ats.xml
index 649e94d..8df0dcc 100644
--- a/gnome2-accessibility-guide/C/ats.xml
+++ b/gnome2-accessibility-guide/C/ats.xml
@@ -14,6 +14,12 @@ disability to use the desktop:</para>
 </para>
 </listitem>
 </itemizedlist>
+<note>
+<para>Before you can use the <application>On-Screen Keyboard</application>
+and <application>Screen Reader and Magnifier</application> on Solaris systems,
+you must follow the steps outlined in <xref linkend="sysadmin-55"/> of this
+guide.</para>
+</note>
 <sect1 id="ats-1">
 <title>On-Screen Keyboard</title>
 <indexterm>
@@ -23,8 +29,8 @@ disability to use the desktop:</para>
 <primary>GOK</primary>
 </indexterm>
 <para>The <application>On-Screen Keyboard</application>
-application displays virtual keyboards on your desktop that you can operate
-using the standard mouse pointer or alternative pointing device. <application>On-Screen Keyboard</application> displays the following types of keyboards:</para>
+application displays virtual keyboards on your desktop. You can use the standard
+mouse pointer or alternative pointing device to operate the virtual keyboards. <application>On-Screen Keyboard</application> displays the following types of keyboards:</para>
 <itemizedlist>
 <listitem>
 <para>Compose keyboards that enable you to compose text. To type
@@ -39,24 +45,22 @@ or the menus that are contained in an application. </para>
 </listitem>
 </itemizedlist>
 <para>To start <application>On-Screen Keyboard</application>, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>On-Screen
-Keyboard</guimenuitem></menuchoice>. For more information about the application,
-see the online Help for <application>On-Screen Keyboard</application>.</para>
+Keyboard</guimenuitem></menuchoice>. For more information about the <application>On-Screen Keyboard</application> application, see the online Help for <application>On-Screen Keyboard</application>.</para>
 <sect2 id="ats-5">
-<title>Maximizing Terminal for On-Screen Keyboard Users</title>
+<title>Maximizing Application Windows for On-Screen Keyboard Users</title>
 <indexterm>
 <primary>maximizing Terminal for On-Screen Keyboard users</primary>
 </indexterm>
-<para>If you are a <application>On-Screen Keyboard</application>
-user, you cannot use the <application>Terminal</application> application in
-Full Screen mode because the <guilabel>Terminal</guilabel> window obscures
-the <application>On-Screen Keyboard</application> display.</para>
-<para>To resize the <guilabel>Terminal</guilabel> window for use with the <application>On-Screen Keyboard</application> application, perform the following steps:</para>
+<para>If you are an <application>On-Screen Keyboard</application>
+user, you cannot use any application in Full Screen mode because the application
+window obscures the <application>On-Screen Keyboard</application> display.</para>
+<para>To resize the window for use with the <application>On-Screen Keyboard</application> application, perform the following steps:</para>
 <orderedlist>
 <listitem>
-<para>Do not enable the Full Screen mode in <application>Terminal</application>.</para>
+<para>Do not enable the Full Screen mode in the application.</para>
 </listitem>
 <listitem>
-<para>Give focus to the <guilabel>Terminal</guilabel> window.</para>
+<para>Give focus to the application window.</para>
 </listitem>
 <listitem>
 <para>Press <keycap>F10</keycap> to maximize the application.</para>
@@ -92,14 +96,18 @@ to aid low-vision users.</para>
 <para>To start <application>Screen Reader and Magnifier</application>, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Screen
 Reader and Magnifier</guimenuitem></menuchoice>. For more information about
 the application, see the online Help for <application>Screen Reader and Magnifier</application>.</para>
-<sect2 id="ats-6">
-<title>Disabling the Screensaver for Screen Reader and Magnifier Users</title>
+</sect1>
+<sect1 id="ats-6">
+<title>Disabling the Screensaver</title>
 <indexterm>
 <primary>Screen Reader and Magnifier</primary>
-<secondary>disabling screensaver</secondary>
+<secondary>disabling
+screensaver</secondary>
 </indexterm>
-<para>To disable the screensaver,
-perform the following steps:</para>
+<para>Before you use <application>On-Screen
+Keyboard</application> or <application>Screen Reader and Magnifier</application>,
+you must disable the screensaver. To disable the screensaver, perform the
+following steps:</para>
 <orderedlist>
 <listitem>
 <para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Display</guisubmenu><guimenuitem>Screensaver</guimenuitem></menuchoice>.</para>
@@ -118,6 +126,5 @@ deselect the <guilabel>Lock Screen After</guilabel> check box.</para>
 <para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Quit</guimenuitem></menuchoice> to close the <guilabel>Screensaver Preferences</guilabel> dialog.</para>
 </listitem>
 </orderedlist>
-</sect2>
 </sect1>
 </chapter>
diff --git a/gnome2-accessibility-guide/C/dtconfig.xml b/gnome2-accessibility-guide/C/dtconfig.xml
index 6fd17ac..ea67544 100644
--- a/gnome2-accessibility-guide/C/dtconfig.xml
+++ b/gnome2-accessibility-guide/C/dtconfig.xml
@@ -193,6 +193,10 @@ information.</para>
 <para>Use the <application>Keyboard Accessibility</application> preference
 tool, also known as <application>AccessX</application>, to configure the keyboard
 accessibility options. To start <application>AccessX</application>, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+<note>
+<para>Before you can use the <application>Keyboard Accessibility</application>
+preference tool on Solaris systems, you must follow the steps outlined in <xref linkend="sysadmin-55"/> of this guide.</para>
+</note>
 <para>The <guilabel>Keyboard Accessibility Preferences (AccessX)</guilabel>
 dialog enables you to customize your keyboard in the following ways:</para>
 <itemizedlist>
@@ -219,73 +223,6 @@ a toggle key. See <xref linkend="dtconfig-18"/>.</para>
 repeat rate of a keypress. See <xref linkend="dtconfig-19"/>.</para>
 </listitem>
 </itemizedlist>
-<sect2 id="dtconfig-12">
-<title>Before You Can Use AccessX on Solaris Systems</title>
-<indexterm>
-<primary>XKB</primary>
-</indexterm>
-<para>If you are using the desktop
-for the Solaris 8 or Solaris 9 operating system, you must enable XKB on your
-system before you can use the <application>AccessX</application> preference
-tool. </para>
-<note>
-<para>XKB is not currently supported on Sun Ray systems.</para>
-</note>
-<para>To enable XKB on a non-Sun Ray Solaris system, perform the following
-steps:</para>
-<orderedlist>
-<listitem>
-<para>Log in as root.</para>
-</listitem>
-<listitem>
-<para>Check if the path and file <filename>/etc/dt/config/Xservers</filename> exists on your system.</para>
-</listitem>
-<listitem>
-<para>If the <filename>/etc/dt/config</filename> directory does
-not exist, enter the following command:</para>
-<screen>
-<command>mkdir -p /etc/dt/config</command>
-</screen>
-</listitem>
-<listitem>
-<para>If the <filename>Xservers</filename> file is not present,
-enter the following command:</para>
-<screen>
-<command>cp /usr/dt/config/Xservers /etc/dt/config/Xservers</command>
-</screen>
-</listitem>
-<listitem>
-<para>Open the <filename>Xservers</filename> file in a text editor
-and scroll to the end of the file. </para>
-</listitem>
-<listitem>
-<para>Append the following to the command line at the end of the
-file:</para>
-<screen>
-<userinput>+kb</userinput>
-</screen>
-</listitem>
-<listitem>
-<para>Save and close the file.</para>
-</listitem>
-<listitem>
-<para>Enter the following command at a command line:</para>
-<screen>
-<command>pkill -HUP dtlogin</command>
-</screen>
-</listitem>
-<listitem>
-<para>Log out of your session and log in again.</para>
-</listitem>
-<listitem>
-<para>To verify if XKB is running, execute the following command: </para>
-<para>
-<command>xdpyinfo</command>
-</para>
-<para>then search for XKEYBOARD in the extensions list.</para>
-</listitem>
-</orderedlist>
-</sect2>
 <sect2 id="dtconfig-13">
 <title>To Activate the Keyboard Accessibility Options</title>
 <indexterm>
@@ -294,6 +231,9 @@ file:</para>
 <para>To activate the keyboard accessibility options, perform the following steps: </para>
 <orderedlist>
 <listitem>
+<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+</listitem>
+<listitem>
 <para>Select the <guilabel>Enable keyboard accessibility features</guilabel> option.</para>
 </listitem>
 <listitem>
@@ -324,8 +264,8 @@ the keyboard accessibility options. </para>
 different users, some of whom require the keyboard accessibility options. </para>
 </listitem>
 <listitem>
-<para>If you are a Linux user, you must log out and log in again
-before the accessibility settings take effect.</para>
+<para>If you are a Linux user, log out and log in again before the
+accessibility settings take effect.</para>
 </listitem>
 </orderedlist>
 </sect2>
@@ -341,6 +281,9 @@ device. To enable and configure the mouse keys feature, perform the following
 steps:</para>
 <orderedlist>
 <listitem>
+<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+</listitem>
+<listitem>
 <para>Click on the <guilabel>Mouse Keys</guilabel> tab.</para>
 </listitem>
 <listitem>
@@ -384,7 +327,7 @@ move. </para>
 <para>When you enable mouse keys, the keys on the numeric keypad have the
 following functions:</para>
 <table frame="topbot" id="dtconfig-TBL-1">
-<title>Numeric Keypad to Mouse Functions Mapping on Solaris Systems</title>
+<title>Numeric Keypad to Mouse Function Mapping on Solaris Systems</title>
 <tgroup cols="2" colsep="0" rowsep="0">
 <colspec colname="colspec0" colwidth="52.78*"/>
 <colspec colname="colspec1" colwidth="47.22*"/>
@@ -449,7 +392,7 @@ following functions:</para>
 </row>
 <row>
 <entry colname="colspec0" valign="top">
-<para>-</para>
+<para>&minus;</para>
 </entry>
 <entry colname="colspec1" valign="top">
 <para>Mouse button 3</para>
@@ -459,7 +402,7 @@ following functions:</para>
 </tgroup>
 </table>
 <table frame="topbot" id="dtconfig-TBL-4">
-<title>Numeric Keypad to Mouse Functions Mapping on Linux Systems</title>
+<title>Numeric Keypad to Mouse Function Mapping on Linux Systems</title>
 <tgroup cols="2" colsep="0" rowsep="0">
 <colspec colname="colspec0" colwidth="50*"/>
 <colspec colname="colspec1" colwidth="50*"/>
@@ -514,7 +457,7 @@ mouse pointer around the screen</para>
 buttons. The common function key to mouse button mappings are described in
 the following table.</para>
 <table frame="topbot" id="dtconfig-TBL-2">
-<title>Function Keys to Mouse Functions Mapping on Solaris Systems</title>
+<title>Function Key to Mouse Function Mapping on Solaris Systems</title>
 <tgroup cols="2" colsep="0" rowsep="0">
 <colspec colname="colspec0" colwidth="52.78*"/>
 <colspec colname="colspec1" colwidth="47.22*"/>
@@ -580,18 +523,20 @@ This aspect of the feature benefits users who cannot see the result of a keypres
 steps:</para>
 <orderedlist>
 <listitem>
+<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+</listitem>
+<listitem>
 <para>Click on the <guilabel>Filters</guilabel> tab.</para>
 </listitem>
 <listitem>
 <para>Select the <guilabel>Enable Slow Keys</guilabel> option. </para>
 <tip>
-<para>To select or deselect this feature from the keyboard, press-and-hold <keycap>Shift</keycap> for eight seconds. This keyboard shortcut automatically selects
-all of the slow keys options. If you selected the <guilabel>Beep when features
-turned on or off from the keyboard</guilabel> option, after four seconds the
-system beeps three times to indicate that the system is about to select or
-deselect the feature. If you enable this feature from the keyboard, you must
-press-and-hold <keycap>Shift</keycap> for eight seconds again to disable the
-feature.</para>
+<para>To select or deselect the slow keys feature from the keyboard,
+press-and-hold <keycap>Shift</keycap> for eight seconds. The <keycap>Shift</keycap> keyboard shortcut automatically selects all of the slow keys options.
+If you selected the <guilabel>Beep when features turned on or off from the
+keyboard</guilabel> option, after four seconds the system beeps three times
+to indicate that the system is about to select or deselect the feature. If
+you enable this feature from the keyboard, you must press-and-hold <keycap>Shift</keycap> for eight seconds again to disable the feature.</para>
 </tip>
 </listitem>
 <listitem>
@@ -651,6 +596,9 @@ enables you to customize the keyboard to ignore repeated keypresses. </para>
 steps:</para>
 <orderedlist>
 <listitem>
+<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+</listitem>
+<listitem>
 <para>Click on the <guilabel>Filters</guilabel> tab.</para>
 </listitem>
 <listitem>
@@ -658,10 +606,11 @@ steps:</para>
 </listitem>
 <listitem>
 <para>Use the <guilabel>Ignore duplicate keypresses within</guilabel>
-slider or spin box to specify the duration in milliseconds after the first
-keypress for which the system ignores repeated keypresses of the same key.
-For example, if you select a duration of 500 ms, the system ignores all repeated
-keypresses of the same key that occur within 500 ms of the first keypress.</para>
+slider or spin box to specify the duration in milliseconds (ms) after the
+first keypress for which the system ignores repeated keypresses of the same
+key. For example, if you select a duration of 500 ms, the system ignores all
+repeated keypresses of the same key that occur within 500 ms of the first
+keypress.</para>
 </listitem>
 <listitem>
 <para>Select the <guilabel>Beep if key is rejected</guilabel> option
@@ -669,13 +618,11 @@ to hear an audible indication when the system ignores a key.</para>
 </listitem>
 </orderedlist>
 <note>
-<para>If you wish to enable the bounce keys feature, please ensure that
-the <guilabel>Enable Slow Keys</guilabel> option is deselected. The slow keys
-feature requires you to press a key for a specified duration before the system
-accepts the keypress as a valid keypress. If you cannot press the key for
-the duration that is specified by the slow keys setting, the system does not
-accept your input unless you deselect the <guilabel>Enable Slow Keys</guilabel>
-option.</para>
+<para>If you want to enable the bounce keys feature, ensure that the <guilabel>Enable Slow Keys</guilabel> option is deselected. The slow keys feature requires
+you to press a key for a specified duration before the system accepts the
+keypress as a valid keypress. If you cannot press the key for the duration
+that is specified by the slow keys setting, deselect the <guilabel>Enable
+Slow Keys</guilabel> option to enable the system to accept your input.</para>
 </note>
 </sect2>
 <sect2 id="dtconfig-17">
@@ -691,17 +638,20 @@ press two or more keys simultaneously. </para>
 steps:</para>
 <orderedlist>
 <listitem>
+<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+</listitem>
+<listitem>
 <para>Click on the <guilabel>Basic</guilabel> tab.</para>
 </listitem>
 <listitem>
 <para>Select the <guilabel>Enable Sticky Keys</guilabel> option.</para>
 <tip>
-<para>To enable the sticky keys feature from the keyboard, press <keycap>Shift</keycap> five times. This keyboard shortcut automatically selects all
-of the sticky keys options. If you selected the <guilabel>Beep when features
-turned on or off from the keyboard</guilabel> option, the system beeps to
-indicate that the system is about to select or deselect the feature. If you
-enable this feature from the keyboard, press <keycap>Shift</keycap> five times
-again to disable the feature.</para>
+<para>To enable the sticky keys feature from the keyboard, press <keycap>Shift</keycap> five times. The <keycap>Shift</keycap> keyboard shortcut automatically
+selects all of the sticky keys options. If you selected the <guilabel>Beep
+when features turned on or off from the keyboard</guilabel> option, the system
+beeps to indicate that the system is about to select or deselect the feature.
+If you enable this feature from the keyboard, press <keycap>Shift</keycap>
+five times again to disable the feature.</para>
 </tip>
 </listitem>
 <listitem>
@@ -711,9 +661,9 @@ such as <keycap>Ctrl</keycap>, <keycap>Alt</keycap>, or <keycap>Shift</keycap>.
 This option is useful to remind you whether a modifier key is active or inactive. </para>
 </listitem>
 <listitem>
-<para>To automatically disable the sticky keys feature when a user
-presses two keys simultaneously, select the <guilabel>Disable if two keys
-pressed together</guilabel> option.</para>
+<para>To automatically disable the sticky keys feature when you
+press two keys simultaneously, select the <guilabel>Disable if two keys pressed
+together</guilabel> option.</para>
 </listitem>
 </orderedlist>
 <para>You can use the sticky keys feature in latch or lock mode. The following
@@ -733,7 +683,7 @@ table describes how to choose a mode and the difference between the two modes.</
 <para>Press the modifier key...</para>
 </entry>
 <entry colname="colspec2" valign="top">
-<para>The modifier key stays active
+<para>The modifier key remains active
 until...</para>
 </entry>
 </row>
@@ -765,7 +715,8 @@ a non-modifier key.</para>
 </tbody>
 </tgroup>
 </table>
-<para>For example, if you want to press <keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo>, do the following:</para>
+<para>Example 1: If you want to press <keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo>,
+do the following:</para>
 <orderedlist>
 <listitem>
 <para>Press <keycap>Alt</keycap> to latch the modifier key. The <keycap>Alt</keycap> key remains active.</para>
@@ -776,7 +727,7 @@ After you press <keycap>F1</keycap>, the <keycap>Alt</keycap> modifier key
 is no longer active.</para>
 </listitem>
 </orderedlist>
-<para>As another example, if you want to press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Tab</keycap></keycombo>, do the following:</para>
+<para>Example 2: If you want to press <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Tab</keycap></keycombo>, do the following:</para>
 <orderedlist>
 <listitem>
 <para>Press <keycap>Ctrl</keycap> twice to lock the modifier key.
@@ -806,10 +757,21 @@ toggle keys have an associated light emitting diode (LED) on the keyboard
 that lights when the toggle key is active. To assist users with visual impairments,
 you can customize the keyboard to emit an audible notification when a user
 presses a toggle key. For example, when you press <keycap>Num Lock</keycap>,
-you can determine whether the key is toggled or not toggled by the sound. </para>
-<para>To enable accessible toggle keys, select the <guilabel>Enable Toggle
-Keys</guilabel> option in the <guilabel>Filters</guilabel> tabbed section.
-When you activate the <keycap>Num Lock</keycap>, <keycap>Caps Lock</keycap>,
+you can determine whether the key is toggled or not toggled by the sound that
+the keyboard emits. </para>
+<para>To enable accessible toggle keys, perform the following steps: </para>
+<orderedlist>
+<listitem>
+<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+</listitem>
+<listitem>
+<para>Click on the <guilabel>Filters</guilabel> tab.</para>
+</listitem>
+<listitem>
+<para>Select the <guilabel>Enable Toggle Keys</guilabel> option.</para>
+</listitem>
+</orderedlist>
+<para>When you activate the <keycap>Num Lock</keycap>, <keycap>Caps Lock</keycap>,
 or <keycap>Scroll Lock</keycap> keys, the system beeps once. When you deactivate
 a toggle key, the system beeps twice.</para>
 </sect2>
@@ -828,6 +790,9 @@ the key starts to repeat.</para>
 steps: </para>
 <orderedlist>
 <listitem>
+<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+</listitem>
+<listitem>
 <para>Click on the <guilabel>Basic</guilabel> tab.</para>
 </listitem>
 <listitem>
@@ -852,8 +817,8 @@ the speed at which the keyboard repeats the keypress as input.</para>
 <primary>Keyboard Accessibility Status panel application</primary>
 </indexterm>
 <para>The <application>Keyboard Accessibility Status</application>
-panel application shows the status of the keyboard accessibility features.
-The panel application displays icons to indicate which keyboard accessibility
+panel application shows you the status of the keyboard accessibility features.
+This panel application displays icons to indicate which keyboard accessibility
 features are enabled in the <application>Keyboard Accessibility</application>
 preference tool.</para>
 <para>To add the <application>Keyboard Accessibility Status</application>
@@ -1088,7 +1053,9 @@ key is latched.</para>
 </screenshot>
 </entry>
 <entry colname="colspec1" valign="middle">
-<para>The sticky keys feature is enabled and the <keycap>Super</keycap>/<keycap>Windows</keycap> key is locked.</para>
+<para>The sticky
+keys feature is enabled and the <keycap>Super</keycap>/<keycap>Windows</keycap>
+key is locked.</para>
 </entry>
 </row>
 </tbody>
diff --git a/gnome2-accessibility-guide/C/gnome-access-guide-C.omf b/gnome2-accessibility-guide/C/gnome-access-guide-C.omf
index faa5956..c939aaa 100755
--- a/gnome2-accessibility-guide/C/gnome-access-guide-C.omf
+++ b/gnome2-accessibility-guide/C/gnome-access-guide-C.omf
@@ -9,16 +9,16 @@
     </maintainer>

 <!--
     <title>

-      GNOME 2.10 Desktop Accessibility Guide V2.10.0
+      GNOME 2.10 Desktop Accessibility Guide V2.10.1
     </title>
 -->
     <title>

       Accessibility Guide
     </title>

     <date>

-      2005-03-07
+      2005-07-29
     </date>

-    <version identifier="2.10.0" date="2005-03-07" description="Multiplatform accessibility guide"/>

+    <version identifier="2.10.1" date="2005-07-29" description="Multiplatform accessibility guide"/>

     <subject category="GNOME|Desktop"/>

     <description>

       Accessibility Guide for the GNOME 2.10 Desktop
diff --git a/gnome2-accessibility-guide/C/gnome-access-guide.xml b/gnome2-accessibility-guide/C/gnome-access-guide.xml
index 6b41b39..b8fc71b 100644
--- a/gnome2-accessibility-guide/C/gnome-access-guide.xml
+++ b/gnome2-accessibility-guide/C/gnome-access-guide.xml
@@ -2,8 +2,8 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
 "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
   <!ENTITY gnomeversion "2.10">

-  <!ENTITY manrevision "2.10.0">

-  <!ENTITY date "March 2005">

+  <!ENTITY manrevision "2.10.1">

+  <!ENTITY date "July 2005">

   <!ENTITY LEGAL SYSTEM "legal.xml">

   <!ENTITY dtconfig SYSTEM "dtconfig.xml">

   <!ENTITY keynav SYSTEM "keynav.xml">  

@@ -56,6 +56,14 @@
 		  </revdescription> 
 		</revision>
 	   <revision> 

+		  <revnumber>GNOME 2.10 Desktop Accessibility Guide V2.10.0</revnumber> 

+		  <date>March 2005</date> 

+		  <revdescription> 

+			 <para role="author">Sun Java Desktop System Documentation Team</para> 
+			 <para role="publisher">GNOME Documentation Project</para> 
+		  </revdescription> 
+		</revision>
+	   <revision> 

 		  <revnumber>GNOME 2.8 Desktop Accessibility Guide V2.8.0</revnumber> 

 		  <date>September 2004</date> 

 		  <revdescription> 

diff --git a/gnome2-accessibility-guide/C/keynav.xml b/gnome2-accessibility-guide/C/keynav.xml
index cd4fba4..a9f7b22 100644
--- a/gnome2-accessibility-guide/C/keynav.xml
+++ b/gnome2-accessibility-guide/C/keynav.xml
@@ -18,10 +18,13 @@ shortcuts. </para>
 <primary>keyboard shortcuts</primary>
 <secondary>essential</secondary>
 </indexterm>
-<para>The following table lists the essential keyboard shortcuts
-that you can use to navigate the desktop. The keyboard shortcuts that you
-use to navigate specific elements and controls are described in the appropriate
-sections of this chapter.</para>
+<indexterm>
+<primary>caret navigation mode</primary>
+</indexterm>
+<para>The following table lists the essential keyboard shortcuts that you
+can use to navigate the desktop. The keyboard shortcuts that you use to navigate
+specific elements and controls are described in the appropriate sections of
+this chapter.</para>
 <informaltable frame="topbot">
 <tgroup cols="2" colsep="0" rowsep="0">
 <colspec colname="colspec0" colwidth="43.94*"/>
@@ -62,12 +65,12 @@ direction.</para>
 <para><keycombo><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo></para>
 </entry>
 <entry colname="colspec1" valign="top">
-<para>If
-the <keycap>Tab</keycap> key has a specific purpose in a control, press <keycombo><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo> to give focus to the next element or
-control. For example, if you press <keycap>Tab</keycap> in a text box, the
-system inserts a tab space.</para>
-<para>To give focus to the previous element
-or control, press <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo>.</para>
+<para>Give
+focus to the next element or control, if the <keycap>Tab</keycap> key has
+a specific purpose in a control. For example, if you press <keycap>Tab</keycap>
+in a text box, the system inserts a tab space.</para>
+<para>To give focus to
+the previous element or control, press <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo>.</para>
 </entry>
 </row>
 <row>
@@ -101,6 +104,18 @@ is the equivalent of clicking on the button with a mouse.</para>
 <para>Close a window, menu, or drawer.</para>
 </entry>
 </row>
+<row>
+<entry colname="colspec0">
+<para>
+<keycap>F7</keycap>
+</para>
+</entry>
+<entry colname="colspec1">
+<para>Switch to caret navigation mode. Caret navigation
+mode enables you to use the keyboard to select text. For more information
+about caret navigation mode, see <xref linkend="keynav-52"/>.</para>
+</entry>
+</row>
 </tbody>
 </tgroup>
 </informaltable>
@@ -157,7 +172,6 @@ can use from any part of the GNOME Desktop. </para>
 and take a screenshot of the entire screen. </para>
 <para>You can customize
 this keyboard shortcut.</para>
-<para>This shortcut only works on Solaris systems.</para>
 </entry>
 </row>
 <row>
@@ -1664,23 +1678,18 @@ pane and the view pane.</para>
 </sect2>
 </sect1>
 <sect1 id="keynav-52">
-<title>Navigating Web Browser, Email and Calendar, and Help Content</title>
-<indexterm>
-<primary>keyboard shortcuts</primary>
-<secondary>for web browser
-content</secondary>
-</indexterm>
+<title>Navigating Help Content in Caret Navigation Mode</title>
 <indexterm>
 <primary>keyboard shortcuts</primary>
-<secondary>for email and calendar content</secondary>
+<secondary>for Help content</secondary>
 </indexterm>
 <indexterm>
-<primary>keyboard shortcuts</primary>
-<secondary>for help content</secondary>
+<primary>caret navigation mode</primary>
 </indexterm>
-<para>To navigate HTML-based content, you need to
-first press F7 to switch to caret navigation mode. The following table describes
-how navigate HTML-based content.</para>
+<para>The following table describes how to navigate HTML-based
+help content in caret navigation mode in the <application>Yelp</application>
+help browser. Caret navigation is a mode of operation in an application which
+enables you to use the keyboard to select text.</para>
 <informaltable frame="topbot">
 <tgroup cols="2" colsep="0" rowsep="0">
 <colspec colname="colspec0" colwidth="43.94*"/>
@@ -1703,7 +1712,7 @@ how navigate HTML-based content.</para>
 </para>
 </entry>
 <entry colname="colspec1">
-<para>Switch to caret navigation mode.</para>
+<para>Switch to caret navigation mode. </para>
 </entry>
 </row>
 <row>
@@ -1781,7 +1790,7 @@ how navigate HTML-based content.</para>
 </para>
 </entry>
 <entry colname="colspec1">
-<para>Move to the beginning of the current line.</para>
+<para>Move to the beginning of the current frame.</para>
 </entry>
 </row>
 <row>
@@ -1791,23 +1800,6 @@ how navigate HTML-based content.</para>
 </para>
 </entry>
 <entry colname="colspec1">
-<para>Move to the end of the current line.</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0">
-<para><keycombo><keycap>Ctrl</keycap><keycap>Home</keycap></keycombo></para>
-</entry>
-<entry colname="colspec1">
-<para>Move to the beginning
-of the current frame.</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0">
-<para><keycombo><keycap>Ctrl</keycap><keycap>End</keycap></keycombo></para>
-</entry>
-<entry colname="colspec1">
 <para>Move to the end of the current frame.</para>
 </entry>
 </row>
@@ -1843,26 +1835,6 @@ previous focusable control.</para>
 <row>
 <entry colname="colspec0">
 <para>
-<keycap>F6</keycap>
-</para>
-</entry>
-<entry colname="colspec1">
-<para>Move to the next frame in the current document if
-the document is using frames and to the location bar.</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0">
-<para><keycombo><keycap>Shift</keycap><keycap>F6</keycap></keycombo></para>
-</entry>
-<entry colname="colspec1">
-<para>Move to the previous frame in the current
-document if the document is using frames and to the location bar.</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0">
-<para>
 <keycap>Enter</keycap>
 </para>
 </entry>
@@ -1873,8 +1845,6 @@ document if the document is using frames and to the location bar.</para>
 </tbody>
 </tgroup>
 </informaltable>
-<para>For more information about how to navigate the <application>Web Browser</application> and <application>Email and Calendar</application> applications,
-see the online Help for the applications. </para>
 </sect1>
 <sect1 id="keynav-23">
 <title>Navigating Standard Elements and Controls</title>
diff --git a/gnome2-accessibility-guide/C/preface.xml b/gnome2-accessibility-guide/C/preface.xml
index d06325c..b395286 100644
--- a/gnome2-accessibility-guide/C/preface.xml
+++ b/gnome2-accessibility-guide/C/preface.xml
@@ -1,61 +1,16 @@
 
-<preface id="preface-0">
-<title>Preface</title>
-<para>The <citetitle>GNOME 2.10 Desktop Accessibility
-Guide</citetitle> describes
-how to configure, customize, and use the accessibility features of
-the GNOME 2.10 Desktop.</para>
-<sect1 id="preface-1">
-<title>Who Should Read This Guide</title>
-<para>This guide is for users, system administrators, and anyone who is interested
-in how the GNOME 2.10 Desktop satisfies Section 508 of the U.S. Rehabilitation Act.</para>
-</sect1>
-<sect1 id="preface-2">
-<title>How This Guide Is Organized</title>
-<para>This guide is structured in the following manner:</para>
-<itemizedlist>
-<listitem>
-<para><xref linkend="accessintro-1"/> introduces you to accessibility
-in the GNOME Desktop.</para>
-</listitem>
-<listitem>
-<para><xref linkend="dtconfig-0"/> describes how to configure the
-mouse and keyboard to make these devices accessible to more users.</para>
-</listitem>
-<listitem>
-<para><xref linkend="keynav-0"/> describes how to navigate the GNOME
-Desktop from the keyboard only.</para>
-</listitem>
-<listitem>
-<para><xref linkend="themes-0"/> describes the methods you can use
+<preface id="preface-0"><title>Preface</title><para>The <citetitle>GNOME 2.10 Desktop Accessibility
+Guide</citetitle> describes how to configure, customize,
+and use the accessibility features of the GNOME 2.10
+Desktop.</para>
+<sect1 id="preface-1"><title>Who Should Read This Guide</title><para>This guide is for users, system administrators, and anyone who is interested
+in how the GNOME 2.10 Desktop supports people with disabilities and addresses the requirements
+of Section 508 of the U.S. Rehabilitation Act.</para></sect1><sect1 id="preface-2"><title>How This Guide Is Organized</title><para>This guide is structured in the following manner:</para><itemizedlist><listitem><para><xref linkend="accessintro-1"/> introduces you to accessibility
+in the GNOME Desktop.</para></listitem><listitem><para><xref linkend="dtconfig-0"/> describes how to configure the
+mouse and keyboard to make these devices accessible to more users.</para></listitem><listitem><para><xref linkend="keynav-0"/> describes how to navigate the GNOME
+Desktop from the keyboard.</para></listitem><listitem><para><xref linkend="themes-0"/> describes the methods you can use
 to change the appearance of the GNOME Desktop to enhance the accessibility of the desktop for users with
-visual impairments.</para>
-</listitem>
-<listitem>
-<para><xref linkend="ats-0"/> introduces you to the assistive technologies
-that are available in the GNOME Desktop.</para>
-</listitem>
-<listitem>
-<para><xref linkend="sysadmin-0"/> describes some system administrator
+visual impairments.</para></listitem><listitem><para><xref linkend="ats-0"/> introduces you to the assistive technologies
+that are available from the GNOME Desktop.</para></listitem><listitem><para><xref linkend="sysadmin-0"/> describes the system administrator
 tasks that you need to perform before you can use the assistive technologies
-for the GNOME Desktop.</para>
-</listitem>
-</itemizedlist>
-</sect1>
-<sect1 id="preface-3">
-<title>Related Documentation</title>
-<para>The following manuals are related to this guide:</para>
-<itemizedlist>
-<listitem>
-<para>
-<citetitle>GNOME 2.10 Desktop System Administration Guide</citetitle>
-</para>
-</listitem>
-<listitem>
-<para>
-<citetitle>GNOME 2.10 Desktop User Guide</citetitle>
-</para>
-</listitem>
-</itemizedlist>
-</sect1>
-</preface>
+for the GNOME Desktop.</para></listitem></itemizedlist></sect1><sect1 id="preface-3"><title>Related Documentation</title><para>The following manuals are related to this guide:</para><itemizedlist><listitem><para><citetitle>GNOME 2.10 Desktop System Administration Guide</citetitle></para></listitem><listitem><para><citetitle>GNOME 2.10 Desktop User Guide</citetitle></para></listitem></itemizedlist></sect1></preface>
diff --git a/gnome2-accessibility-guide/C/sysadmin.xml b/gnome2-accessibility-guide/C/sysadmin.xml
index c6a507f..23eab2b 100644
--- a/gnome2-accessibility-guide/C/sysadmin.xml
+++ b/gnome2-accessibility-guide/C/sysadmin.xml
@@ -1,8 +1,10 @@
 
 <appendix id="sysadmin-0">
 <title>System Administration</title>
-<para>This appendix contains some tips for the system administrator about
-how to use the assistive technologies of the GNOME Desktop.</para>
+<para>This appendix
+describes some tasks that a system administrator needs to perform to enable
+accessible login and to facilitate the use of the assistive technologies that
+are available in the GNOME Desktop.</para>
 <sect1 id="sysadmin-27">
 <title>Configuring the Desktop for Accessible Login</title>
 <indexterm>
@@ -16,9 +18,11 @@ Login feature. The Accessible Login feature enables users to: </para>
 screen, mouse, or keyboard in the usual way.</para>
 </listitem>
 <listitem>
-<para>Launch assistive technologies at login time by using special
-gestures from the standard keyboard, or from a keyboard, pointing device,
-or switch device that is attached to the USB or PS/2 mouse port.</para>
+<para>Launch assistive technologies at login time by associating
+a user action with an assistive technology application. The user can perform
+the user action from the standard keyboard, or from a keyboard, pointing device,
+or switch device that is attached to the USB or PS/2 mouse port. These user
+actions are called gestures.</para>
 </listitem>
 <listitem>
 <para>Change the visual appearance of the login dialog before the
@@ -31,12 +35,11 @@ user logs in, for example, to use a high contrast theme for better visibility. <
 <primary>GDM</primary>
 </indexterm>
 <para>To enable the Accessible
-Login feature for the GNOME Desktop,
-you must configure the desktop to use the GNOME Display Manager (GDM) as the
-login manager. Since GDM is the default login manager on Linux systems but
-not on Solaris systems, the instructions to enable Accessible Login differ
-depending on the platform you are using. See the following sections for more
-information.</para>
+Login feature for the GNOME
+Desktop, you must configure the desktop to use the GNOME Display Manager
+(GDM) as the login manager. GDM is the default login manager on Linux systems
+but not on Solaris systems, therefore the instructions to enable Accessible
+Login differ depending on the platform you are using. </para>
 <sect3 id="sysadmin-38">
 <title>To Enable and Configure GDM on Solaris Systems</title>
 <para>To enable and configure GDM as the login manager on Solaris systems,
@@ -46,7 +49,7 @@ perform the following steps:</para>
 <para>Log in as the <literal>root</literal> user.</para>
 </listitem>
 <listitem>
-<para>Edit the file <filename>/etc/X11/gdm/gdm.conf</filename>.</para>
+<para>Open the file <filename>/etc/X11/gdm/gdm.conf</filename>.</para>
 </listitem>
 <listitem>
 <para>Search the file for the following line: </para>
@@ -79,11 +82,11 @@ Reader and Magnifier</application>. You can edit the line above further to
 load only the GtkModules that you require to support the user base. For example: </para>
 <itemizedlist>
 <listitem>
-<para>If you need to use the Screen Reader and Magnifier, include <literal>gail</literal> and <literal>atk-bridge</literal>.</para>
+<para>If you need to use the <application>Screen Reader and Magnifier</application>, include <literal>gail</literal> and <literal>atk-bridge</literal>.</para>
 </listitem>
 <listitem>
 <para>If you need to use a pointing device without buttons or switches,
-also include <literal>dwellmouselistener</literal>. </para>
+include <literal>gail</literal>, <literal>atk-bridge</literal>, and<literal>dwellmouselistener</literal>. </para>
 </listitem>
 <listitem>
 <para>If you use pointing devices with switches, alternative physical
@@ -147,7 +150,7 @@ and assign ownership of the directory to the <literal>gdm</literal> user.</para>
 <para>Log in as the <literal>root</literal> user.</para>
 </listitem>
 <listitem>
-<para>Edit the file <filename>/etc/X11/gdm/gdm.conf</filename>.</para>
+<para>Open the file <filename>/etc/X11/gdm/gdm.conf</filename>.</para>
 </listitem>
 <listitem>
 <para>Search the file for the following line: </para>
@@ -184,7 +187,7 @@ load only the GtkModules that you require to support the user base. For example:
 </listitem>
 <listitem>
 <para>If you need to use a pointing device without buttons or switches,
-also include <literal>dwellmouselistener</literal>. </para>
+include <literal>gail</literal>, <literal>atk-bridge</literal>, and <literal>dwellmouselistener</literal>. </para>
 </listitem>
 <listitem>
 <para>If you use pointing devices with switches, alternative physical
@@ -262,9 +265,19 @@ line enables you to press-and-hold <keycombo><keycap>Ctrl</keycap><keycap>S</key
 for one second to start <application>Screen Reader and Magnifier</application>
 in speech and Braille mode:</para>
 <para>
+<emphasis>Solaris:</emphasis>
+</para>
+<para>
 <literal>&lt;Control&gt;s 1 1000 10000 /usr/sfw/bin/srcore --login --disable-magnifier
 --enable-speech --enable-braille</literal>
 </para>
+<para>
+<emphasis>Linux:</emphasis>
+</para>
+<para>
+<literal>&lt;Control&gt;s 1 1000 10000 srcore --login --disable-magnifier
+--enable-speech --enable-braille</literal>
+</para>
 </sect3>
 <sect3 id="sysadmin-41">
 <title>To Start Magnifier Using a Keyboard Shortcut</title>
@@ -274,8 +287,18 @@ line enables you to press-and-hold <keycombo><keycap>Ctrl</keycap><keycap>M</key
 for one second to start <application>Screen Reader and Magnifier</application>
 in magnifier mode:</para>
 <para>
+<emphasis>Solaris:</emphasis>
+</para>
+<para>
 <literal>&lt;Control&gt;m 1 1000 10000 /usr/sfw/bin/srcore --login --enable-magnifier
---magnification-horizontal-split --disable-speech</literal>
+--disable-speech</literal>
+</para>
+<para>
+<emphasis>Linux:</emphasis>
+</para>
+<para>
+<literal>&lt;Control&gt;m 1 1000 10000 srcore --login --enable-magnifier
+--disable-speech</literal>
 </para>
 </sect3>
 <sect3 id="sysadmin-31">
@@ -284,23 +307,43 @@ in magnifier mode:</para>
 switch, key, or button gestures with assistive technologies. Since the primary
 input device for many <application>On-Screen Keyboard</application> users
 is a switch or button, this is a good way to enable users to start <application>On-Screen Keyboard</application> at login time. </para>
-<para>To reduce the likelihood of starting an application unintentionally,
+<para>If there is a tendency for a user to start an application unintentionally,
 you can associate the gestures with multiple switch presses or minimum durations.
 For example, the following line starts <application>On-Screen Keyboard</application>
 in inverse scanning mode when the user presses the switch that is defined
 as Switch 2 three times within two seconds, for a minimum of 100 milliseconds
 for each press:</para>
 <para>
+<emphasis>Solaris:</emphasis>
+</para>
+<para>
 <literal>&lt;Switch2&gt;3 100 2000 /usr/sfw/bin/gok --login --accessmethod=inversescanning
 --scan-action=switch1 --select-action=switch2</literal>
 </para>
+<para>
+<emphasis>Linux:</emphasis>
+</para>
+<para>
+<literal>&lt;Switch2&gt;3 100 2000 gok --login --accessmethod=inversescanning
+--scan-action=switch1 --select-action=switch2</literal>
+</para>
 <para>Users who use single switches may prefer to start <application>On-Screen
 Keyboard</application> in automatic scanning mode. The following line starts <application>On-Screen Keyboard</application> in automatic scanning mode when the user
 presses the switch on an alternative access device for more than four seconds:</para>
 <para>
+<emphasis>Solaris:</emphasis>
+</para>
+<para>
 <literal>&lt;Switch&gt;1 4000 5000 /usr/sfw/bin/gok --login --accessmethod=automaticscanning
 --scan-action=switch1 --select-action=switch1</literal>
 </para>
+<para>
+<emphasis>Linux:</emphasis>
+</para>
+<para>
+<literal>&lt;Switch&gt;1 4000 5000 gok --login --accessmethod=automaticscanning
+--scan-action=switch1 --select-action=switch1</literal>
+</para>
 <para>For information about the <application>On-Screen Keyboard</application>
 operating modes, see the online Help for <application>On-Screen Keyboard</application>.</para>
 </sect3>
@@ -320,11 +363,22 @@ the top edge, out of the dialog through the left edge, back into the dialog
 through the left edge, and similarly through the bottom and right edges of
 the dialog in a cross pattern:</para>
 <para>
+<emphasis>Solaris:</emphasis>
+</para>
+<para>
 <literal>TTLLBBRR O 10000 /usr/sfw/bin/gok --login --access-method=dwellselection
 --input-device=MOUSE[3]</literal>
 </para>
+<para>
+<emphasis>Linux:</emphasis>
+</para>
+<para>
+<literal>TTLLBBRR O 10000 gok --login --access-method=dwellselection
+--input-device=MOUSE[3]</literal>
+</para>
 <para>Note that the <literal>--input-device</literal> parameter specified
-in the gesture must match the name of the user input device as specified in <filename>/etc/X11/XF86Config</filename>.</para>
+in the gesture must match the name of the extended user input device, such
+as a head pointer or trackball, as specified in <filename>/etc/X11/XF86Config</filename>.</para>
 </sect3>
 </sect2>
 <sect2 id="sysadmin-33">
@@ -339,7 +393,10 @@ including USB single switches and mouse-like pointing devices.</para>
 <para>You should not configure an alternative input device to control
 the primary onscreen pointer. This might result in undesirable behavior or
 cause situations from which the user of the alternate input device cannot
-recover without using the primary keyboard or mouse.</para>
+recover without using the primary keyboard or mouse. To prevent this problem,
+please remove any occurrences of the attributes <literal>SendCore</literal>
+or <literal>AlwaysCore</literal> from any of <literal>InputDevice</literal>
+lines in the X Server configuration file.</para>
 </note>
 </sect2>
 </sect1>
@@ -348,15 +405,15 @@ recover without using the primary keyboard or mouse.</para>
 <indexterm>
 <primary>Java environment, configuring</primary>
 </indexterm>
-<para>To configure the Java Environment for accessibility, perform the following
-steps:</para>
+<para>To configure the Java environment on Solaris systems for accessibility, perform
+the following steps:</para>
 <orderedlist>
 <listitem>
 <para>Log in as the <literal>root</literal> user to the base directory
 of the Java SDK installation. </para>
 </listitem>
 <listitem>
-<para>Enter the following command to change to the <filename>jre/lib</filename> directory:</para>
+<para>Enter the following command:</para>
 <para>
 <command>cd jre/lib</command>
 </para>
@@ -368,31 +425,117 @@ of the Java SDK installation. </para>
 </para>
 </listitem>
 <listitem>
-<para>Enter the following command to change to the <filename>ext</filename> directory:</para>
+<para>Enter the following command:</para>
 <para>
 <command>cd ext</command>
 </para>
 </listitem>
 <listitem>
-<para>Execute the following command: </para>
+<para>Enter the following command: </para>
 <para>
 <command>ln -s /usr/share/jar/gnome-java-bridge.jar</command>
 </para>
 </listitem>
 </orderedlist>
 </sect1>
+<sect1 id="sysadmin-55">
+<title>Enabling XKB on Solaris Systems</title>
+<indexterm>
+<primary>XKB</primary>
+</indexterm>
+<para>If you are using the desktop
+for the Solaris operating system on a SPARC platform, you must enable XKB
+on your system before you can use the <application>AccessX</application> preference
+tool, <application>Screen Reader and Magnifier</application>, or <application>On-Screen Keyboard</application>. </para>
+<note>
+<para>XKB is not currently supported on Sun Ray systems.</para>
+</note>
+<para>To enable XKB on a non-Sun Ray Solaris system, perform the following
+steps:</para>
+<orderedlist>
+<listitem>
+<para>Log in as the <literal>root</literal> user.</para>
+</listitem>
+<listitem>
+<para>Check if the path and file <filename>/etc/dt/config/Xservers</filename> exists on your system.</para>
+</listitem>
+<listitem>
+<para>If the <filename>/etc/dt/config</filename> directory does
+not exist, enter the following command:</para>
+<screen>
+<command>mkdir -p /etc/dt/config</command>
+</screen>
+</listitem>
+<listitem>
+<para>If the <filename>Xservers</filename> file is not present,
+enter the following command:</para>
+<screen>
+<command>cp /usr/dt/config/Xservers /etc/dt/config/Xservers</command>
+</screen>
+</listitem>
+<listitem>
+<para>Open the <filename>Xservers</filename> file in a text editor
+and scroll to the end of the file. </para>
+</listitem>
+<listitem>
+<para>Append the following to the command line at the end of the
+file:</para>
+<screen>
+<userinput>+kb</userinput>
+</screen>
+</listitem>
+<listitem>
+<para>Save and close the <filename>Xservers</filename> file.</para>
+</listitem>
+<listitem>
+<para>Enter the following command at a command line:</para>
+<screen>
+<command>pkill -HUP dtlogin</command>
+</screen>
+</listitem>
+<listitem>
+<para>Open the <filename>/etc/X11/gdm/gdm.conf</filename> file in
+a text editor.</para>
+</listitem>
+<listitem>
+<para>Scroll towards the end of the file until you see the line <literal>[server - standard]</literal>.</para>
+</listitem>
+<listitem>
+<para>Edit the <literal>command</literal> line in this section to
+append the following to the end of the line:</para>
+<para>
+<command>+accessx +kb</command>
+</para>
+</listitem>
+<listitem>
+<para>Save and close the <filename>gdm.conf</filename> file.</para>
+</listitem>
+<listitem>
+<para>Log out of your session and log in again.</para>
+</listitem>
+<listitem>
+<para>To verify if XKB is running, execute the following command: </para>
+<para>
+<command>xdpyinfo</command>
+</para>
+<para>then search for XKEYBOARD in the extensions list.</para>
+</listitem>
+</orderedlist>
+</sect1>
 <sect1 id="sysadmin-6">
 <title>Enabling Full Screen Magnification</title>
-<para>The following sections describe two ways to enable full screen magnification.</para>
 <indexterm>
 <primary>Screen Reader and Magnifier</primary>
 <secondary>enabling
 full screen magnification</secondary>
 </indexterm>
+<para>The following sections
+describe the methods to enable full screen magnification.</para>
 <sect2 id="sysadmin-48">
-<title>To Enable Full Screen Magnification Using Two Framebuffers</title>
+<title>To Enable Full Screen Magnification Using Two Video Cards</title>
 <para>To enable full screen magnification in <application>Screen Reader and
-Magnifier</application> using two framebuffers, perform the following steps:</para>
+Magnifier</application> using two physical video cards, perform the following
+steps:</para>
 <orderedlist>
 <listitem>
 <para>Configure two video cards as :0.0 and :0.1.</para>
@@ -404,40 +547,41 @@ magnification factor.</para>
 </note>
 </listitem>
 <listitem>
-<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Screen Reader and Magnifier</guimenuitem></menuchoice> to start <application>Gnopernicus</application>.</para>
+<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Screen Reader and Magnifier</guimenuitem></menuchoice>.</para>
 </listitem>
 <listitem>
-<para>Click on <guibutton>Preferences</guibutton>.</para>
+<para>Click on <guilabel>Preferences</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.</para>
 </listitem>
 <listitem>
-<para>Click on <guibutton>Magnifier</guibutton>.</para>
+<para>Click on <guilabel>Magnifier</guilabel> to open the <guilabel>Magnifier Preferences</guilabel> dialog.</para>
 </listitem>
 <listitem>
-<para>Click on <guibutton>Add/Modify</guibutton>.</para>
+<para>Click on the <guibutton>Add/Modify</guibutton> button to display
+the <guilabel>Zoomer Options</guilabel> dialog.</para>
 </listitem>
 <listitem>
-<para>Specify :0.0 as the Source for magnification.</para>
+<para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.0</userinput> in the <guilabel>Source</guilabel> text box. </para>
 </listitem>
 <listitem>
-<para>Specify :0.1 as the Target for magnification.</para>
+<para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.1</userinput> in the <guilabel>Target</guilabel> text box. </para>
 </listitem>
 <listitem>
-<para>Set the Zoomer Placement to be <literal>[0,0,1023,767]</literal>.</para>
+<para>Set the Zoomer Placement values to be <literal>[0,0,1023,767]</literal>.</para>
 <note>
 <para>These instructions assume a video resolution of 1024x768. </para>
 </note>
 </listitem>
 <listitem>
-<para>Restart <application>Screen Reader and Magnifier</application>.
-The magnified view is displayed on the second display 0.1.</para>
+<para>Click <guibutton>Apply</guibutton> and <guibutton>Close</guibutton>
+to close the <guilabel>Zoomer Options</guilabel> dialog. </para>
+<para>The magnified view is displayed on the second display 0.1.</para>
 </listitem>
 </orderedlist>
 </sect2>
 <sect2 id="sysadmin-49">
-<title>To Enable Full Screen Magnification on Linux Systems Using a Dummy
-Driver</title>
-<para>To enable full screen magnification on Linux systems by configuring
-a dummy driver, perform the following steps:</para>
+<title>To Enable Full Screen Magnification Using One Video Card on Linux Systems</title>
+<para>To enable full screen magnification on Linux systems using one physical
+video card and one virtual video card, perform the following steps:</para>
 <orderedlist>
 <listitem>
 <para>Open the file <filename>/etc/X11/XF86Config</filename>.</para>
@@ -518,50 +662,125 @@ the <guilabel>Zoomer Options</guilabel> dialog.</para>
 <para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.1</userinput> in the <guilabel>Source</guilabel> text box. </para>
 </listitem>
 <listitem>
+<para>In the <guilabel>Zoomer Placement</guilabel> section, set
+the value of the <guilabel>Left</guilabel> spin box to <userinput>0</userinput>.</para>
+</listitem>
+<listitem>
 <para>Click <guibutton>Apply</guibutton>.</para>
+<para>The <application>Screen Reader and Magnifier</application> user interface
+is no longer visible.</para>
 </listitem>
 <listitem>
-<para>In the <guilabel>Zoomer Placement</guilabel> section, set
-the value of the <guilabel>Left</guilabel> spin box to <userinput>0</userinput>.</para>
+<para>Log out of your session.</para>
+</listitem>
+<listitem>
+<para>Log in to a new session.</para>
+</listitem>
+<listitem>
+<para>Enter the following command to start <application>Screen Reader
+and Magnifier</application> in full screen magnification mode:</para>
+<para>
+<command>gnopernicus -display :0.1</command>
+</para>
+</listitem>
+<listitem>
+<para>When you log out of your session, select the <guilabel>Save
+current setup</guilabel> option. </para>
+</listitem>
+</orderedlist>
+</sect2>
+</sect1>
+<sect1 id="sysadmin-52">
+<title>Enabling Braille</title>
+<indexterm>
+<primary>Braille, enabling</primary>
+</indexterm>
+<para>To enable
+your system to support Braille output, you must configure the access rights
+to the serial port to which the Braille device is connected. The following
+sections describe the steps that you need to perform depending on your operating
+system.</para>
+<sect2 id="sysadmin-53">
+<title>To Enable Braille on Solaris Systems</title>
+<para>To configure the serial port to which the Braille device is connected
+on Solaris systems, perform the following steps:</para>
+<orderedlist>
+<listitem>
+<para>Log in as the <literal>root</literal> user.</para>
+</listitem>
+<listitem>
+<para>Enter the following command:</para>
+<para>
+<command>chmod 777 /dev/cua/a</command>
+</para>
+</listitem>
+<listitem>
+<para>Enter the following command:</para>
+<para>
+<command>chmod 777 /dev/cua/b</command>
+</para>
+</listitem>
+<listitem>
+<para>Change the permissions to <literal>777</literal> on the devices
+to which the symbolic links <literal>/dev/cua/a</literal> and <literal>/dev/cua/b</literal> point. </para>
 </listitem>
+</orderedlist>
+<note>
+<para>If your system uses <command>/dev/cua/a</command> for system log
+messages, Braille will not work on that serial port. Use <command>/dev/cua/b</command> instead.</para>
+</note>
+</sect2>
+<sect2 id="sysadmin-54">
+<title>To Enable Braille on Linux Systems</title>
+<para>To configure the serial port to which the Braille device is connected
+on Linux systems, perform the following steps:</para>
+<orderedlist>
 <listitem>
-<para>Click <guibutton>Close</guibutton> to close the <guilabel>Zoomer Options</guilabel> dialog.</para>
+<para>Log in as the <literal>root</literal> user.</para>
 </listitem>
 <listitem>
-<para>Click <guibutton>Close</guibutton> to close the <guilabel>Magnifier Preferences</guilabel> dialog.</para>
+<para>Enter the following command:</para>
+<para>
+<command>chmod 777 /dev/ttyS0</command>
+</para>
+</listitem>
+<listitem>
+<para>Enter the following command:</para>
+<para>
+<command>chmod 777 /dev/ttyS1</command>
+</para>
 </listitem>
 </orderedlist>
 </sect2>
 </sect1>
 <sect1 id="sysadmin-37">
-<title>Configuring Multiple Pointer Devices</title>
+<title>Configuring Alternative Pointer Devices</title>
 <para>The following sections describe how to configure your system to use
 a standard physical mouse and another pointer device such as a single switch
 device or head tracker device, and how to configure <application>On-Screen
 Keyboard</application> to use the second pointer device.</para>
 <sect2 id="sysadmin-45">
-<title>To Configure Two Pointer Devices on Solaris Systems</title>
+<title>To Configure Alternative Pointer Devices on Solaris Systems</title>
 <indexterm>
 <primary>configuring two pointer devices</primary>
 <secondary>on
 Solaris systems</secondary>
 </indexterm>
-<para><application>Screen Reader and
-Magnifier</application>To configure two pointer devices on a Solaris system,
-perform the following steps:</para>
+<para>To configure an alternative pointer
+device on a Solaris system, perform the following steps:</para>
 <note>
-<para>This procedure does not work for all Solaris platforms.</para>
+<para>This procedure does not work on all Solaris platforms.</para>
 </note>
 <orderedlist>
 <listitem>
-<para>Before you connect the auxiliary pointer device to your system,
-enter the following command to list the existing devices:</para>
+<para>Before you connect the alternative pointer device to your
+system, enter the following command to list the existing devices:</para>
 <para>
 <command>ls -l /dev/usb/hid*</command>
 </para>
 </listitem>
 <listitem>
-<para>Connect the auxiliary device to your system.</para>
+<para>Connect the alternative pointer device to your system.</para>
 </listitem>
 <listitem>
 <para>Enter the following command again to list the new device:</para>
@@ -614,24 +833,24 @@ file.</para>
 </orderedlist>
 </sect2>
 <sect2 id="sysadmin-46">
-<title>To Configure Two Pointer Devices on Linux Systems</title>
+<title>To Configure Alternative Pointer Devices on Linux Systems</title>
 <indexterm>
 <primary>configuring two pointer devices</primary>
 <secondary>on
 Linux systems</secondary>
 </indexterm>
-<para>To configure two pointer devices
-on a Linux system, perform the following steps:</para>
+<para>To configure an alternative pointer
+device on a Linux system, perform the following steps:</para>
 <orderedlist>
 <listitem>
-<para>Before you connect the auxiliary pointer device to your system,
-enter the following command to list the existing devices:</para>
+<para>Before you connect the alternative pointer device to your
+system, enter the following command to list the existing devices:</para>
 <para>
 <command>ls -l /dev/usb/hid*</command>
 </para>
 </listitem>
 <listitem>
-<para>Connect the auxiliary device to your system.</para>
+<para>Connect the alternative pointer device to your system.</para>
 </listitem>
 <listitem>
 <para>Enter the following command again to list the new device:</para>
@@ -646,7 +865,7 @@ enter the following command to list the existing devices:</para>
 <para>Edit the <literal>InputDevice</literal> section where the <literal>Driver</literal> value is set to <literal>mouse</literal> as follows:</para>
 <itemizedlist>
 <listitem>
-<para>Change the <literal>Option Device</literal> line as follows:</para>
+<para>Change the <literal>Option Device</literal> line to the following:</para>
 <para>
 <literallayout>Option &quot;Device&quot; &quot;/dev/input/mouse0&quot;</literallayout>
 </para>
@@ -685,7 +904,7 @@ and other pointer device, you do not need to carry out this step.</para>
 <itemizedlist>
 <listitem>
 <para>Change the <literal>InputDevice &quot;Mouse[1]&quot;</literal> line
-as follows:</para>
+to the following:</para>
 <para>
 <literallayout>InputDevice &quot;Mouse[1]&quot; &quot;CorePointer&quot;</literallayout>
 </para>
@@ -702,9 +921,10 @@ as follows:</para>
 </listitem>
 </itemizedlist>
 <note>
-<para>If you are not using USB connections for your primary mouse device
-and other pointer device, ensure that only the device that you are using as
-the primary mouse device has the <literal>&quot;CorePointer&quot;</literal> attribute.</para>
+<para>Ensure that only the device that you are using as the primary
+mouse device has the <literal>&quot;CorePointer&quot;</literal> attribute and ensure
+that the alternate input devices do not have the <literal>SendCore</literal>
+or <literal>AlwaysCore</literal> attributes.</para>
 </note>
 </listitem>
 <listitem>
@@ -716,17 +936,17 @@ the primary mouse device has the <literal>&quot;CorePointer&quot;</literal> attr
 </orderedlist>
 </sect2>
 <sect2 id="sysadmin-47">
-<title>To Configure On-Screen Keyboard to Use the Second Pointer Device</title>
+<title>To Configure On-Screen Keyboard to Use an Alternative Pointer Device</title>
 <indexterm>
 <primary>On-Screen Keyboard</primary>
 <secondary>configuring for
 two pointer devices</secondary>
 </indexterm>
-<para>To configure the <application>On-Screen Keyboard</application> application to use a second pointer device,
-perform the following steps.</para>
+<para>To configure the <application>On-Screen Keyboard</application> application to use an alternative pointer
+device, perform the following steps.</para>
 <orderedlist>
 <listitem>
-<para>Start the <application>On-Screen Reader</application> application.</para>
+<para>Start the <application>On-Screen Keyboard</application> application.</para>
 </listitem>
 <listitem>
 <para>Click on <guilabel>GOK</guilabel> in the <guilabel>GOK - main</guilabel> window.</para>
diff --git a/gnome2-accessibility-guide/C/themes.xml b/gnome2-accessibility-guide/C/themes.xml
index 4be5c16..4c25644 100644
--- a/gnome2-accessibility-guide/C/themes.xml
+++ b/gnome2-accessibility-guide/C/themes.xml
@@ -146,12 +146,18 @@ the appearance of icons on panels and on the desktop background.</para>
 <primary>themes</primary>
 <secondary>desktop</secondary>
 </indexterm>
-<para>To open the <application>Theme</application> preference tool and view
-the themes that are available, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Theme</guimenuitem></menuchoice>. The <guilabel>Theme Preferences</guilabel> dialog is displayed. </para>
-<para>The themes are listed on the left side of the <guilabel>Theme Preferences</guilabel> dialog. To choose a new theme, click on a theme in the list box.
-The system automatically applies the theme to the desktop. There are several
-themes available that suit different accessibility needs. These themes are
-described in the following table:</para>
+<para>To choose a theme, perform the following steps:</para>
+<orderedlist>
+<listitem>
+<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Theme</guimenuitem></menuchoice>. The themes
+are listed on the left side of the <guilabel>Theme Preferences</guilabel>
+dialog.</para>
+</listitem>
+<listitem>
+<para>Click on a theme in the list box to choose a new theme. The
+system automatically applies the theme to the desktop. </para>
+<para>There are several themes available that suit different accessibility
+needs, as described in the following table:</para>
 <table frame="topbot" id="themes-TBL-2">
 <title>Themes Designed for Accessibility Requirements</title>
 <tgroup cols="2" colsep="0" rowsep="0">
@@ -197,13 +203,17 @@ light text on a dark background using high contrast colors.</para>
 </para>
 </entry>
 <entry colname="colspec1" valign="top">
-<para>Increases the font size to 18pt.
-The background and foreground colors are the same as those specified by the <guilabel>Default</guilabel> desktop theme.</para>
+<para>This theme suggests an increased
+font size of 18pt. The background and foreground colors are the same as those
+specified by the <guilabel>Default</guilabel> desktop theme. To apply the
+suggested font, click on the <guibutton>Apply Font</guibutton> button.</para>
 </entry>
 </row>
 </tbody>
 </tgroup>
 </table>
+</listitem>
+</orderedlist>
 <para>To view the controls, window frame, and icon settings that are associated
 with a theme, select a theme in the <guilabel>Theme Preferences</guilabel>
 dialog, then click on the <guibutton>Theme Details</guibutton> button. The <guilabel>Theme Details</guilabel> dialog contains a tabbed section for each setting
@@ -290,8 +300,9 @@ the background and foreground text. </para>
 </para>
 </entry>
 <entry colname="colspec1" valign="top">
-<para>Increases the font size to 18pt.
-The background and foreground colors are the same as those specified by the <guilabel>Default</guilabel> desktop theme.</para>
+<para>Increases the size of controls
+to accommodate larger fonts. To increase the font size, you must use the <application>Font</application> preference tool. The background and foreground colors are
+the same as those specified by the <guilabel>Default</guilabel> desktop theme.</para>
 </entry>
 </row>
 <row>
@@ -302,7 +313,9 @@ The background and foreground colors are the same as those specified by the <gui
 </entry>
 <entry valign="top">
 <para>Provides dark text on a light background using high
-contrast colors and increases the font size to 18pt.</para>
+contrast colors. Increases the size of controls to accommodate larger fonts.
+To increase the font size, you must use the <application>Font</application>
+preference tool.</para>
 </entry>
 </row>
 <row>
@@ -313,7 +326,9 @@ contrast colors and increases the font size to 18pt.</para>
 </entry>
 <entry valign="top">
 <para>Provides light text on a dark background using high
-contrast colors and increases the font size to 18pt.</para>
+contrast colors. Increases the size of controls to accommodate larger fonts.
+To increase the font size, you must use the <application>Font</application>
+preference tool.</para>
 </entry>
 </row>
 <row>
@@ -324,8 +339,9 @@ contrast colors and increases the font size to 18pt.</para>
 </entry>
 <entry colname="colspec1" valign="top">
 <para>Uses
-low contrast colors for the background and foreground text and increases the
-font size to 18pt. </para>
+low contrast colors for the background and foreground text. Increases the
+size of controls to accommodate larger fonts. To increase the font size, you
+must use the <application>Font</application> preference tool.</para>
 </entry>
 </row>
 </tbody>
@@ -443,8 +459,9 @@ the background and foreground text. </para>
 </para>
 </entry>
 <entry colname="colspec1" valign="top">
-<para>Increases the font size to 18pt.
-The background and foreground colors are the same as those specified by the <guilabel>Default</guilabel> desktop theme.</para>
+<para>The background and foreground
+colors are the same as those specified by the <guilabel>Default</guilabel>
+desktop theme. To increase the font size, you must use the <application>Font</application> preference tool.</para>
 </entry>
 </row>
 <row>
@@ -455,7 +472,7 @@ The background and foreground colors are the same as those specified by the <gui
 </entry>
 <entry valign="top">
 <para>Provides dark text on a light background using high
-contrast colors and increases the font size to 18pt.</para>
+contrast colors. To increase the font size, you must use the <application>Font</application> preference tool.</para>
 </entry>
 </row>
 <row>
@@ -466,7 +483,7 @@ contrast colors and increases the font size to 18pt.</para>
 </entry>
 <entry valign="top">
 <para>Provides light text on a dark background using high
-contrast colors and increases the font size to 18pt.</para>
+contrast colors. To increase the font size, you must use the <application>Font</application> preference tool.</para>
 </entry>
 </row>
 <row>
@@ -477,8 +494,8 @@ contrast colors and increases the font size to 18pt.</para>
 </entry>
 <entry colname="colspec1" valign="top">
 <para>Uses
-low contrast colors for the background and foreground text and increases the
-font size to 18pt. </para>
+low contrast colors for the background and foreground text. To increase the
+font size, you must use the <application>Font</application> preference tool.</para>
 </entry>
 </row>
 </tbody>