summaryrefslogtreecommitdiffstats
path: root/gnome2-accessibility-guide/C
diff options
context:
space:
mode:
authorIrene Ryan <ireneryan@src.gnome.org>2004-09-10 16:43:08 +0000
committerIrene Ryan <ireneryan@src.gnome.org>2004-09-10 16:43:08 +0000
commit58f99b54de73e660510f6339c2dfa6e27e9944ba (patch)
tree5a0e8f7cbc96a328f6cdebc5e391aa32ded2e00c /gnome2-accessibility-guide/C
parentbbb47ea0fcf6df5b5ba082e41f4b7a15259e40e7 (diff)
downloadgnome-user-docs-58f99b54de73e660510f6339c2dfa6e27e9944ba.tar.gz
gnome-user-docs-58f99b54de73e660510f6339c2dfa6e27e9944ba.tar.xz
gnome-user-docs-58f99b54de73e660510f6339c2dfa6e27e9944ba.zip
New version of the Accessibility Guide to support GNOME 2.8. New appendix added on sys. admin and user tasks required to use ATs.
Diffstat (limited to 'gnome2-accessibility-guide/C')
-rw-r--r--gnome2-accessibility-guide/C/accessintro.xml18
-rw-r--r--gnome2-accessibility-guide/C/dtconfig.xml167
-rwxr-xr-xgnome2-accessibility-guide/C/gnome-access-guide-C.omf14
-rw-r--r--gnome2-accessibility-guide/C/gnome-access-guide.xml29
-rw-r--r--gnome2-accessibility-guide/C/keynav.xml164
-rw-r--r--gnome2-accessibility-guide/C/preface.xml49
-rw-r--r--gnome2-accessibility-guide/C/themes.xml181
-rw-r--r--gnome2-accessibility-guide/C/troubleshooting.xml437
8 files changed, 779 insertions, 280 deletions
diff --git a/gnome2-accessibility-guide/C/accessintro.xml b/gnome2-accessibility-guide/C/accessintro.xml
index c55bba5..98b3ac6 100644
--- a/gnome2-accessibility-guide/C/accessintro.xml
+++ b/gnome2-accessibility-guide/C/accessintro.xml
@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="utf-8"?>
<chapter id="accessintro-1">
<title>Introduction to Accessibility</title>
<para>This chapter introduces you to accessibility in the GNOME Desktop.</para>
@@ -8,13 +7,14 @@
people with disabilities 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 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 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 customizability of the Desktop contributes greatly to the accessibility. This manual describes the various customization options that
-you can use to tailor the Desktop to suit your particular needs.</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
+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 environment.</para>
+ <para>The customizability of the GNOME Desktop contributes greatly to the accessibility of the desktop.
+This manual 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/dtconfig.xml b/gnome2-accessibility-guide/C/dtconfig.xml
index 267975b..8a6444b 100644
--- a/gnome2-accessibility-guide/C/dtconfig.xml
+++ b/gnome2-accessibility-guide/C/dtconfig.xml
@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="utf-8"?>
<chapter id="dtconfig-0">
<title>Configuring the Mouse and Keyboard</title>
<para>This chapter describes how to configure the mouse and keyboard to make
@@ -7,7 +6,8 @@ these devices accessible to more users.</para>
<title>Configuring the Mouse</title>
<para>Use the <guilabel>Mouse</guilabel> preference tool to configure the
mouse to suit your needs. To open the <guilabel>Mouse</guilabel> preference
-tool, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Mouse</guimenuitem></menuchoice>.
+tool, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Mouse</guimenuitem></menuchoice>.
The <guilabel>Mouse Preferences</guilabel> dialog is displayed.</para>
<sect2 id="dtconfig-2">
<title>To Configure the Behavior of the Mouse</title>
@@ -36,8 +36,8 @@ steps:</para>
<para>Click on the <guilabel>Buttons</guilabel> tab in the <guilabel>Mouse Preferences</guilabel> dialog.</para>
</listitem>
<listitem>
- <para>Use the <guilabel>Delay</guilabel> slider to specify the timeout
-in seconds that the system allows between the two clicks of a double-click. </para>
+ <para>Use the <guilabel>Timeout</guilabel> slider to specify the
+timeout in seconds that the system allows between the two clicks of a double-click. </para>
</listitem>
<listitem>
<para>Double-click on the light bulb to the right of the slider
@@ -50,6 +50,47 @@ for your needs. </para>
</listitem>
</orderedlist>
</sect3>
+ <sect3 id="dtconfig-20">
+ <title>To Change the Size of the Cursor and Pointer</title>
+ <para>To change the size of the cursor and pointer that is displayed on the
+desktop, perform the following steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Click on the <guilabel>Cursors</guilabel> tab in the <guilabel>Mouse Preferences</guilabel> dialog. </para>
+ </listitem>
+ <listitem>
+ <para>Select one of the following <guilabel>Cursor Size</guilabel>
+options:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Small</para>
+ </listitem>
+ <listitem>
+ <para>Medium</para>
+ </listitem>
+ <listitem>
+ <para>Large</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>To complete this change, you must log out of your session
+and log in again.</para>
+ </listitem>
+ </orderedlist>
+ </sect3>
+ <sect3 id="dtconfig-6">
+ <title>To Locate the Mouse Pointer</title>
+ <para>If you have difficulty locating the mouse pointer on the screen, you
+can enable an option to highlight the pointer when you press the <keycap>Control</keycap> key. To enable this option, click on the <guilabel>Cursors</guilabel> tab in the <guilabel>Mouse Preferences</guilabel> dialog, then
+select the <guilabel>Highlight the pointer when you press Ctrl</guilabel>
+option. When you press <keycap>Control</keycap>, the system displays an animation
+around the pointer to highlight the pointer. </para>
+ <note>
+ <para>On some platforms, you must log out and log in again before this
+setting takes effect.</para>
+ </note>
+ </sect3>
<sect3 id="dtconfig-5">
<title>To Configure the Speed and Sensitivity of the Mouse</title>
<para>To configure the speed and sensitivity of the mouse, perform the following
@@ -95,70 +136,25 @@ action as a drag-and-drop action.</para>
</listitem>
</orderedlist>
</sect3>
- <sect3 id="dtconfig-6">
- <title>To Locate the Mouse Pointer</title>
- <para>If you have difficulty locating the mouse pointer on the screen, you
-can enable an option to highlight the pointer when you press the <keycap>Control</keycap> key. To enable this option, click on the <guilabel>Cursors</guilabel> tab in the <guilabel>Mouse Preferences</guilabel> dialog, then
-select the <guilabel>Show position of cursor when the Control key is pressed</guilabel> option. When you press <keycap>Control</keycap>, the system displays
-an animation around the pointer to highlight the pointer. </para>
- <note>
- <para>On some platforms, you must log out and log in again before this
-setting takes effect.</para>
- </note>
- </sect3>
</sect2>
<sect2 id="dtconfig-7">
- <title>To Configure the Mouse Pointer</title>
+ <title>To Configure the Cursor</title>
<para>The following sections describe how to modify the display characteristics
-of the pointer. </para>
- <sect3 id="dtconfig-8">
- <title>To Change the Pointer</title>
- <para>To select the type of pointer that is displayed on the Desktop, perform
-the following steps:</para>
- <orderedlist>
- <listitem>
- <para>Click on the <guilabel>Cursors</guilabel> tab in the <guilabel>Mouse Preferences</guilabel> dialog. </para>
- </listitem>
- <listitem>
- <para>Select one of the following themes from the pointer themes
-that are listed in the <guilabel>Cursor Theme</guilabel> list box:</para>
- <itemizedlist>
- <listitem>
- <para>Default Cursor</para>
- <para>Displays the default black pointer.</para>
- </listitem>
- <listitem>
- <para>White Cursor</para>
- <para>Displays a white pointer that is the same size as the default pointer.</para>
- </listitem>
- <listitem>
- <para>Large Cursor</para>
- <para>Displays a large black pointer.</para>
- </listitem>
- <listitem>
- <para>Large White Cursor</para>
- <para>Displays a large white pointer.</para>
- </listitem>
- </itemizedlist>
- </listitem>
- <listitem>
- <para>To change the pointer theme, you must log out of your session
-and log in again.</para>
- </listitem>
- </orderedlist>
- </sect3>
+of the cursor. </para>
<sect3 id="dtconfig-9">
<title>To Stop the Cursor Blinking</title>
<para>To stop the cursor blinking in text boxes and fields, perform the following
steps: </para>
<orderedlist>
<listitem>
- <para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice> to start the <application>Keyboard</application>
+ <para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>
+to start the <application>Keyboard</application>
preference tool.</para>
</listitem>
<listitem>
<para>In the <guilabel>Keyboard</guilabel> tabbed section, deselect
-the <guilabel>Blinks in text boxes and fields</guilabel> option.</para>
+the <guilabel>Cursor blinks in text boxes and fields</guilabel> option.</para>
</listitem>
</orderedlist>
</sect3>
@@ -174,10 +170,10 @@ information.</para>
<title>Configuring the Keyboard</title>
<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>
- <para>The <application>AccessX</application> dialog enables you to customize
-your keyboard in the following ways:</para>
+accessibility options. To start <application>AccessX</application>, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Keyboard</guimenuitem></menuchoice>.</para>
+ <para>The <guilabel>Keyboard Accessibility Preferences (AccessX)</guilabel>
+dialog enables you to customize your keyboard in the following ways:</para>
<itemizedlist>
<listitem>
<para>To use the numeric keypad to emulate mouse actions. See <xref linkend="dtconfig-14"/>.</para>
@@ -203,13 +199,12 @@ repeat rate of a keypress. See <xref linkend="dtconfig-19"/>.</para>
</listitem>
</itemizedlist>
<sect2 id="dtconfig-12">
- <title>Before You Can Use AccessX in the Solaris&#8482; Operating Environment</title>
- <para>If you are using the GNOME Desktop for the Solaris&#8482; 8 operating
-environment or the Solaris 9 operating environment, you must enable XKB on
-your system before you can use the <application>AccessX</application> preference
-tool. </para>
+ <title>Before You Can Use AccessX onthe Solaris&trade; Operating System</title>
+ <para>If you are using the GNOME Desktop for the Solaris&trade; 8 operating
+system or the 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&#8482; systems.</para>
+ <para>XKB is not currently supported on Sun Ray&trade; systems.</para>
</note>
<para>To enable XKB on a non-Sun Ray Solaris system, perform the following
steps:</para>
@@ -312,7 +307,8 @@ using a mouse or other pointing device. To enable and configure the mouse
keys feature, perform the following steps:</para>
<orderedlist>
<listitem>
- <para>Click on the <guilabel>Mouse</guilabel> tab to display the <guilabel>Mouse</guilabel> tabbed section.</para>
+ <para>Click on the <guilabel>Mouse Keys</guilabel> tab to display
+the <guilabel>Mouse Keys</guilabel> tabbed section.</para>
</listitem>
<listitem>
<para>Select the <guilabel>Enable Mouse Keys</guilabel> option.</para>
@@ -420,7 +416,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>
@@ -552,8 +548,8 @@ steps:</para>
<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 enabling/disabling
-keyboard accessibility features</guilabel> option, after four seconds the
+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
@@ -602,7 +598,6 @@ after x msecs</guilabel> setting.</para>
</variablelist>
</listitem>
</orderedlist>
- <para/>
</sect2>
<sect2 id="dtconfig-16">
<title>To Enable the Bounce Keys Feature</title>
@@ -657,11 +652,11 @@ steps:</para>
<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 enabling/disabling
-keyboard accessibility features</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>
+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>
@@ -781,19 +776,27 @@ steps: </para>
<para>Click on the <guilabel>Basic</guilabel> tab to display the <guilabel>Basic</guilabel> tabbed section.</para>
</listitem>
<listitem>
- <para>Select the <guibutton>Repeat Keys</guibutton> option to enable
-the repeat keys feature.</para>
+ <para>Select the <guilabel>Enable Repeat Keys</guilabel>
+option to enable the repeat keys feature.</para>
</listitem>
<listitem>
- <para>Use the <guilabel>Delay</guilabel> slider to specify the duration
-for which you must press a key before the keyboard interprets the action as
-a repeat key. If you have difficulty releasing keys, select a long time delay. </para>
+ <para>Use the <guilabel>Delay</guilabel> slider or spin box to specify
+the duration for which you must press a key before the keyboard interprets
+the action as a repeat key. If you have difficulty releasing keys, select
+a long time delay. </para>
</listitem>
<listitem>
- <para>Use the <guilabel>Speed</guilabel> slider to
-specify the speed at which the keyboard repeats the keypress as input.</para>
+ <para>Use the <guilabel>Speed</guilabel> slider or spin box to specify
+the speed at which the keyboard repeats the keypress as input.</para>
</listitem>
</orderedlist>
</sect2>
</sect1>
+ <sect1 id="dtconfig-21">
+ <title>Using the Keyboard Accessibility Status Applet</title>
+ <para>The <application>Keyboard Accessibility Status</application> applet
+shows the status of the keyboard accessibility features. The applet displays
+icons to indicate which keyboard accessibility features are enabled in the <application>Keyboard Accessibility</application> preference tool.</para>
+ <para>To add the applet to a panel, right-click on the panel, then choose <menuchoice><guimenu>Add to Panel</guimenu><guisubmenu>Accessories</guisubmenu><guimenuitem>Keyboard Accessibility Status</guimenuitem></menuchoice>.</para>
+ </sect1>
</chapter>
diff --git a/gnome2-accessibility-guide/C/gnome-access-guide-C.omf b/gnome2-accessibility-guide/C/gnome-access-guide-C.omf
index 604344c..bba82c5 100755
--- a/gnome2-accessibility-guide/C/gnome-access-guide-C.omf
+++ b/gnome2-accessibility-guide/C/gnome-access-guide-C.omf
@@ -2,26 +2,26 @@
<omf>
<resource>
<creator>
- docs@gnome.org Sun Microsystems
+ gdocteam@sun.com (Sun Java Desktop System Documentation Team)
</creator>
<maintainer>
- docs@gnome.org Sun Microsystems
+ gdocteam@sun.com (Sun Java Desktop System Documentation Team)
</maintainer>
<!--
<title>
- GNOME 2.6 Desktop Accessibility Guide V2.6.0
+ GNOME 2.8 Desktop Accessibility Guide V2.8.0
</title>
-->
<title>
Accessibility Guide
</title>
<date>
- 2004-03-16
+ 2004-09-09
</date>
- <version identifier="2.6.0" date="2004-03-16" description="Multiplatform accessibility guide"/>
+ <version identifier="2.8.0" date="2004-09-09" description="Multiplatform accessibility guide"/>
<subject category="GNOME|Desktop"/>
<description>
- Accessibility Guide for the GNOME 2.6 Desktop
+ Accessibility Guide for the GNOME 2.8 Desktop
</description>
<type>
accessibility guide
@@ -31,6 +31,6 @@
<language code="C"/>
<relation seriesid="0f5d3d30-28c5-11d7-9d8d-bd839db251e3"/>
<rights type="GNU FDL" license.version="1.1"
- holder="Sun Microsystems"/>
+ holder="Sun Microsystems, Inc."/>
</resource>
</omf>
diff --git a/gnome2-accessibility-guide/C/gnome-access-guide.xml b/gnome2-accessibility-guide/C/gnome-access-guide.xml
index ca2a7d8..48c524a 100644
--- a/gnome2-accessibility-guide/C/gnome-access-guide.xml
+++ b/gnome2-accessibility-guide/C/gnome-access-guide.xml
@@ -1,15 +1,18 @@
<?xml version="1.0"?>
<!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.6">
- <!ENTITY manrevision "2.6.0">
- <!ENTITY date "March 2004">
+ <!ENTITY gnomeversion "2.8">
+ <!ENTITY manrevision "2.8.0">
+ <!ENTITY date "September 2004">
<!ENTITY LEGAL SYSTEM "legal.xml">
<!ENTITY dtconfig SYSTEM "dtconfig.xml">
<!ENTITY keynav SYSTEM "keynav.xml">
<!ENTITY themes SYSTEM "themes.xml">
<!ENTITY preface SYSTEM "preface.xml">
<!ENTITY accessintro SYSTEM "accessintro.xml">
+ <!ENTITY troubleshooting SYSTEM "troubleshooting.xml">
+ <!ENTITY author1 "Sun">
+ <!ENTITY author2 "Java Desktop System Documentation Team">
]>
<book id="index">
<title>GNOME &gnomeversion; Desktop Accessibility Guide</title>
@@ -18,7 +21,7 @@
<year>2004</year>
<year>2003</year>
<year>2002</year>
- <holder>Sun Microsystems</holder>
+ <holder>Sun Microsystems, Inc.</holder>
</copyright>
<!-- translators: uncomment this:
@@ -28,15 +31,15 @@
</copyright>
-->
<publisher>
- <publishername> GNOME Documentation Project </publishername>
+ <publishername>GNOME Documentation Project</publishername>
</publisher> &LEGAL;
<authorgroup>
<author>
- <firstname>Sun</firstname>
- <surname>GNOME Documentation Team</surname>
+ <firstname>&author1;</firstname>
+ <surname>&author2;</surname>
<affiliation>
- <orgname>Sun Microsystems</orgname>
+ <orgname>Sun Microsystems, Inc.</orgname>
</affiliation>
</author>
</authorgroup>
@@ -46,6 +49,14 @@
<revnumber>GNOME &gnomeversion; Desktop Accessibility Guide V&manrevision;</revnumber>
<date>&date;</date>
<revdescription>
+ <para role="author">Sun Microsystems, Inc.</para>
+ <para role="publisher">GNOME Documentation Project</para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>GNOME 2.6 Desktop Accessibility Guide V2.6.0</revnumber>
+ <date>March 2004</date>
+ <revdescription>
<para role="author">Sun Microsystems</para>
<para role="publisher">GNOME Documentation Project</para>
</revdescription>
@@ -97,4 +108,4 @@
&dtconfig;
&keynav;
&themes;
- </book>
+&troubleshooting; </book>
diff --git a/gnome2-accessibility-guide/C/keynav.xml b/gnome2-accessibility-guide/C/keynav.xml
index 859fd49..6df8281 100644
--- a/gnome2-accessibility-guide/C/keynav.xml
+++ b/gnome2-accessibility-guide/C/keynav.xml
@@ -1,13 +1,12 @@
-<?xml version="1.0" encoding="utf-8"?>
<chapter id="keynav-0">
<title>Using the Keyboard to Navigate the Desktop</title>
- <para>This chapter describes how to navigate the Desktop from the keyboard
-only. Users who have difficulty using a mouse or other pointing device can
-navigate and use the Desktop from the keyboard.</para>
+ <para>This chapter describes how to navigate the GNOME Desktop from the keyboard only. Users who have difficulty using
+a mouse or other pointing device can navigate and use the desktop from the
+keyboard.</para>
<sect1 id="keynav-1">
<title>Introduction to Keyboard Navigation</title>
<para>This section describes the essential keyboard shortcuts to enable you
-to navigate the Desktop from the keyboard. </para>
+to navigate the desktop from the keyboard. </para>
<para>You can customize some of the keyboard shortcuts that are described
in this chapter. The text indicates the shortcuts that you can customize.
See <xref linkend="keynav-36"/> for information about how to customize keyboard
@@ -15,9 +14,9 @@ shortcuts. </para>
<sect2 id="keynav-2">
<title>Essential Keyboard Shortcuts</title>
<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 Desktop elements and controls are described in the appropriate sections
-of this chapter.</para>
+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*"/>
@@ -40,7 +39,7 @@ of this chapter.</para>
</para>
</entry>
<entry valign="top">
- <para>Give focus to the next Desktop element or control.</para>
+ <para>Give focus to the next element or control.</para>
</entry>
</row>
<row>
@@ -49,9 +48,8 @@ of this chapter.</para>
</entry>
<entry colname="colspec1" valign="top">
<para>Reverse
-the navigation direction and give focus to the previous Desktop element or
-control. In general, the <keycap>Shift</keycap> key reverses the navigation
-direction.</para>
+the navigation direction and give focus to the previous element or control.
+In general, the <keycap>Shift</keycap> key reverses the navigation direction.</para>
</entry>
</row>
<row>
@@ -72,8 +70,8 @@ press <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>Tab</keycap><
<para>arrow keys</para>
</entry>
<entry colname="colspec1" valign="top">
- <para>Navigate within a Desktop element
-or control.</para>
+ <para>Navigate within an element or
+control.</para>
</entry>
</row>
<row>
@@ -105,7 +103,7 @@ is the equivalent of clicking on the button with a mouse.</para>
<sect2 id="keynav-3">
<title>Global Keyboard Shortcuts</title>
<para>The following table lists the keyboard shortcuts that you can use from
-any part of the Desktop. </para>
+any part of the GNOME Desktop. </para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colname="colspec0" colwidth="43.94*"/>
@@ -173,9 +171,9 @@ currently has focus.</para>
</para>
</entry>
<entry colname="colspec1" valign="top">
- <para>If the focused Desktop element
-is an application window or dialog, this keyboard shortcut opens the online
-help for the application.</para>
+ <para>If the focused element is an
+application window or dialog, this keyboard shortcut opens the online help
+for the application.</para>
</entry>
</row>
<row>
@@ -184,9 +182,8 @@ help for the application.</para>
</entry>
<entry colname="colspec1" valign="top">
<para>If
-the focused Desktop element is a panel or application window, this keyboard
-shortcut switches the display of tooltips for the window or panel objects
-on and off.</para>
+the focused element is a panel or application window, this keyboard shortcut
+switches the display of tooltips for the window or panel objects on and off.</para>
</entry>
</row>
<row>
@@ -195,7 +192,7 @@ on and off.</para>
</entry>
<entry colname="colspec1" valign="top">
<para>Open
-a popup menu for the Desktop element that has focus, if a popup menu exists.</para>
+a popup menu for the element that has focus, if a popup menu exists.</para>
</entry>
</row>
</tbody>
@@ -205,12 +202,11 @@ a popup menu for the Desktop element that has focus, if a popup menu exists.</pa
</sect1>
<sect1 id="keynav-4">
<title>Navigating the Desktop Background</title>
- <para>The desktop background is the part of the Desktop where there are no
-interface items or applications, such as panels and windows. The following
-table lists the keyboard shortcuts that you can use to navigate the desktop
-background and the desktop background objects. A desktop background object
-is an icon on the desktop background that you can use to open files, folders,
-or applications. </para>
+ <para>The desktop background is the part of the GNOME Desktop where there are no interface items or applications, such
+as panels and windows. The following table lists the keyboard shortcuts that
+you can use to navigate the desktop background and the desktop background
+objects. A desktop background object is an icon on the desktop background
+that you can use to open files, folders, or applications. </para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colname="colspec0" colwidth="43.94*"/>
@@ -318,11 +314,10 @@ the <guimenu>Desktop Background</guimenu> menu.</para>
</sect1>
<sect1 id="keynav-5">
<title>Navigating Panels</title>
- <para>A panel is an area on the Desktop from which you can run special programs,
-applications, and applets. The most common panel is the Menu Panel, which
-stretches the full width of the top edge of the Desktop. The following table
-lists the keyboard shortcuts that you can use to navigate panels and panel
-objects.</para>
+ <para>A panel is an area from which you can run special programs, applications,
+and applets. The most common panel is the Menu Panel, which stretches the
+full width of the top edge of the desktop. The following table lists the keyboard
+shortcuts that you can use to navigate panels and panel objects.</para>
<informaltable frame="topbot">
<tgroup cols="2" colsep="0" rowsep="0">
<colspec colname="colspec0" colwidth="43.94*"/>
@@ -507,7 +502,7 @@ a move operation takes place.</para>
<imagedata fileref="figures/move_object_before.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Portion of a panel with three objects displayed in the following order from left to right: geyes icon, Volume Control icon, and Help icon.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -521,7 +516,7 @@ panel object.</para>
<imagedata fileref="figures/move_object_arrows.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Portion of a panel with three objects displayed in the following order from left to right: geyes icon, Volume Control icon, and Help icon. </phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -534,7 +529,7 @@ ahead of the object that you are moving.</para>
<imagedata fileref="figures/move_object_push.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Portion of a panel with three objects displayed in the following order from left to right: geyes icon, Volume Control icon, and Help icon.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -548,7 +543,7 @@ panel objects as you meet the objects.</para>
<imagedata fileref="figures/move_object_jump.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Portion of a panel with three objects displayed in the following order from left to right: Volume Control icon, Help icon, and geyes icon.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -751,7 +746,7 @@ how to navigate menus.</para>
<sect1 id="keynav-10">
<title>Navigating Your Workspaces</title>
<para>A workspace is a discrete area in which you can work. You can have many
-workspaces on your Desktop and you can switch from one workspace to another.
+workspaces on your desktop and you can switch from one workspace to another.
Each workspace can contain different windows and processes. The following
table lists the keyboard shortcuts that you can use to navigate workspaces.</para>
<informaltable frame="topbot">
@@ -893,7 +888,8 @@ the window.</para>
<para><emphasis>Linux:</emphasis><keycombo><keycap>Alt</keycap><keycap>F9</keycap></keycombo></para>
</entry>
<entry colname="colspec1" valign="top">
- <para>Minimize the window.</para>
+ <para>Minimize
+the window.</para>
</entry>
</row>
<row>
@@ -1071,7 +1067,7 @@ restore the window to the original size.</para>
<para>A paned window is a window that is split into two or more panes. The
Help browser and the <application>Nautilus</application> file manager are
examples of applications that use paned windows. </para>
- <figure>
+ <figure id="keynav-FIG-37">
<title>Example of a Paned Window</title>
<screenshot>
<mediaobject>
@@ -1079,7 +1075,7 @@ examples of applications that use paned windows. </para>
<imagedata fileref="figures/paned_window_anno.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Nautilus File Manager window. Contains a side pane, view pane, and a resize handle between the panes.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -1219,8 +1215,8 @@ had focus.</para>
<sect1 id="keynav-17">
<title>Navigating Applications</title>
<para>An application is any program, utility, or other software package that
-you run on your Desktop. Applications comprise the following standard user
-interface components: </para>
+you run in your desktop environment. Applications comprise the following standard
+user interface components: </para>
<variablelist>
<varlistentry>
<term>Windows</term>
@@ -1253,13 +1249,13 @@ that are available.</para>
shortcuts that you can use to start using applications and dialogs. </para>
<sect2 id="keynav-18">
<title>Essential Keyboard Shortcuts for Navigating Applications</title>
- <para>Since there are many applications that you can use in the Desktop, this
-manual does not describe the keyboard shortcuts that you can use to navigate
-all of the different applications. However, the basic keyboard shortcuts are
-common to all applications. Access keys also provide an efficient way to navigate
-an application from the keyboard. An access key is identified by an underlined
-letter on a menu or control. In some cases, you must press <keycap>Alt</keycap>
-in combination with the access key to perform an action.</para>
+ <para>Since there are many applications that you can use in the GNOME Desktop, this manual does not describe the keyboard shortcuts that
+you can use to navigate all of the different applications. However, the basic
+keyboard shortcuts are common to all applications. Access keys also provide
+an efficient way to navigate an application from the keyboard. An access key
+is identified by an underlined letter on a menu or control. In some cases,
+you must press <keycap>Alt</keycap> in combination with the access key to
+perform an action.</para>
<para>The following table lists the essential keyboard shortcuts that you
can use to navigate applications. </para>
<informaltable frame="topbot">
@@ -1420,20 +1416,19 @@ dialog.</para>
</sect2>
</sect1>
<sect1 id="keynav-20">
- <title>Navigating Nautilus File Manager</title>
- <para>The <application>Nautilus</application> file manager window contains
-several components and there are different keyboard shortcuts defined to navigate
-each component. The following graphic illustrates the name and location of
-each component.</para>
- <figure>
- <title>Nautilus File Manager Window Components</title>
+ <title>Navigating the File Manager</title>
+ <para>The file manager window contains several components and there are different
+keyboard shortcuts defined to navigate each component. The following graphic
+illustrates the name and location of each component.</para>
+ <figure id="keynav-FIG-38">
+ <title>File Manager Window Components</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="figures/naut_iconview_anno_window.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>File Manager window. Contains menubar, toolbar, location bar, Zoom buttons, side pane with tabs, and view pane.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -1741,7 +1736,7 @@ close.</para>
<title>To Navigate Buttons</title>
<para>A button is a control that you use to start an action. Most buttons
are rectangular and contain a text label. </para>
- <figure>
+ <figure id="keynav-FIG-39">
<title>Sample Button</title>
<screenshot>
<mediaobject>
@@ -1749,7 +1744,7 @@ are rectangular and contain a text label. </para>
<imagedata fileref="figures/button.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Close button.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -1801,7 +1796,7 @@ focus or, if no button has focus, perform the default action for the dialog.</pa
<title>To Navigate Radio Buttons</title>
<para>A radio button is a control that you use to select one of several mutually-exclusive
options. </para>
- <figure>
+ <figure id="keynav-FIG-40">
<title>Sample Radio Button</title>
<screenshot>
<mediaobject>
@@ -1809,7 +1804,7 @@ options. </para>
<imagedata fileref="figures/radio_button.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Two sample radio buttons.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -1847,7 +1842,7 @@ in the group.</para>
<sect2 id="keynav-27">
<title>To Navigate Check Boxes</title>
<para>A check box is a control that you use to select or deselect an option.</para>
- <figure>
+ <figure id="keynav-FIG-41">
<title>Sample Check Box</title>
<screenshot>
<mediaobject>
@@ -1855,7 +1850,7 @@ in the group.</para>
<imagedata fileref="figures/check_box.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Sample check box.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -1894,7 +1889,7 @@ navigate a check box.</para>
<sect2 id="keynav-28">
<title>To Navigate Text Boxes</title>
<para>Text boxes are controls in which you type text.</para>
- <figure>
+ <figure id="keynav-FIG-42">
<title>Sample Single Line Text Box</title>
<screenshot>
<mediaobject>
@@ -1902,7 +1897,7 @@ navigate a check box.</para>
<imagedata fileref="figures/text_box.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Sample text box with one input line.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -2209,7 +2204,7 @@ end of the next paragraph.</para>
<title>To Navigate Spin Boxes</title>
<para>A spin box is a control that allows you to type a numeric value or select
a value from a list of all possible values. </para>
- <figure>
+ <figure id="keynav-FIG-43">
<title>Sample Spin Box</title>
<screenshot>
<mediaobject>
@@ -2217,7 +2212,7 @@ a value from a list of all possible values. </para>
<imagedata fileref="figures/spin_box.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Sample spin box. Contains a text box and up and down arrows.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -2268,7 +2263,7 @@ or <keycap>Page Down</keycap></para>
<para>A drop-down list is a control that you use to select one of several
available items. The drop-down list contains a button that you use to display
the available items. </para>
- <figure>
+ <figure id="keynav-FIG-44">
<title>Sample Drop-Down List Box</title>
<screenshot>
<mediaobject>
@@ -2276,7 +2271,7 @@ the available items. </para>
<imagedata fileref="figures/dropdown_list_box.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Sample drop-down list box.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -2356,7 +2351,7 @@ the selection.</para>
<sect2 id="keynav-31">
<title>To Navigate Drop-Down Combination Boxes</title>
<para>A drop-down combination box is a text box with a drop-down list attached. </para>
- <figure>
+ <figure id="keynav-FIG-45">
<title>Sample Drop-Down Combination Box</title>
<screenshot>
<mediaobject>
@@ -2364,7 +2359,7 @@ the selection.</para>
<imagedata fileref="figures/dropdown_combination_box.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Sample drop-down combination box. Contains a text box and an arrow button that you click to display the drop-down list.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -2537,7 +2532,7 @@ and close the drop-down list.</para>
<title>To Navigate Sliders</title>
<para>A slider is a control that you use to set a value in a continuous range
of values.</para>
- <figure>
+ <figure id="keynav-FIG-46">
<title>Sample Slider</title>
<screenshot>
<mediaobject>
@@ -2545,7 +2540,7 @@ of values.</para>
<imagedata fileref="figures/slider.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Sample slider. Displays a slider control that you can move left or right.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -2635,7 +2630,7 @@ value.</para>
</sect2>
<sect2 id="keynav-33">
<title>To Navigate Tabbed Sections</title>
- <figure>
+ <figure id="keynav-FIG-47">
<title>Sample Dialog with Tabbed Sections</title>
<screenshot>
<mediaobject>
@@ -2643,7 +2638,7 @@ value.</para>
<imagedata fileref="figures/tabbed_section.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Editing profile dialog from the GNOME Terminal application. Contains six tabbed sections.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -2999,7 +2994,7 @@ focus to the column header, if applicable.</para>
<title>To Navigate Trees</title>
<para>A tree is a user interface control that contains sections that you can
expand and collapse. A tree usually represents a hierarchical structure.</para>
- <figure>
+ <figure id="keynav-FIG-48">
<title>Sample Tree Structure</title>
<screenshot>
<mediaobject>
@@ -3007,7 +3002,7 @@ expand and collapse. A tree usually represents a hierarchical structure.</para>
<imagedata fileref="figures/tree.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase/>
+ <phrase>Categories tree from the gedit Preferences dialog. Contains three subcategories.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -3065,13 +3060,14 @@ item.</para>
<sect1 id="keynav-36">
<title>Customizing Your Keyboard Shortcuts</title>
<para>Use the <application>Keyboard Shortcuts</application> preference tool
-to display the default keyboard shortcuts that you use to navigate the Desktop.
-You can customize the default keyboard shortcuts to meet your requirements.
-You can also create hot keys. Hot keys are keyboard shortcuts that start applications. </para>
+to display the default keyboard shortcuts that you use to navigate the GNOME Desktop. You can customize the default keyboard shortcuts to meet
+your requirements. You can also create hot keys. Hot keys are keyboard shortcuts
+that start applications. </para>
<para>To start the <application>Keyboard Shortcuts</application> preference
-tool, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Keyboard Shortcuts</guimenuitem></menuchoice>. The <guilabel>Desktop shortcuts</guilabel> table lists the
+tool, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Keyboard Shortcuts</guimenuitem></menuchoice>. The <guilabel>Desktop shortcuts</guilabel> table lists the
keyboard shortcut that is associated with each action.</para>
- <sect2>
+ <sect2 id="keynav-49">
<title>To Customize Keyboard Shortcuts on a Solaris System</title>
<para>To customize a keyboard shortcut, perform the following steps:</para>
<orderedlist>
@@ -3105,7 +3101,7 @@ disabled.</para>
</listitem>
</orderedlist>
</sect2>
- <sect2>
+ <sect2 id="keynav-50">
<title>To Customize Keyboard Shortcuts on a Linux System</title>
<para>To customize a keyboard shortcut, perform the following steps:</para>
<orderedlist>
diff --git a/gnome2-accessibility-guide/C/preface.xml b/gnome2-accessibility-guide/C/preface.xml
index 1dd6b64..9bc5176 100644
--- a/gnome2-accessibility-guide/C/preface.xml
+++ b/gnome2-accessibility-guide/C/preface.xml
@@ -1,19 +1,20 @@
-<?xml version="1.0" encoding="utf-8"?>
- <preface id="preface-1">
+ <preface id="preface-0">
<title>Preface</title>
- <para>The <citetitle>GNOME 2.4 Desktop Accessibility Guide</citetitle> describes
-how to configure, customize, and use the accessibility features of the GNOME
-2.4 Desktop.</para>
- <sect1 id="preface-9">
- <title id="preface-2">Who Should Use This Book</title>
- <para>This manual is for users, system administrators, and anyone who is interested
-in how the GNOME 2.4 Desktop satisfies Section 508 of the U.S. Rehabilitation
-Act.</para>
+ <highlights>
+ <para>The <citetitle>GNOME 2.8 Desktop Accessibility
+Guide</citetitle> describes
+how to configure, customize, and use the accessibility features of
+the GNOME 2.8 Desktop.</para>
+ </highlights>
+ <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.8 Desktop satisfies Section 508 of the U.S. Rehabilitation Act.</para>
</sect1>
- <sect1 id="preface-4">
- <title>How This Book Is Organized</title>
- <para>This manual is structured in the following manner:</para>
+ <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
@@ -24,27 +25,33 @@ in the GNOME Desktop.</para>
mouse and keyboard to make these devices accessible to more users.</para>
</listitem>
<listitem>
- <para><xref linkend="keynav-0"/> describes how to navigate the Desktop
-from the keyboard only.</para>
+ <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
-to change the appearance of the Desktop to enhance the accessibility for users with visual impairments.</para>
+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="troubleshooting-0"/> describes some system administrator
+and user tasks that you need to perform before you can use the assistive technologies
+for the GNOME Desktop.</para>
</listitem>
</itemizedlist>
</sect1>
- <sect1 id="preface-5">
- <title>Related Books</title>
- <para>The following manuals are related to this manual:</para>
+ <sect1 id="preface-3">
+ <title>Related Documentation</title>
+ <para>The following guides are related to this guide:</para>
<itemizedlist>
<listitem>
<para>
- <citetitle>GNOME 2.4 Desktop System Administration Guide</citetitle>
+ <citetitle>GNOME 2.8 Desktop System Administration Guide</citetitle>
</para>
</listitem>
<listitem>
<para>
- <citetitle>GNOME 2.4 Desktop User Guide</citetitle>
+ <citetitle>GNOME 2.8 Desktop User Guide</citetitle>
</para>
</listitem>
</itemizedlist>
diff --git a/gnome2-accessibility-guide/C/themes.xml b/gnome2-accessibility-guide/C/themes.xml
index b8cdbf8..f0eef85 100644
--- a/gnome2-accessibility-guide/C/themes.xml
+++ b/gnome2-accessibility-guide/C/themes.xml
@@ -1,37 +1,37 @@
-<?xml version="1.0" encoding="utf-8"?>
<chapter id="themes-0">
<title>Customizing the Appearance of the Desktop</title>
<para>This chapter describes the methods you can use to change the appearance
-of the Desktop to enhance accessibility for users with
-visual impairments.</para>
+of the GNOME Desktop
+to enhance the accessibility of the desktop for users with visual impairments.</para>
<sect1 id="themes-1">
<title>Customization Options</title>
<para>There are a number of methods to enable you to customize the appearance
-of the Desktop to suit your specific needs, as follows:</para>
+of the GNOME Desktop
+to suit your specific needs, as follows:</para>
<variablelist>
<varlistentry>
<term>Themes</term>
<listitem>
<para>Themes are the most effective
-way to change the appearance of the Desktop in a consistent manner. See <xref linkend="themes-2"/> for more information about themes and how to use themes
-to achieve the type of Desktop that you require.</para>
+way to change the appearance of the desktop in a consistent manner. See <xref linkend="themes-2"/> for more information about themes and how to use themes
+to achieve the type of desktop environment that you require.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Desktop and application-specific configuration settings</term>
<listitem>
- <para>You can customize different components of the Desktop
+ <para>You can customize different components of the desktop
individually to achieve the display settings that you require. You can configure
-the Desktop and applications in addition to using themes or as an alternative
+the desktop and applications in addition to using themes or as an alternative
to using themes. See <xref linkend="themes-7"/> for more information.</para>
</listitem>
</varlistentry>
</variablelist>
<para>The following table summarizes the changes that you can
-make to the Desktop and where you can make the changes. This manual does not
-provide detailed instructions about how to customize the Desktop. For detailed
-instructions about how to use the customization tools that the Desktop provides,
-refer to the online help for each tool or to the <citetitle>GNOME 2.4 Desktop User Guide</citetitle>.</para>
+make to the GNOME Desktop and where you can make the changes. This manual does not provide
+detailed instructions about how to customize the desktop. For detailed instructions
+about how to use the customization tools that the desktop provides, refer
+to the online help for each tool or to the <citetitle>GNOME 2.8 Desktop User Guide</citetitle>.</para>
<table frame="topbot" id="themes-TBL-1">
<title>Quick Reference to Customizing the Appearance of the Desktop</title>
<tgroup cols="2" colsep="0" rowsep="0">
@@ -50,7 +50,7 @@ refer to the online help for each tool or to the <citetitle>GNOME 2.4 Desktop Us
<tbody>
<row>
<entry valign="top">
- <para>Overall appearance of the Desktop to use high
+ <para>Overall appearance of the desktop to use high
contrast colors, low contrast colors, or large print.</para>
</entry>
<entry valign="top">
@@ -62,17 +62,17 @@ contrast colors, low contrast colors, or large print.</para>
<para>Appearance of the desktop background only.</para>
</entry>
<entry valign="top">
- <para>The <application>Background</application>
-preference tool and the <application>Nautilus</application> file manager <guilabel>Backgrounds and Emblems</guilabel> menu item.</para>
+ <para>The <application>Desktop Background</application> preference tool and the <application>Nautilus</application>
+file manager <guilabel>Backgrounds and Emblems</guilabel> menu item.</para>
</entry>
</row>
<row>
<entry valign="top">
- <para>Font displayed on the Desktop and
-in all Desktop applications.</para>
+ <para>Font displayed on the desktop background and
+in all desktop applications.</para>
</entry>
<entry valign="top">
- <para>The <application>Font</application> preference tool.</para>
+ <para>The <application>Fonts</application> preference tool.</para>
</entry>
</row>
<row>
@@ -101,17 +101,17 @@ tabs in the <application>Nautilus</application> file manager application.</para>
<sect1 id="themes-2">
<title>Using Themes to Customize the Desktop</title>
<para>This section describes how to use themes to customize the appearance
-of the Desktop.</para>
+of the GNOME Desktop.</para>
<sect2 id="themes-3">
<title>Introduction to Themes</title>
- <para>You can use themes to modify and control the appearance of the Desktop
+ <para>You can use themes to modify and control the appearance of the desktop
in a consistent manner. A theme is a group of coordinated settings that specifies
-how a Desktop component or a group of Desktop components appears. When you
-apply a theme, the system modifies many Desktop components simultaneously
+how a desktop component or a group of desktop components appears. When you
+apply a theme, the system modifies many desktop components simultaneously
to achieve the desired effect. For example, if you apply a theme that increases
-the font size across the Desktop, the theme also modifies the size of panels
-and icons on the Desktop for optimum compatibility with the font size. </para>
- <para>The following types of themes affect different parts of the Desktop: </para>
+the font size across the desktop, the theme also modifies the size of panels
+and icons on the desktop for optimum compatibility with the font size. </para>
+ <para>The following types of themes affect different parts of the desktop: </para>
<variablelist>
<varlistentry>
<term>Desktop themes</term>
@@ -120,7 +120,7 @@ and icons on the Desktop for optimum compatibility with the font size. </para>
the visual appearance of all windows, applications, dialogs, panels, and applets.
Desktop themes also determine the visual appearance of the GNOME-compliant
interface items that appear on windows, panels, and applets, such as menus,
-icons, and buttons. Some of the Desktop themes that are available in the Desktop
+icons, and buttons. Some of the desktop themes that are available in the Desktop
are designed for special accessibility needs.</para>
</listitem>
</varlistentry>
@@ -136,12 +136,13 @@ themes determine the appearance of the frames around windows only.</para>
<sect2 id="themes-4">
<title>To Choose a Desktop Theme</title>
<para>To open the <application>Theme</application> preference tool and view
-the Desktop 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. Click on the <guilabel>Widget Theme</guilabel> tab to
-display the Desktop themes that are available. To choose a new theme for the
-Desktop, click on a theme in the <guilabel>Widget Theme</guilabel> list box.
-The system automatically applies the theme to the Desktop. </para>
- <para>There are several Desktop themes available that suit different accessibility
+the desktop 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 most popular desktop themes are listed on the left side of the <guilabel>Theme Preferences</guilabel>dialog. To choose a new theme for the desktop,
+click on a theme in the list box. The system automatically applies the theme
+to the desktop. The view a longer list of desktop themes, click on the <guibutton>Theme Details</guibutton> button. The desktop themes are displayed in the <guilabel>Controls</guilabel> tabbed section of the <guilabel>Theme Details</guilabel>
+dialog. There are several desktop themes available that suit different accessibility
needs. These themes are described in the following table:</para>
<table frame="topbot" id="themes-TBL-2">
<title>Desktop Themes Designed for Accessibility Requirements</title>
@@ -200,7 +201,7 @@ the background and foreground text. </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>
+The background and foreground colors are the same as those specified by the <guilabel>Default</guilabel> desktop theme.</para>
</entry>
</row>
<row>
@@ -244,27 +245,68 @@ font size to 18pt. </para>
<sect2 id="themes-5">
<title>To Choose a Window Frame Theme</title>
<para>To open the <application>Theme</application> preference tool and view
-the window frame 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. Click on the <guilabel>Window Frames</guilabel> tab to
-display the window frame themes that are available. The <guilabel>Atlanta</guilabel> theme is an accessible theme. </para>
+the window frame themes that are available, perform the following steps: </para>
+ <orderedlist>
+ <listitem>
+ <para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Theme</guimenuitem></menuchoice>.
+The <guilabel>Theme Preferences</guilabel> dialog is displayed.</para>
+ </listitem>
+ <listitem>
+ <para>Click on the <guibutton>Theme Details</guibutton> button.
+The <guilabel>Theme Details</guilabel> dialog is displayed.</para>
+ </listitem>
+ <listitem>
+ <para>Click on the <guilabel>Window Border</guilabel> tab to display
+the window frame themes that are available. The <guilabel>Atlanta</guilabel>
+theme is an accessible theme. </para>
+ </listitem>
+ <listitem>
+ <para>To choose a window frame theme, select a theme from the list
+box, then click <guibutton>Close</guibutton>. </para>
+ </listitem>
+ </orderedlist>
+ </sect2>
+ <sect2 id="themes-19">
+ <title>To Choose an Icon Theme</title>
+ <para>To open the <application>Theme</application> preference tool and view
+the icon themes that are available, perform the following steps: </para>
+ <orderedlist>
+ <listitem>
+ <para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Theme</guimenuitem></menuchoice>.
+The <guilabel>Theme Preferences</guilabel> dialog is displayed.</para>
+ </listitem>
+ <listitem>
+ <para>Click on the <guibutton>Theme Details</guibutton> button.
+The <guilabel>Theme Details</guilabel> dialog is displayed.</para>
+ </listitem>
+ <listitem>
+ <para>Click on the <guilabel>Icons</guilabel> tab to display the
+icon themes that are available. </para>
+ </listitem>
+ <listitem>
+ <para>To choose an icon theme, select a theme from the list box,
+then click <guibutton>Close</guibutton>. </para>
+ </listitem>
+ </orderedlist>
</sect2>
<sect2 id="themes-6">
<title>To Create Your Own Themes</title>
- <para>For information about how to create your own Desktop themes and window
-frame themes, see the <citetitle>GNOME 2.4 Desktop System Administration Guide</citetitle>. </para>
+ <para>For information about how to create your own desktop themes and window
+frame themes, see the <citetitle>GNOME 2.8 Desktop System Administration Guide</citetitle>. </para>
</sect2>
</sect1>
<sect1 id="themes-7">
<title>Customizing Specific Components of the Desktop</title>
- <para>This section describes how to customize specific components of the Desktop
+ <para>This section describes how to customize specific components of the desktop
individually.</para>
<sect2 id="themes-8">
<title>To Customize the Desktop Background</title>
- <para>The Desktop themes do not affect the desktop background. Therefore to
-modify the desktop background to complement your Desktop, you must customize
-the desktop background separately using the <application>Background</application>
-preference tool. To start the <application>Background</application> preference
-tool, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Background</guimenuitem></menuchoice>.</para>
+ <para>The desktop themes do not affect the desktop background. Therefore to
+modify the desktop background to complement your desktop, you must customize
+the desktop background separately using the <application>Desktop Background</application> preference tool. To start the <application>Desktop Background</application> preference tool,choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Desktop Background</guimenuitem></menuchoice>.</para>
</sect2>
<sect2 id="themes-9">
<title>To Customize Desktop Background Objects</title>
@@ -273,10 +315,10 @@ controlled by the <application>Nautilus</application> file manager. To change
the size of the icons, perform the following steps:</para>
<orderedlist>
<listitem>
- <para>Start the <application>Nautilus</application> file manager.</para>
+ <para>Start the file manager.</para>
</listitem>
<listitem>
- <para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences.</guimenuitem></menuchoice>.</para>
+ <para>Choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem></menuchoice>.</para>
</listitem>
<listitem>
<para>Select the <guilabel>Views</guilabel> tabbed section.</para>
@@ -290,16 +332,16 @@ drop-down list.</para>
</sect2>
<sect2 id="themes-10">
<title>To Customize Fonts</title>
- <para>This section describes how to customize the font settings for the Desktop
+ <para>This section describes how to customize the font settings for the desktop
and frequently-used applications.</para>
<para>If you have difficulty with the default font type and font size that
-is used on the Desktop and desktop background, you can customize the font
+is used on the desktop and desktop background, you can customize the font
settings to suit your needs. </para>
- <para>You can specify individual font settings for the following Desktop components
+ <para>You can specify individual font settings for the following desktop components
and applications: </para>
<itemizedlist>
<listitem>
- <para>Entire Desktop excluding the desktop background</para>
+ <para>Entire desktop excluding the desktop background</para>
</listitem>
<listitem>
<para>Desktop background only</para>
@@ -319,8 +361,10 @@ and applications: </para>
<sect3 id="themes-11">
<title>To Customize the Desktop Fonts</title>
<para>The <application>Font</application> preference tool allows you to specify
-the default fonts for the Desktop. </para>
- <para>To start the <application>Font</application> preference tool, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>Font</guimenuitem></menuchoice>. The <guilabel>Font Preferences</guilabel> dialog contains the following options: </para>
+the default fonts for the desktop. </para>
+ <para>To start the <application>Font</application> preference tool, choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Desktop
+Preferences</guisubmenu><guimenuitem>Font</guimenuitem></menuchoice>.
+The <guilabel>Font Preferences</guilabel> dialog contains the following options: </para>
<variablelist>
<varlistentry>
<term>
@@ -328,7 +372,7 @@ the default fonts for the Desktop. </para>
</term>
<listitem>
<para>Click on this button to select a default font to use for the text that
-is displayed on the Desktop, including the text displayed on the windows and
+is displayed on the desktop, including the text displayed on the windows and
dialogs associated with GNOME-compliant applications and applets.</para>
<note>
<para>If you use the <application>Theme</application> preference tool
@@ -433,31 +477,31 @@ menu items:</para>
<sect1 id="themes-15">
<title>Meeting Specific Accessibility Needs</title>
<para>The following sections summarize the steps you need to take to improve
-the accessibility of the Desktop in a particular area. </para>
+the accessibility of the desktop in a particular area. </para>
<sect2 id="themes-16">
<title>To Achieve a High or Low Contrast Desktop</title>
- <para>To achieve a high or low contrast Desktop, perform the following steps:</para>
+ <para>To achieve a high or low contrast desktop, perform the following steps:</para>
<orderedlist>
<listitem>
<para>Use the <application>Theme</application> preference tool to
-select the high contrast or low contrast Desktop theme that you require.</para>
+select the high contrast or low contrast desktop theme that you require.</para>
</listitem>
<listitem>
<para>Use the <application>Theme</application> preference tool to
select a window frame theme. You should select the <guilabel>Atlanta</guilabel>
-window frame theme for use with high contrast Desktop themes. The <guilabel>Atlanta</guilabel> window frame theme may also improve readability for some
+window frame theme for use with high contrast desktop themes. The <guilabel>Atlanta</guilabel> window frame theme may also improve readability for some
users. However, you can choose the window frame theme that best suits your
needs. </para>
</listitem>
<listitem>
- <para>Use the <application>Background</application> preference tool
-to customize your desktop background as follows:</para>
+ <para>Use the <application>Desktop Background</application> preference
+tool to customize your desktop background as follows:</para>
<itemizedlist>
<listitem>
- <para>Set the <guilabel>Picture Options</guilabel> to <guilabel>No Picture</guilabel>.</para>
+ <para>Set the <guilabel>Desktop Wallpaper</guilabel> to <guilabel>No Wallpaper</guilabel>.</para>
</listitem>
<listitem>
- <para>Set the <guilabel>Background Style</guilabel> to <guilabel>Solid color</guilabel>.</para>
+ <para>Set the <guilabel>Desktop Colors</guilabel> to <guilabel>Solid Color</guilabel>.</para>
</listitem>
<listitem>
<para>Select a background color that suits your needs.</para>
@@ -467,18 +511,19 @@ to customize your desktop background as follows:</para>
<listitem>
<para>In the <application>Terminal</application> application, ensure
that the <guilabel>Use colors from system theme</guilabel> option is selected
-in the <guilabel>Edit Profile</guilabel> dialog.</para>
+in the <guilabel>Colors</guilabel> tabbed section of the <guilabel>Editing
+Profile</guilabel> dialog.</para>
</listitem>
<listitem>
<para>In the <application>gedit</application> application, ensure
that the <guilabel>Use default theme colors</guilabel> option is selected
-in the <guilabel>Preferences</guilabel> dialog.</para>
+in the <guilabel>Fonts &amp; Colors</guilabel> tabbed section of the <guilabel>Preferences</guilabel> dialog.</para>
</listitem>
</orderedlist>
</sect2>
<sect2 id="themes-17">
<title>To Achieve a Large Print Desktop</title>
- <para>To achieve a large print Desktop, perform the following steps:</para>
+ <para>To achieve a large print desktop, perform the following steps:</para>
<orderedlist>
<listitem>
<para>Use the <application>Theme</application> preference tool to
@@ -487,16 +532,16 @@ select the large print theme that you require.</para>
<listitem>
<para>Use the <application>Theme</application> preference tool to
select a window frame theme. You can use the <guilabel>Crux</guilabel>, <guilabel>Atlanta</guilabel>, or <guilabel>Bright</guilabel> window frame themes with
-large print Desktop themes, depending on the contrast level that you prefer.</para>
+large print desktop themes, depending on the contrast level that you prefer.</para>
</listitem>
<listitem>
<para>Use the <application>Font</application> preference tool to
increase the font that is displayed on desktop background objects.</para>
</listitem>
<listitem>
- <para>Increase the font size that is used to display
-the contents of the <application>Terminal</application> application window.
-See <xref linkend="themes-12"/> for more information.</para>
+ <para>Increase the font size that is used to display the contents
+of the <application>Terminal</application> application window. See <xref linkend="themes-12"/>
+for more information.</para>
</listitem>
<listitem>
<para>If the <guilabel>Use default theme font</guilabel> option
diff --git a/gnome2-accessibility-guide/C/troubleshooting.xml b/gnome2-accessibility-guide/C/troubleshooting.xml
new file mode 100644
index 0000000..7b415dd
--- /dev/null
+++ b/gnome2-accessibility-guide/C/troubleshooting.xml
@@ -0,0 +1,437 @@
+
+ <appendix id="troubleshooting-0">
+ <title>Before You Use the Assistive Technologies</title>
+ <sect1 id="troubleshooting-21">
+ <title>System Administrator Tasks</title>
+ <sect2 id="troubleshooting-27">
+ <title>Configuring the Desktop for Accessible Login</title>
+ <para>The Java Desktop System Release 3 includes an Accessible Login feature.
+The feature allows users to log in to their desktop session even if they cannot
+easily use the screen, mouse, or keyboard in the usual way. This feature allows
+the user to launch assistive technologies at login time by means of special
+gestures from the standard keyboard and from a keyboard, pointing device,
+or switch device attached to the USB or PS/2 mouse port. The feature also
+allows the user to change the visual appearance of the login dialog before
+the user logs in, for instance to use a higher-contrast color scheme for better
+visibility. </para>
+ <para>To enable Accessible Login, the system administrator must perform the
+following steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Configure the desktop to use the GNOME Display Manager (GDM)
+as the login manager. See <xref linkend="troubleshooting-34"/> for more information.</para>
+ </listitem>
+ <listitem>
+ <para>Make some configuration changes to GDM. The system administrator
+can make these changes by manually modifying the following three human-readable
+configuration files as described in <xref linkend="troubleshooting-28"/> and <xref linkend="troubleshooting-29"/>:</para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <filename>/etc/X11/gdm/gdm.conf</filename>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>/etc/X11/gdm/modules/AccessKeyMouseEvents</filename>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>/etc/X11/gdm/modules/AccessDwellMouseEvents</filename>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </orderedlist>
+ <sect3 id="troubleshooting-34">
+ <title>To Use GDM as the Login Manager</title>
+ <para>To configure the desktop to use GDM as the login manager, perform the
+following steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Log in as the <literal>root</literal> user.</para>
+ </listitem>
+ <listitem>
+ <para>Enter the following command to stop the <application>dtlogin</application> manager:</para>
+ <para>
+ <command>/usr/dt/bin/dtconfig -d</command>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Edit the <filename>/etc/inittab</filename> file as follows:</para>
+ <para>
+ <command>co:234:respawn:/usr/lib/saf/ttymon -g -h -p &quot;`uname -n` console
+&gt; login: &quot; -T sun -d</command>
+ </para>
+ <para>
+ <command>/dev/console -l console -m ldterm,ttcompat &gt; co:234:wait:/opt/jds/bin/gdm</command>
+ </para>
+ <para>This comments out the line to start ttymon and adds a line to start
+GDM.</para>
+ </listitem>
+ <listitem>
+ <para>Enter the following commands to create a <filename>/var/lib/gdm</filename> directory:</para>
+ <para>
+ <command>mkdir -p /var/lib/gdm</command>
+ </para>
+ <para>
+ <command>chown gdm:gdm /var/lib/gdm</command>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Reboot your system.</para>
+ </listitem>
+ </orderedlist>
+ </sect3>
+ <sect3 id="troubleshooting-28">
+ <title>To Edit the GDM Configuration File</title>
+ <orderedlist>
+ <listitem>
+ <para>Log in as the <literal>root</literal> user.</para>
+ </listitem>
+ <listitem>
+ <para>Edit the file <filename>/etc/X11/gdm/gdm.conf</filename>.</para>
+ </listitem>
+ <listitem>
+ <para>Search the file for the following line: </para>
+ <para>
+ <literal>#Greeter=/usr/bin/gdmgreeter</literal>
+ </para>
+ <para>and replace the line with the following:</para>
+ <para>
+ <literal>Greeter=/usr/bin/gdmlogin</literal>
+ </para>
+ <para>This step enables a standard login greeting rather than a graphical
+login greeting.</para>
+ </listitem>
+ <listitem>
+ <para>Search the file for the following line: </para>
+ <para>
+ <literal>#AddGtkModules=false</literal>
+ </para>
+ <para>and replace the line with the following:</para>
+ <para>
+ <literal>AddGtkModules=true</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Search the file for the following line: </para>
+ <para>
+ <literal>#GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener</literal>
+ </para>
+ <para>and remove the <literal>#</literal> from the start of the line so that
+the line reads:</para>
+ <para>
+ <literal>GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener</literal>
+ </para>
+ <note>
+ <para>The above lines must be displayed as single lines in the <filename>gdm.conf</filename> file without line breaks. The formatting of this guide
+may display the lines over two lines.</para>
+ </note>
+ <para>This step and previous step enable the use of assistive technologies
+such as the Onscreen Keyboard, Screen Reader, and Magnifier.</para>
+ <note>
+ <para>System administrators may wish to load only the minimum subset
+of these modules which is required to support their user base. Depending
+on your end-user needs, not all of the above GtkModules may need to be loaded.
+ If your end-users need the integrated Screen Reader and Magnifier, you must
+include <literal>gail</literal> and <literal>atk-bridge</literal>. If your
+users need to use a pointing device without buttons or switches, include <literal>dwellmouselistener</literal>. If some of your users use pointing devices
+with switches, alternative physical keyboards, or switch/button devices, include <literal>keymouselistener</literal>. Including all four modules is suitable for most
+system configurations. The Onscreen Keyboard can operate without <literal>gail</literal> and <literal>atk-bridge</literal>, but with a reduced feature
+set. For optimum accessibility we recommend including <literal>gail</literal>
+and <literal>atk-bridge</literal>.</para>
+ </note>
+ </listitem>
+ <listitem>
+ <para>To allow users to change the color and contrast scheme of
+the login dialog, include the following line in the file: </para>
+ <para>
+ <literal>AllowThemeChange=true</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>To restrict user changes to the visual appearance to a subset
+of the available themes, you can add a line similar to the following: </para>
+ <para>
+ <literal>GtkThemesToAllow=blueprint,HighContrast,HighContrastInverse</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Save the <filename>gdm.conf</filename> file.</para>
+ </listitem>
+ </orderedlist>
+ </sect3>
+ <sect3 id="troubleshooting-29">
+ <title>To Use Gestures to Launch Assistive Technologies</title>
+ <para>Once <literal>keymouselistener</literal> and/or <literal>dwellmouselistener</literal> have been added to the GtkModules loaded by GDM, you can assign
+end-user actions to launch specific assistive technologies. These gesture
+associations are contained in the following files, respectively: </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <filename>/etc/X11/gdm/modules/AccessKeyMouseEvents</filename>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <filename>/etc/X11/gdm/modules/AccessDwellMouseEvents</filename>
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>The gesture format is described in the two files. The following section
+demonstrates some suggested examples that have been tested with common usage
+scenarios.</para>
+ <sect4 id="troubleshooting-30">
+ <title>To Launch the Gnopernicus Screen Reader Using a Keyboard Combination</title>
+ <para>In the file <filename>AccessKeyMouseEvents</filename>, the following
+line associates <keycombo><keycap>Control</keycap><keycap>S</keycap></keycombo> held for one second
+with the Screen Reader in &quot;speech and braille&quot; mode: </para>
+ <para>
+ <literal>&lt;Control&gt;s 1 1000 1000 srcore --login --disable-magnifier
+--enable-speech --enable-braille</literal>
+ </para>
+ <para>You can assign similar key combinations to launch the Screen Reader
+in &quot;magnification only&quot; mode, such as:</para>
+ <para>
+ <literal>&lt;Control&gt;m 1 1000 1000 srcore --login --enable-magnifier
+--disable-speech</literal>
+ </para>
+ <note>
+ <para>The above lines must be displayed as single lines in the <filename>AccessKeyMouseEvents</filename> file without line breaks. The formatting of
+this guide may display the lines over two lines.</para>
+ </note>
+ </sect4>
+ <sect4 id="troubleshooting-31">
+ <title>To Launch the Onscreen Keyboard (GOK) Using a Switch or Button Gesture</title>
+ <para>You can use end-user button, key, or switch actions to launch assistive
+technologies. Since the primary input device for many Onscreen Keyboard users
+is a switch or buttons, this is a good way to allow such users to signal their
+need for the Onscreen Keyboard at login time.</para>
+ <para>To reduce the likelihood of launching the application unintentionally,
+you can associate the gestures with multiple switch presses and/or minimum
+durations. For example, the following line in the file <filename>AccessKeyMouseEvents</filename> associates three presses of &quot;Switch 2&quot; for a minimum of 100 milliseconds
+each within 2 seconds, with the launch of the Onscreen Keyboard
+in &quot;inverse scanning&quot; mode:</para>
+ <para>
+ <literal>&lt;Switch2&gt;3 100 2000 gok --login --accessmethod=inversescanning
+--scan-action=switch1 --select-action=switch2</literal>
+ </para>
+ <para>Users of single switches may prefer the 'automatic scanning' access
+method. The following line associates GOK with a prolonged press (&gt; 4 seconds)
+of switch 1 on an alternate access device:</para>
+ <para>
+ <literal>&lt;Switch&gt;1 4000 5000 gok --login --accessmethod=automaticscanning
+--scan-action=switch1 --select-action=switch1</literal>
+ </para>
+ <note>
+ <para>The above lines must be displayed as single lines in the <filename>AccessKeyMouseEvents</filename> file without line breaks. The formatting of
+this guide may display the lines over two lines.</para>
+ </note>
+ </sect4>
+ <sect4 id="troubleshooting-32">
+ <title>To Launch the Onscreen Keyboard (GOK) in Dwell Mode Using a Motion-only
+Gesture</title>
+ <para>You can also define gestures that involve only the motion of a pointing
+device such as the system mouse or an alternative pointing device such as
+a head pointer or trackball. All such gestures are specified by the same
+syntax, that is there is no distinction between a core mouse gesture and motion
+from an alternate input device. </para>
+ <para>Motion gestures are defined as crossing events into and out of the login
+dialog window. If the <literal>dwellmouselistener</literal> GtkModule is
+loaded, alternative pointing devices are temporarily latched to the core pointer
+so that motion from alternative devices results in movement of the onscreen
+pointer.</para>
+ <para>The following gesture can be completed by moving the onscreen pointer,
+ starting from inside the login dialog, across the top edge, back into the
+dialog across the top edge, out of the dialog via the left edge, back into
+the dialog via the left edge, and similarly through bottom and right-hand
+edges of the dialog, in a cross pattern. The gesture launches GOK in Dwell
+mode. 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>
+ <para>
+ <literal>TTLLBBRR O 10000 gok --login --access-method=dwellselection
+--input-device=MOUSE[3]</literal>
+ </para>
+ <note>
+ <para>The above line must be displayed as a single line in the <filename>AccessKeyMouseEvents</filename> file without line breaks. The formatting of
+this guide may display the line over two lines.</para>
+ </note>
+ </sect4>
+ </sect3>
+ <sect3 id="troubleshooting-33">
+ <title>Additional Requirements for Accessible Login</title>
+ <para>To use text-to-speech services at login time, for example when you are
+using the Screen Reader in Speech mode, the GDM user must be a member of the
+&quot;audio&quot; group. You can confirm this by checking the file <filename>/etc/group</filename>. Please see the <citetitle>Java Desktop System Release 3 Administration
+Guide</citetitle> for details about changing group membership.</para>
+ <para>To facilitate Accessible Login using alternative pointing devices and
+end-user switch devices such as sip-and-puff switches, wheelchair-mounted
+switches, trackballs, and so on, you may need to modify your X server system
+configuration to recognize these devices. Most devices which emulate mouse
+buttons, including USB single switches, mouse-like pointing devices, and devices
+that emulate them, can be used with Accessible Login and the Onscreen Keyboard.</para>
+ <para>In the Java Desktop System Release 3, the GDM user has a readable home
+directory. If this setting is removed for security reasons, the Screen Reader
+and Magnifier will not function properly during Accessible Login.</para>
+ <note>
+ <para>Alternate input devices should not be configured to control the
+primary onscreen pointer. This may result in undesirable behavior or cause
+situations from which the user of the alternate input devices cannot recover
+without the use of the primary keyboard or mouse.</para>
+ </note>
+ </sect3>
+ </sect2>
+ <sect2 id="troubleshooting-22">
+ <title>Enabling the Standard Greeter</title>
+ <para>To enable the standard GDM greeter, perform the following steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Log in as the <literal>root</literal> user.</para>
+ </listitem>
+ <listitem>
+ <para>Edit the file <filename>/etc/X11/gdm/gdm.conf</filename>.</para>
+ </listitem>
+ <listitem>
+ <para>Search the file for the following line: </para>
+ <para>
+ <literal>#Greeter=/usr/bin/gdmgreeter</literal>
+ </para>
+ <para>and replace the line with the following:</para>
+ <para>
+ <literal>Greeter=/usr/bin/gdmlogin</literal>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Save the file.</para>
+ </listitem>
+ </orderedlist>
+ </sect2>
+ <sect2 id="troubleshooting-7">
+ <title>Configuring the Java Environment for Accessibility</title>
+ <para>To configure the Java Environment 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>
+ <command>cd jre/lib</command>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Enter the following command:</para>
+ <para>
+ <command>ln -s /usr/share/jar/accessibility.properties</command>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Enter the following command to change to the <filename>ext</filename> directory:</para>
+ <para>
+ <command>cd ext</command>
+ </para>
+ </listitem>
+ <listitem>
+ <para>Execute the following command: </para>
+ <para>
+ <command>ln -s /usr/share/jar/gnome-java-bridge.jar</command>
+ </para>
+ </listitem>
+ </orderedlist>
+ </sect2>
+ <sect2 id="troubleshooting-6">
+ <title>Enabling Full Screen Magnification in Gnopernicus</title>
+ <para>To enable full screen magnification in <application>Gnopernicus</application>,
+perform the following steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Configure two video cards as :0.0 and :0.1.</para>
+ <note>
+ <para>It is not essential that both video cards have the same resolution
+and bit depth. However, if the resolutions and bit depths of both cards differ
+greatly, the apparent magnification factor may differ slightly from the nominal
+magnification factor.</para>
+ </note>
+ </listitem>
+ <listitem>
+ <para>Click <guibutton>Launch</guibutton>, then choose<menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Screen Reader and Magnifier</guimenuitem></menuchoice> to start <application>Gnopernicus</application>.</para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Preferences</guibutton>.</para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Magnifier</guibutton>.</para>
+ </listitem>
+ <listitem>
+ <para>Click on <guibutton>Add/Modify</guibutton>.</para>
+ </listitem>
+ <listitem>
+ <para>Specify :0.0 as the Source for magnification.</para>
+ </listitem>
+ <listitem>
+ <para>Specify :0.1 as the Target for magnification.</para>
+ </listitem>
+ <listitem>
+ <para>Set the Zoomer Placement to be [0,0,1023,767].</para>
+ <note>
+ <para>These instructions assume a video resolution of 1024x768. </para>
+ </note>
+ </listitem>
+ <listitem>
+ <para>Restart <application>Gnopernicus</application>. The magnified
+view is displayed on the second display 0.1.</para>
+ </listitem>
+ </orderedlist>
+ </sect2>
+ </sect1>
+ <sect1 id="troubleshooting-26">
+ <title>User Tasks</title>
+ <sect2 id="troubleshooting-4">
+ <title>Disabling the Screensaver for Gnopernicus Users</title>
+ <para>To disable the screensaver, perform the following steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Click <guibutton>Launch</guibutton>, then choose <menuchoice><guimenu>Preferences</guimenu><guisubmenu>Display</guisubmenu><guimenuitem>Screensaver</guimenuitem></menuchoice>.</para>
+ </listitem>
+ <listitem>
+ <para>In the <guilabel>Display Modes</guilabel> tabbed section,
+deselect the <guilabel>Lock Screen After</guilabel> check box.</para>
+ </listitem>
+ <listitem>
+ <para>In the <guilabel>Mode</guilabel> drop-down list, select <guilabel>Disable Screen Saver</guilabel>.</para>
+ </listitem>
+ <listitem>
+ <para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Restart Daemon</guimenuitem></menuchoice>.</para>
+ </listitem>
+ <listitem>
+ <para>Choose <menuchoice><guimenu>File</guimenu><guimenuitem>Quit</guimenuitem></menuchoice> to close the <guilabel>Screensaver</guilabel>
+dialog.</para>
+ </listitem>
+ </orderedlist>
+ </sect2>
+ <sect2 id="troubleshooting-16">
+ <title>Maximizing GNOME Terminal for GOK Users</title>
+ <para>If you are a <application>GOK</application> user, you cannot use the<application> GNOME Terminal</application> application in Full Screen mode because the <application>GNOME Terminal</application> window obscures the <application>GOK</application>
+display.</para>
+ <para>To resize the <application>GNOME Terminal</application> window for use
+with the <application>GOK</application> application, perform the following
+steps:</para>
+ <orderedlist>
+ <listitem>
+ <para>Do not enable the Full Screen mode in <application>GNOME Terminal</application>.</para>
+ </listitem>
+ <listitem>
+ <para>Give focus to the <application>GNOME Terminal</application>
+window.</para>
+ </listitem>
+ <listitem>
+ <para>Press <keycap>F10</keycap> to maximize the application.</para>
+ </listitem>
+ </orderedlist>
+ </sect2>
+ </sect1>
+ </appendix>