gnome-user-docs r1043 - trunk/gnome2-accessibility-guide/C
- From: wwalker svn gnome org
- To: svn-commits-list gnome org
- Subject: gnome-user-docs r1043 - trunk/gnome2-accessibility-guide/C
- Date: Tue, 9 Dec 2008 21:31:48 +0000 (UTC)
Author: wwalker
Date: Tue Dec 9 21:31:48 2008
New Revision: 1043
URL: http://svn.gnome.org/viewvc/gnome-user-docs?rev=1043&view=rev
Log:
* low-vision.xml: reorganize and update the Orca section.
Modified:
trunk/gnome2-accessibility-guide/C/ChangeLog
trunk/gnome2-accessibility-guide/C/low-vision.xml
Modified: trunk/gnome2-accessibility-guide/C/low-vision.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/low-vision.xml (original)
+++ trunk/gnome2-accessibility-guide/C/low-vision.xml Tue Dec 9 21:31:48 2008
@@ -10,6 +10,11 @@
<itemizedlist>
<listitem>
<para>
+<emphasis>Desktop Appearance Enhancement</emphasis> - users can configure the desktop to be easy to read; for example, by increasing text size and using high-contrast themes.
+</para>
+</listitem>
+<listitem>
+<para>
<emphasis>Screen Magnifier</emphasis> - this is like a magnifying glass. People using them
are able to control what area of the computer screen they want enlarged, and can move the magnifier to view different areas of the screen. They are also known as screen enlargers or large print programs.
</para>
@@ -23,2806 +28,2781 @@
blind access utilities or screen reviewers.
</para>
</listitem>
-<listitem>
+</itemizedlist>
+
+
+<section id="themes-0">
+<title>Desktop Appearance Enhancement</title>
<para>
-<emphasis>Desktop Appearance Enhancement</emphasis> - users can configure the desktop to be easy to read; for example, by increasing text size and using high-contrast themes.
+This chapter describes the methods you can use to change the appearance of the GNOME Desktop in order to enhance the accessibility of the desktop for users with visual
+impairments.
</para>
-</listitem>
-</itemizedlist>
-<section id="ats-2">
-<title>Orca: Screen Reader and Magnifier</title>
-<indexterm>
-<primary>Screen Reader and Magnifier</primary>
-</indexterm>
+<section id="themes-1">
+<title>Customization Options</title>
<indexterm>
-<primary>Orca</primary>
+<primary>customizing the desktop appearance</primary>
</indexterm>
<para>
-The <application>Orca</application> Screen Reader and Magnifier application enables users with limited or no vision to use the GNOME Desktop and associated applications. <application>Orca</application> provides the following functionality:
+There are several ways to customize the appearance of the GNOME Desktop to suit your
+specific needs:
</para>
-<itemizedlist>
+<variablelist>
+<varlistentry>
+<term>Themes</term>
<listitem>
<para>
-Screen Reader
+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 them to achieve the type of desktop environment that you require.
</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Desktop and Application-Specific Configuration Settings
+</term>
+<listitem>
<para>
-The screen reader enables non-visual access to standard applications in the GNOME Desktop by using speech and braille output.
+You can customize different components of the desktop to achieve the display settings that you require. You can configure the desktop and applications in addition to using themes or as an alternative to themes. See <xref linkend="themes-7"/> for more information.
</para>
</listitem>
-<listitem>
+</varlistentry>
+</variablelist>
<para>
-Magnifier
+The following table summarizes the changes that you can make to the GNOME Desktop and where you can make the changes. This guide 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 Help for each tool or to the <ulink type="help" url="ghelp:user-guide?prefs">User Guide</ulink>.
+</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">
+<colspec colname="colspec0" colwidth="50%"/>
+<colspec colname="colspec1" colwidth="50%"/>
+<thead>
+<row rowsep="1">
+<entry valign="top">
+<para>To change the...</para>
+</entry>
+<entry valign="top">
+<para>Use...
</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry valign="top">
<para>
-The magnifier provides automated focus tracking and full-screen magnification to aid low-vision users.
+Overall appearance of the desktop using high-contrast colors, low-contrast colors, or large print.
</para>
-</listitem>
-</itemizedlist>
+</entry>
+<entry valign="top">
+<para>The <guilabel>Theme</guilabel> section of the <application>Appearance</application> preference tool.
+</para>
+</entry>
+</row>
+<row>
+<entry valign="top">
<para>
-The following sections provide information about <application>Orca</application> and how to use it.
+Appearance of the desktop background only.
</para>
-
-<section>
-<title>Introduction to Orca</title>
-<section>
-<title>What is Orca?</title>
+</entry>
+<entry valign="top">
<para>
-Orca is a flexible, extensible, and powerful assistive technology for people with visual impairments. Using various combinations of speech synthesis, braille and magnification, Orca helps provide access to applications
-and toolkits that support the AT-SPI (e.g., the GNOME Desktop). <application>Orca</application> is also free open source software.
+The <guilabel>Desktop Background</guilabel> section of the <application>Appearance</application> preference tool; also the file manager <guilabel>Backgrounds and Emblems</guilabel> menu item.
</para>
-</section>
+</entry>
+</row>
-<section>
-<title>Why the name Orca?</title>
+<row>
+<entry valign="top">
<para>
-One of the first DOS screen readers was Flipper, made by Omnichron Corporation in Berkeley, CA. It was named Flipper in part because the blind wife of the programmer
-envisioned computers as being programmed by flipping switches (an accurate image of a bygone era). Then came another DOS screen reader, this one from Henter-Joyce in
-Florida - "Jobs Access With Speech" (or JAWS). And so on....
+Appearance of the mouse pointer.
</para>
+</entry>
+<entry valign="top">
<para>
-Although no obvious connection exists between blindness and creatures from the sea, there is certainly a naming tradition for screen-reader software. Hence <application>Orca</application>, which is a lot tougher-sounding than Nemo, Ariel, Willy, or Mr. Limpet.
+The <guilabel>Theme</guilabel> section of the <application>Appearance</application> preference tool; use the <guilabel>Pointers</guilabel> tab of the <guilabel>Customize</guilabel> option.
</para>
-</section>
+</entry>
+</row>
-<section>
-<title>What's the schedule?</title>
+<row>
+<entry valign="top">
<para>
-<application>Orca</application> is part of the GNOME platform and <application>Orca</application>'s releases are coupled with the releases of the GNOME platform.
+Font displayed on the desktop background and
+in all desktop applications.
</para>
-</section>
-
-<section>
-<title>How do I request a new feature?</title>
+</entry>
+<entry valign="top">
<para>
-<ulink url="http://bugzilla.gnome.org/buglist.cgi?query=product:orca+";>Bugs</ulink> and feature/enhancement requests (RFEs)
-should be reported to the <ulink url="http://bugzilla.gnome.org";>GNOME Bug Tracking System
-</ulink>. Patches are always welcome, and instructions for creating patches can be found in the <ulink url="http://developer.gnome.org/tools/svn.html";>
-GNOME Introduction to Subversion (SVN)
-</ulink>.
+The <guilabel>Font</guilabel> section of the <application>Appearance</application> preference tool.
</para>
-</section>
-
-<section>
-<title>Where is the discussion list?</title>
+</entry>
+</row>
+<row>
+<entry valign="top">
<para>
-You can get in touch with developers and other users by <ulink url="mailto:orca-list gnome org">sending an e-mail</ulink> to the <ulink url="http://mail.gnome.org/mailman/listinfo/orca-list";>Orca mailing list</ulink>
-(
-<ulink url="http://mail.gnome.org/archives/orca-list";>Archives</ulink>).
+Default font settings of the <application>Text Editor</application>, <application>Terminal</application> or <application>Help</application> application.
</para>
-</section>
-
-<section>
-<title>Is braille supported?</title>
+</entry>
+<entry valign="top">
<para>
-Yes! Braille is supported via BrlTTY and it is tightly integrated with Orca. BrlTTY offers support for nearly every refreshable braille display known to man. Refer to the
-<ulink url="ghelp:orca#braille">braille page
-</ulink> for more information.
+Normally these applications use the default
+application font that is specified in the <guilabel>Font</guilabel> section of the <application>Appearance</application> preference tool, but these font settings can also be overridden in the <guilabel>Preferences</guilabel> dialog for the application.
</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
</section>
-<section>
-<title>Are Grade 2 braille contractions supported?</title>
+<section id="themes-2">
+<title>Using Themes to Customize the Desktop</title>
<para>
-Yes, <application>Orca</application> fully supports contracted braille output.
+This section describes how to use themes to customize the appearance of the GNOME Desktop.
</para>
-</section>
-<section>
-<title>What voices are available?</title>
+<section id="themes-3">
+<title>Introduction to Themes</title>
+<indexterm>
+<primary>themes</primary>
+</indexterm>
<para>
-<application>Orca</application> provides interfaces to both <userinput>gnome-speech</userinput> and <userinput>emacspeak</userinput> speech services. As such, the available voices for <application>Orca</application> are only restricted by the speech engines supported by the available speech services. For free speech engines, you typically have a choice of the eSpeak, Festival, and FreeTTS speech engines. For commercial engines, you have a choice of
-additional engines such as Fonix DECtalk, Loquendo, Eloquence, Cepstral and IBMTTS, with others on the way. Periodically check the <userinput>gnome-speech</userinput> package for more progress in this area.
+A theme is a group of coordinated settings that specifies how a desktop component or a group of desktop components appears. You can use themes to modify and control the appearance of the desktop in a consistent manner. 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. Some themes have suggested font settings that may optionally be auto-set; in addition, most colors within a theme can be customized.
</para>
-</section>
-
-<section>
-<title>What languages are supported?</title>
<para>
-The <ulink url="http://l10n.gnome.org/teams";>
-GNOME translation teams</ulink> are composed of many passionate volunteers from around the world. These teams do a great job and keep an up-to-date status report. See the <ulink url="http://l10n.gnome.org/module/orca";>
-Orca translation status page</ulink> for the large number of languages into which <application>Orca</application> has been translated.
+A theme contains settings that affect different parts of the desktop:
</para>
-<para>
-Note: support for a language also depends on
-the speech synthesis engine also supporting the same language.
+<variablelist>
+<varlistentry>
+<term>Controls</term>
+<listitem>
+<para>
+The controls setting for a theme determines the visual appearance of all windows, applications, panels, and panel applications. The controls setting also determines the visual appearance of the GNOME-compliant interface items that appear on windows, applications, panels, and panel applications such as menus, icons, and buttons. Some of the control options that are available in the desktop are designed for special accessibility needs.
</para>
-</section>
-
-<section>
-<title>How well does magnification work?</title>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Window Border</term>
+<listitem>
<para>
-<application>Orca</application> currently uses the <userinput>gnome-mag</userinput>
-magnification service. <userinput>gnome-mag</userinput> has incorporated support for smoother full-screen magnification, which
-relies upon newer extensions in the X Window System server. These extensions do not always function well on all platforms, so smooth full-screen magnification may not always work.
+The window frame setting determines the appearance of the border around windows only.
</para>
-</section>
-
-<section>
-<title>How is web access coming along?</title>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Icon</term>
+<listitem>
<para>
-<application>Orca</application> targets the <application>Firefox</application> web browser (version 3) for providing accessible web browsing. Both the <application>Orca</application> and <application>Firefox</application> teams are fully dedicated in this cooperative effort.
+The icon setting determines the appearance of icons on panels and on the desktop background.
</para>
-</section>
+</listitem>
+</varlistentry>
+</variablelist>
</section>
-<section id="enable-orca">
-<title>Enabling Orca</title>
-<para>
-For a text-only guided setup, open a Run dialog with <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> or <keycombo><keycap>Meta</keycap><keycap>R</keycap></keycombo> and use the command <userinput>orca --text-setup</userinput> <keycap>Enter</keycap>.
+<section id="themes-4">
+<title>Choosing Themes</title>
+<indexterm>
+<primary>themes</primary>
+<secondary>desktop</secondary>
+</indexterm>
+<para>To choose a theme, perform the following steps:
</para>
+<orderedlist>
+<listitem>
<para>
-The first time <application>Orca</application> is launched you will be asked a few questions:
+Choose <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Appearance
+</guimenuitem></menuchoice>. The themes
+are listed under the <guilabel>Theme</guilabel> tab.
</para>
+</listitem>
+<listitem>
<para>
-First you will be presented with a list of languages to choose from; there are currently about 45 languages supported. Most of this list will scroll off the screen, so you may have to use the terminal's scrollbar to view earlier parts of the list. Type in the number of your language choice (e.g., 7 for American English) and press <keycap>Enter</keycap>.
+Click on a theme in the list box to choose a new theme. The system automatically applies the theme to the desktop, and may also prompt whether to apply a suggested font for the theme.
</para>
<para>
-You are next asked to set <guilabel>Echo By Word</guilabel>. This option instructs <application>Orca</application> to speak words as you finish typing them. Type <keycap>y</keycap> or <keycap>n</keycap> and press <keycap>Enter</keycap>.
+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">
+<colspec colname="colspec0" colwidth="50*"/>
+<colspec colname="colspec1" colwidth="50*"/>
+<thead>
+<row rowsep="1">
+<entry valign="top">
+<para>Theme Name</para>
+</entry>
+<entry valign="top">
+<para>Description</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry valign="top">
<para>
-The next item is <guilabel>Key Echo</guilabel>. This option will speak all keys as they are pressed. Type <keycap>y</keycap> or <keycap>n</keycap> and press <keycap>Enter</keycap>.
+<guilabel>High Contrast</guilabel>
</para>
+</entry>
+<entry valign="top">
<para>
-Now select your desired keyboard layout; generally, you will want to choose the layout that matches your keyboard type - 1 for Desktop or 2 for Laptop. This choice will determine what key will act as the <application>Orca</application> modifier key. The Desktop layout uses <keycap>Insert</keycap> while the Laptop layout uses <keycap>Caps Lock</keycap>. A system, host, shift or modifier key is one which is used in conjunction with other keys, enabling keyboard access to most program functions.
+Provides dark text on a light background using high-contrast colors.
</para>
-<para>
-Next, specify if you require braille output. This functionality assumes a BrlTTY-compatible device is available. Type <keycap>y</keycap> or <keycap>n</keycap> and press <keycap>Enter</keycap>.
+</entry>
+</row>
+<row>
+<entry colname="colspec0" valign="top">
+<para>
+<guilabel>High Contrast Inverse</guilabel>
</para>
+</entry>
+<entry colname="colspec1" valign="top">
<para>
-Lastly, indicate whether you want an on-screen braille output monitor. This is mostly for developers who need to verify BrlTTY output, but may also be useful in other situations, such as visually diagnosing or verifying braille output. Type <keycap>y</keycap> or <keycap>n</keycap> and press <keycap>Enter</keycap>.
+Provides light text on a dark background using high-contrast colors.
</para>
+</entry>
+</row>
+<row>
+<entry colname="colspec0" valign="top">
<para>
-That's it! <application>Orca</application> is now ready for use. If accessibility was not yet enabled, <application>Orca</application> does so now and asks you to logout and back in for the services to start. Type <keycap>y</keycap> and press <keycap>Enter</keycap> to restart your login session.
+<guilabel>Large Print</guilabel>
</para>
+</entry>
+<entry colname="colspec1" valign="top">
<para>
-After completing the first-time <application>Orca</application> settings, use <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> or <keycombo><keycap>Meta</keycap><keycap>R</keycap></keycombo> to bring up the Run dialog, type in <literal>orca</literal> and press <keycap>Enter</keycap>. Accessibility functions should now be active.
+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>
+<row>
+<entry colname="colspec0" valign="top">
<para>
-If you plan to use the Magnifier portion of <application>Orca</application>, verify the following:
+<guilabel>High Contrast Large Print</guilabel>
</para>
+</entry>
+<entry colname="colspec1" valign="top">
<para>
-Confirm the <application>Xserver</application> extension is enabled; for OpenSolaris, use <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> or <keycombo><keycap>Meta</keycap><keycap>R</keycap></keycombo> to bring up the Run dialog, type in <literal>xdpyinfo</literal> and press <keycap>Enter</keycap>.
+This theme suggests an increased font size of 18pt using dark text on a light background. To apply the suggested font, click on the <guibutton>Apply Font</guibutton> button.
</para>
-</section>
-
-<section>
-<title>Using Orca</title>
-<section>
-<title>Initial Setup</title>
+</entry>
+</row>
+<row>
+<entry colname="colspec0" valign="top">
<para>
-When you run <application>Orca</application> for the first time, it will automatically enter setup mode. If you want to run setup
-at some later point, you can pass the
-<userinput>--setup</userinput> option to <application>Orca</application> the next
-time you run it. Furthermore, while <application>Orca</application> is running,
-you can press <keycombo><keycap>Insert</keycap><keycap>Space</keycap></keycombo> to bring up the <application>Orca</application> setup window. Finally, <application>Orca</application> provides a text setup utility that you can start by passing the
-<userinput>--text-setup</userinput> option to <application>Orca</application>. All of these options will create a <userinput>~/.orca/user-settings.py</userinput> file that holds your preferences and will also enable the accessibility infrastructure. You need to log out and log back in for the new settings to take effect.
+<guilabel>High Contrast Large Print Inverse</guilabel>
</para>
-</section>
-
-<section>
-<title>How do I run Orca?</title>
+</entry>
+<entry colname="colspec1" valign="top">
<para>
-Run <application>Orca</application> by typing <userinput>orca</userinput> in a terminal session window. You can do so from a virtual
-console window if you do not yet have access to the GUI. With the GUI installed you can also press <keycombo><keycap>Alt</keycap>
-<keycap>F2</keycap></keycombo> or <keycombo><keycap>Meta</keycap>
-<keycap>R</keycap></keycombo> to bring up the Run dialog and then enter <userinput>orca</userinput> as the command (followed by any optional parameters). <application>Orca</application> will automatically enter text setup mode if you run it from a virtual console window or your GUI environment is not yet set up for accessibility.
+This theme suggests an increased font size of 18pt using light text on a dark background. To apply the suggested font, click on the <guibutton>Apply Font</guibutton> button.
+</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
+</listitem>
+</orderedlist>
+<para>
+In some GNOME distributions there are also prebuilt low-contrast/low-contrast-large-print themes to complement the high-contrast theme set.
+</para>
+<para>
+To view the controls, window frame, and icon settings that are associated with a theme, select a theme in the <guilabel>Appearance </guilabel> preference tool, then click on the <guibutton>Theme</guibutton> tab. The <guilabel>Customize</guilabel> option contains a tabbed section for each setting category. Each tabbed section lists the options that are available and the current setting for the theme is highlighted.
</para>
</section>
-<section>
-<title>Quitting Orca</title>
+<section id="themes-20">
+<title>Modifying the Controls Setting for a Theme</title>
<para>
-To quit <application>Orca</application>, press <keycombo><keycap>Insert</keycap>
-<keycap>Q</keycap></keycombo>. A confirmation dialog will appear. Select <guilabel>Yes</guilabel> to quit. If the system seems unresponsive, you can try a few things:
+To modify the controls setting that is associated with a theme, perform the following steps:
</para>
-<itemizedlist>
+<orderedlist>
<listitem>
<para>
-Run <userinput>orca --quit</userinput> from a terminal window, such as a virtual console; press <keycombo><keycap>Ctrl</keycap>
-<keycap>Alt</keycap><keycap>F1</keycap>
-</keycombo> (on most Linux platforms) to get to a virtual console, enter your commands, and then use <keycombo><keycap>Alt</keycap>
-<keycap>F7</keycap></keycombo> to get back to the desktop. This will kill the <application>Orca</application> process and reclaim system resources. You can then
-rerun <application>Orca</application> using the previously outlined methods.
+Within the <guilabel>Theme</guilabel> tab, select the theme that you want to modify.
</para>
+</listitem>
+<listitem>
<para>
-Press <keycombo><keycap>Ctrl</keycap>
-<keycap>Alt</keycap><keycap>Backspace</keycap>
-</keycombo> to end your login session and get back to the graphical login prompt (not implemented in all Linux distributions).
+Click on the <guibutton>Customize</guibutton> button. The <guilabel>Customize Theme</guilabel> dialog is displayed.
</para>
</listitem>
-</itemizedlist>
-</section>
-</section>
-
-<section>
-<title>Orca Configuration GUI</title>
+<listitem>
<para>
-The <application>Orca</application> Configuration GUI allows you to customize the behavior and features of <application>Orca</application>, such as speech, braille, and magnification. For example, you can select which speech synthesis engine you want to use, whether braille is enabled or not, and which magnification preferences you want. You can select which general keyboard layout you want (desktop or laptop) and you can also examine and modify the existing keyboard layout with fine-grained control. To bring up the <application>Orca</application> Configuration GUI, press <keycombo><keycap>ORCA_MODIFIER</keycap><keycap>Space</keycap></keycombo>, where ORCA_MODIFIER is <keycap>Insert</keycap> when you use the desktop key bindings and <keycap>Caps_Lock</keycap> when you use the laptop key bindings. See also the [[Orca/AppSpecificSettings| Application Specific Settings]] page for how to set settings specific to a single application.
+Click on the <guilabel>Controls</guilabel> tab to display the controls options that are available.
</para>
+</listitem>
+<listitem>
<para>
-The <application>Orca</application> Configuration GUI is a dialog containing several tabbed pages, each of which is described in the following sections.
+Select the controls option that you want to associate with the current theme from the list box, then click <guibutton>Close</guibutton>. The following table lists the controls options that are suitable for accessibility needs:
</para>
-
-<section>
-<title>General Page</title>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/General_Tab.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - General Page
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
+</listitem>
+</orderedlist>
+<table frame="topbot">
+<title>Controls Options Designed for Accessibility Requirements
+</title>
+<tgroup cols="2" colsep="0" rowsep="0">
+<colspec colname="colspec0" colwidth="50*"/>
+<colspec colname="colspec1" colwidth="50*"/>
+<thead>
+<row rowsep="1">
+<entry valign="top">
+<para>Control Option</para>
+</entry>
+<entry valign="top">
+<para>Description</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry valign="top">
<para>
-The <guilabel>General</guilabel> page allows you to customize general aspects of <application>Orca</application>. These include the following:
+<guilabel>HighContrast</guilabel>
</para>
-
-<section>
-<title>Keyboard Layout</title>
+</entry>
+<entry valign="top">
<para>
-The keyboard layout section allows you to specify if you will be working on a laptop (small) or desktop (large, with a numeric keypad) keyboard. You select which layout you want by selecting one of the following options:
+Provides dark text on a light background using high-contrast colors.
</para>
+</entry>
+</row>
+<row>
+<entry colname="colspec0" valign="top">
<para>
-<emphasis>Desktop</emphasis> - if selected, the Desktop Keyboard Layout (link kb table) will be used.
+<guilabel>HighContrastInverse</guilabel>
</para>
+</entry>
+<entry colname="colspec1" valign="top">
<para>
-<emphasis>Laptop</emphasis> - if selected, the Laptop Keyboard Layout (link kb table) will be used.
+Provides light text on a dark background using high-contrast colors.
</para>
-</section>
-
-<section>
-<title>Show Orca main window</title>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/MainWindow.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - Main window
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
+</entry>
+</row>
+<row>
+<entry colname="colspec0" valign="top">
<para>
-The <application>Orca</application> main window provides you with a graphical way to display the <application>Orca</application> Configuration GUI (also accessible with <keycombo><keycap>ORCA_MODIFIER</keycap><keycap>Space</keycap></keycombo>, where ORCA_MODIFIER is <keycap>Insert</keycap> when you use the desktop key bindings and <keycap>Caps_Lock</keycap> when you use the laptop key bindings). The main window also provides a <guibutton>Quit</guibutton> option, also available with <keycombo><keycap>ORCA_MODIFIER</keycap><keycap>Q</keycap></keycombo>). Many users do not like the <application>Orca</application> main window because it shows up in the window manager's tab order when you press <keycombo><keycap>Alt</keycap><keycap>Tab</keycap></keycombo> to switch windows. By deselecting the "Show Orca main window" button, you can tell <application>Orca</application> to not show the <application>Orca</application> main window.
+<guilabel>LargePrint</guilabel>
</para>
-</section>
-
-<section>
-<title>Quit Orca without Confirmation</title>
+</entry>
+<entry colname="colspec1" valign="top">
<para>
-Normally, when you press <keycombo><keycap>ORCA_MODIFIER</keycap><keycap>Q</keycap></keycombo> to quit <application>Orca</application> or press the <guibutton>Quit</guibutton> button in the <application>Orca</application> main window, <application>Orca</application> will pop up a confirmation dialog asking you if you want to quit. Unchecking this option prevents the confirmation window from appearing.
+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>
-</section>
-
-<section>
-<title>Disable gksu keyboard grab</title>
+</entry>
+</row>
+<row>
+<entry valign="top">
<para>
-When running commands from the launch menu, many distributions use an application known as <application>gksu</application> to authorize the user to run these commands; <application>gksu</application> is the GUI that asks you for your password. When it runs, <application>gksu</application> enables what is known as a "keyboard grab," which is a feature to prevent keyboard actions from going to any other application on the desktop, including <application>Orca</application>. The result of a keyboard grab is that <application>Orca</application> will not receive any keyboard events, preventing <application>Orca</application> from functioning normally.
+<guilabel>HighContrastLargePrint</guilabel>
</para>
+</entry>
+<entry valign="top">
<para>
-By selecting the "Disable gksu keyboard grab" button, you will turn off the keyboard grab behavior, allowing <application>Orca</application> to function normally with system administration applications.
+Provides dark text on a light background using high-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>
-<note>
+</entry>
+</row>
+<row>
+<entry valign="top">
<para>
-The keyboard grab is a security attempt by <application>gksu</application> to prevent nefarious applications from "sniffing" the keyboard and grabbing secret information. Please be advised that disabling the gksu keyboard grab feature can expose you to such nefarious behavior. If you do not feel comfortable with this, you can always use the root account for system administration purposes. To do so, you need to enable the root account for login, and then logout and log back in as root whenever you want to perform a system administration command.
+<guilabel>HighContrastLargePrintInverse</guilabel>
</para>
-</note>
-</section>
-
-<section>
-<title>Present tooltips</title>
+</entry>
+<entry valign="top">
<para>
-When checked, this option will tell <application>Orca</application> to present information about tooltips when they appear as the result of mouse hovering. Specific actions to force tooltips to appear, such as pressing <keycombo><keycap>Ctrl</keycap><keycap>F1</keycap></keycombo> when an object has focus, will always result in tooltips being presented, regardless of this setting.
+Provides light text on a dark background using high-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>
+</tbody>
+</tgroup>
+</table>
</section>
-<section>
-<title>Speak object under mouse</title>
+<section id="themes-5">
+<title>Modifying the Window Border Setting for a Theme
+</title>
+<indexterm>
+<primary>themes</primary>
+<secondary>window border</secondary>
+</indexterm>
<para>
-When checked, this option will tell <application>Orca</application> to present information about the object under the mouse when you move it around the screen. Note that this can cause <application>Firefox</application> and <application>Thunderbird</application> versions 2.x and earlier to crash; this is not a problem with <application>Firefox</application> and <application>Thunderbird</application> versions 3.x and later.
+To modify the window border setting that is associated with a theme, perform the following steps:
</para>
-</section>
-
-<section>
-<title>Start Orca when you login</title>
+<orderedlist>
+<listitem>
<para>
-When checked, this option will tell the system to automatically launch <application>Orca</application> when you log in.
+In the <application>Appearance</application> preference tool, choose the <guilabel>Theme</guilabel> tab and the theme you want to modify.
</para>
-</section>
+</listitem>
+<listitem>
+<para>
+Click on the <guibutton>Customize</guibutton> button. The <guilabel>Customize Theme</guilabel> dialog is displayed.
+</para>
+</listitem>
+<listitem>
+<para>
+Click on the <guilabel>Window Border</guilabel> tab to display the window frame options that are available.
+</para>
+</listitem>
+<listitem>
+<para>
+Select the window frame option that you want to associate with the current theme from the list box, then click <guibutton>Close</guibutton>. The <guilabel>Atlanta</guilabel> option is designed for accessibility.
+</para>
+</listitem>
+</orderedlist>
</section>
-<section>
-<title>Speech Page</title>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/Speech_Tab.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - Speech Page
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
+<section id="themes-19">
+<title>Modifying the Icon Setting for a Theme</title>
+<indexterm>
+<primary>themes</primary>
+<secondary>icon</secondary>
+</indexterm>
<para>
-The speech page allows you to customize how <application>Orca</application> uses speech synthesis.
+To modify the icon setting that is associated with a theme, perform the following steps:
</para>
-
-<section>
-<title>Enable speech</title>
+<orderedlist>
+<listitem>
<para>
-The first control of note on the speech page is the "enable speech" check box. This check box toggles whether or not <application>Orca</application> will make use of a speech synthesizer. This option, along with the ability to enable braille and enable magnifier support, allow <application>Orca</application> to be tailored to meet the needs of a wide variety of users.
+In the <application>Appearance</application> preference tool, choose the <guilabel>Theme</guilabel> tab and select the theme that you want to modify.
</para>
-</section>
-
-<section>
-<title>Speech System and Speech Synthesizer</title>
+</listitem>
+<listitem>
<para>
-The next two controls deal with selecting the speech system and synthesizer. <application>Orca</application> provides support for a growing number of speech systems. At the time of this writing, these include GNOME-speech, Emacspeak, and an experimental backend for Speech Dispatcher. Depending upon how your machine is configured, you may have all or none of these options. Typically, you will have just GNOME-speech.
+Click on the <guibutton>Customize</guibutton> button. The <guilabel>Customize Theme</guilabel> dialog is displayed.
</para>
+</listitem>
+<listitem>
<para>
-First, determine which speech system you would like to use - GNOME-speech works best at this time. After making your selection, tab to the speech synthesizer combo box and choose from the list of available synthesizers.
+Click on the <guilabel>Icons</guilabel> tab to display the icon options that are available.
</para>
-</section>
-
-<section>
-<title>Voice Settings</title>
+</listitem>
+<listitem>
<para>
-If your synthesizer supports it, <application>Orca</application> can utilize multiple voices in order to identify special cases within an application, such as hyperlinks or upper case text. The voice settings and person combo boxes can be adjusted to customize these settings to your liking. For example, assume you were using Fonix DECtalk and wanted the Betty voice to denote upper case. To accomplish this, you could do the following:
+Select the icon option that you want to associate with the theme from the list box, then click <guibutton>Close</guibutton>. The following table lists the icon options that are suitable for accessibility needs:
</para>
-<procedure>
-<step>
+</listitem>
+</orderedlist>
+<table frame="topbot">
+<title>Icon Options Designed for Accessibility Requirements
+</title>
+<tgroup cols="2" colsep="0" rowsep="0">
+<colspec colname="colspec0" colwidth="50*"/>
+<colspec colname="colspec1" colwidth="50*"/>
+<thead>
+<row rowsep="1">
+<entry valign="top">
+<para>Icon Option</para>
+</entry>
+<entry valign="top">
+<para>Description</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry valign="top">
<para>
-Tab to the voice settings combo box, and down arrow until the upper case voice is selected.
+<guilabel>HighContrast</guilabel>
</para>
-</step>
-<step>
+</entry>
+<entry valign="top">
<para>
-Tab to the person combo box, and down arrow to choose the Betty voice.
+Provides dark-on-light icons using high-contrast colors.
</para>
-</step>
-</procedure>
+</entry>
+</row>
+<row>
+<entry colname="colspec0" valign="top">
<para>
-The next three sliders in the tab order allow adjustment of the synthesizer's rate, pitch and volume, respectively.
+<guilabel>HighContrastInverse</guilabel>
</para>
-<note>
+</entry>
+<entry colname="colspec1" valign="top">
<para>
-You can quickly raise/lower the pitch by pressing <keycombo><keycap>ORCA_MODIFIER</keycap><keycap>UpArrow</keycap></keycombo> and <keycombo><keycap>ORCA_MODIFIER</keycap><keycap>DownArrow</keycap></keycombo>. You can also modify the speech rate by pressing <keycombo><keycap>ORCA_MODIFIER</keycap><keycap>LeftArrow</keycap></keycombo> and <keycombo><keycap>ORCA_MODIFIER</keycap><keycap>RightArrow</keycap></keycombo>.
+Provides light-on-dark icons using high-contrast colors.
</para>
-</note>
-</section>
-
-<section>
-<title>Punctuation Level</title>
+</entry>
+</row>
+<!--<row>
+<entry colname="colspec0" valign="top">
<para>
-The punctuation level radio button group is used to adjust the amount of punctuation spoken by the synthesizer. The available levels are None, Some, Most and All.
+<guilabel>LargePrint</guilabel>
</para>
-</section>
-
-<section>
-<title>Verbosity</title>
+</entry>
+<entry colname="colspec1" valign="top">
<para>
-The verbosity setting determines the amount of information that will be spoken in certain situations. For example, if it is set to verbose, the synthesizer will speak shortcut keys for items in pull down menus. When it is set to brief, these shortcut keys are not announced.
+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>
-</section>
-
-<section>
-<title>Table Row Speech</title>
+</entry>
+</row>
+<row>
+<entry valign="top">
<para>
-The table row speech option determines the way in which <application>Orca</application> will read items within tables. The available settings are "speak current row" or "speak current cell". The ability to adjust this behavior can be useful in many situations. For example, consider the process of browsing email messages in <application>Evolution</application>. In this instance it may be preferable to set table speech to "speak current row" so that while arrowing through the list of messages all relevant info, such as the sender, subject, and whether the message has attachments, is read automatically. While the current row setting is active, it is still possible to read individual cells by using the left and right arrows.
+<guilabel>HighContrastLargePrint</guilabel>
</para>
-<note>
+</entry>
+<entry valign="top">
<para>
-You can quickly toggle this behavior by pressing <keycombo><keycap>ORCA_MODIFIER</keycap><keycap>F11</keycap></keycombo>.
+Provides dark text on a light background using
+high-contrast colors. To increase the font size, you
+must use the <application>Font</application> Preference
+tool.
</para>
-</note>
-</section>
-
-<section>
-<title>Speak Progress Bar Updates</title>
+</entry>
+</row>
+<row>
+<entry valign="top">
<para>
-If this setting is enabled, <application>Orca</application> will periodically announce the status of progress bars. How often the announcement is made is determined by the value chosen in the <guilabel>Update Interval</guilabel> spin button. Note that this spin button is only available if the "Speak progress bar updates" checkbox has been checked.
+<guilabel>HighContrastLargePrintInverse</guilabel>
</para>
-</section>
-
-<section>
-<title>Speak Indentation and Justification</title>
+</entry>
+<entry valign="top">
<para>
-When working with code or editing other documents it is often desirable to be aware of justification and indentation. Selecting the "Speak indentation and justification" check box will cause <application>Orca</application> to provide this information.
+Provides light text on a dark background using
+high-contrast colors. To increase the font size, you
+must use the <application>Font</application> Preference
+tool.
</para>
-</section>
-
-<section>
-<title>Speak Blank Lines</title>
+</entry>
+</row>
+<row>
+<entry colname="colspec0" valign="top">
<para>
-Some users desire to hear "blank" when navigating to a blank line in a document. Other users do not. If the "speak blank lines" check box is selected, <application>Orca</application> will speak blank lines.
+<guilabel>LowContrastLargePrint</guilabel>
</para>
-</section>
-
-<section>
-<title>Speak tutorial messages</title>
+</entry>
+<entry colname="colspec1" valign="top">
<para>
-When moving from component to component in an interface, this option will provide spoken tutorial messages for how to work with the component.
+Uses 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>
+</tgroup>
+</table>
</section>
-<section>
-<title>Say All By</title>
+<section id="themes-6">
+<title>Creating Your Own Themes</title>
+<indexterm>
+<primary>themes</primary>
+<secondary>creating own</secondary>
+</indexterm>
<para>
-This combo box allows you to specify whether the "say all" functionality of <application>Orca</application> speaks by sentence or line (see Desktop Keyboard Layout and Laptop Keyboard Layout for how to invoke the "say all" functionality).
+For information about how to create your own themes, see the <ulink type="help"
+url="ghelp:system-admin-guide?themes-0">
+System Administration Guide</ulink>.
</para>
</section>
</section>
-<section>
-<title>Braille Page</title>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/Braille_Tab.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - Braille Page
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
-<para>
-The braille page allows you to customize various aspects about the use of braille. See also Using Orca with BrlTTY for more information on configuring and setting up BrlTTY.
-</para>
-<note>
+<section id="themes-7">
+<title>Customizing Specific Components of the Desktop
+</title>
<para>
-<application>Orca</application> does not automatically start BrlTTY for you; typically you need to do this yourself, usually at boot time.
+This section describes how to customize specific components of the GNOME Desktop individually.
</para>
-</note>
-<section>
-<title>Enable Braille Support</title>
+<section id="themes-8">
+<title>Customizing the Desktop Background</title>
+<indexterm>
+<primary>customizing desktop appearance</primary>
+<secondary>desktop background</secondary>
+</indexterm>
<para>
-The first control on the braille page is the "enable braille support" check box. This check box toggles whether or not <application>Orca</application> will make use of a braille display. This option, along with the ability to enable braille and enable magnifier support, allow <application>Orca</application> to be tailored to meet the needs of a wide variety of users. By default, this check box is enabled. If BrlTTY is not running, <application>Orca</application> will recover gracefully and will not communicate with the braille display. If you configure BrlTTY later on, you need to restart <application>Orca</application> in order for it to use braille.
+The themes do not affect the desktop background. To set the desktop background, choose <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu>
+<guimenuitem>Appearance</guimenuitem></menuchoice> and select a background from the <guilabel>Background</guilabel> tab. If no background is chosen, the first entry listed here may be used.
</para>
</section>
-<section>
-<title>Enable Braille Monitor</title>
+<section id="themes-9">
+<title>Customizing Desktop Background Objects</title>
+<indexterm>
+<primary>customizing desktop appearance</primary>
+<secondary>desktop background objects</secondary>
+</indexterm>
<para>
-<application>Orca</application>'s braille monitor provides an on-screen representation of what takes place on the braille display. This feature is mostly for demonstration purposes, but is also useful for <application>Orca</application> developers who do not have access to a braille display.
+The size of the icons that are displayed on the desktop background is controlled by the <application>File Management</application> preference tool. To change the size of the icons, perform the following steps:
</para>
-</section>
-
-<section>
-<title>Abbreviated Role Names</title>
+<orderedlist>
+<listitem>
<para>
-The "abbreviated role names" check box determines the manner in which role names are displayed and can be used to help conserve real estate on the braille display. The "abbreviated role names" option can be better understood if we consider the following example. Let us assume that a slider had focus, and that the abbreviated role names box was not checked. In this case, the word "slider" would be shown on the display, to reflect the fact that the current control was indeed a slider. If the abbreviated role names box were checked, the word "slider" would be abbreviated to "sldr".
+From the <application>File Manager</application> window, choose the <menuchoice><guimenu>Edit</guimenu>
+<guisubmenu>Preferences</guisubmenu></menuchoice> menu item.
</para>
-</section>
-
-<section>
-<title>Disable end of line symbol</title>
+</listitem>
+<listitem>
<para>
-When checked, this feature tells <application>Orca</application> to not present the "$l" string at the end of a line.
+Select the <guilabel>Views</guilabel> tabbed section.
</para>
-</section>
-
-<section>
-<title>Contracted Braille</title>
-<para>
-<application>Orca</application> supports contracted braille via the <ulink url="http://live.gnome.org/Orca/Braille#Braille";>liblouis project</ulink>, where you can find additional information about setting up liblouis with <application>Orca</application>.
-</para>
-</section>
-
-<section>
-<title>Verbosity</title>
+</listitem>
+<listitem>
<para>
-The verbosity radio button group determines the amount of information that will be brailled in certain situations. For example, if it is set to verbose, keyboard shortcut and role name information is displayed. This information is not displayed in brief mode.
+In the <guilabel>Icon View Defaults</guilabel> group, select the zoom level that you require in the <guilabel>Default Zoom Level</guilabel> drop-down list.
</para>
+</listitem>
+</orderedlist>
</section>
-<section>
-<title>Selection Indicator</title>
+<section id="themes-10">
+<title>Customizing Fonts</title>
+<indexterm>
+<primary>customizing desktop appearance</primary>
+<secondary>fonts</secondary>
+</indexterm>
+<anchor id="themes-13"/>
+<anchor id="themes-14"/>
<para>
-When you select text, <application>Orca</application> will "underline" that text on your braille display with Dots 7 and 8. If you would prefer, you can change the indicator to only be Dot 7, only be Dot 8, or not be present at all.
+This section describes how to customize
+the font settings for the desktop and frequently-used applications.
</para>
-</section>
-
-<section>
-<title>Hyperlink Indicator</title>
<para>
-When you encounter a hyperlink, <application>Orca</application> will "underline" that text on your braille display with Dots 7 and 8. If you would prefer, you can change the indicator to only be Dot 7, only be Dot 8, or not be present at all.
+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 settings to suit your needs.
</para>
-</section>
-</section>
-
-<section>
-<title>Key Echo Page</title>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/KeyEcho_Tab.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - Key Echo Page
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
<para>
-The key echo page allows you to specify the behavior of <application>Orca</application> when pressing keys on the page and whether words are spoken as you complete them.
+You can specify individual font settings for the following desktop components and applications:
</para>
-
-<section>
-<title>Enable Key Echo</title>
+<itemizedlist>
+<listitem>
<para>
-The first control on the key echo page is the "enable key echo" check box. When this box is selected, six additional check boxes become available. These are: Enable alphanumeric and punctuation keys, Enable modifier keys, Enable locking keys, Enable function keys, Enable action keys, and Enable navigation keys.
+Entire desktop (excluding the desktop background)
</para>
+</listitem>
+<listitem>
+<para>Desktop background only</para>
+</listitem>
+<listitem>
+<para>Terminal</para>
+</listitem>
+<listitem>
+<para>Text Editor</para>
+</listitem>
+<listitem>
+<para>Help</para>
+</listitem>
+<listitem>
+<para>Web Browser</para>
+</listitem>
+</itemizedlist>
+<section id="themes-11">
+<title>Customizing Desktop Fonts</title>
+<indexterm>
+<primary>customizing desktop appearance</primary>
+<secondary>desktop fonts</secondary>
+</indexterm>
<para>
-The alphanumeric and function key groups are relatively self explanatory.
+The <application>Appearance</application> preference tool allows you to specify the default fonts for the desktop.
</para>
<para>
-Modifier keys are those such as <keycap>Shift</keycap>, <keycap>Control</keycap>, and <keycap>Alt</keycap>.
+To start the <application>Appearance</application> preference tool, choose <menuchoice><guimenu>System</guimenu>
+<guisubmenu>Preferences</guisubmenu><guimenuitem>Appearance</guimenuitem></menuchoice>. The <guilabel>
+Fonts</guilabel> tab contains the following options:
</para>
+<variablelist>
+<varlistentry>
+<term>
+<guilabel>Application Font</guilabel>
+</term>
+<listitem>
<para>
-Locking keys include <keycap>Caps Lock</keycap>, <keycap>Scroll Lock</keycap> and <keycap>Num Lock</keycap>.
+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 dialogs associated with GNOME-compliant applications and panel applications.
</para>
+<note>
<para>
-The action keys group consists of keys that perform some logical action, such as <keycap>Backspace</keycap>, <keycap>Return</keycap> and <keycap>Tab</keycap>.
+If you use a predefined theme and you click on the <guibutton>Apply Font</guibutton> button, the font that is associated with the theme overrides the font from the <application>Appearance</application> preference tool.
</para>
+</note>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<guilabel>Document Font</guilabel>
+</term>
+<listitem>
<para>
-The navigation keys group include the four arrow keys as well as any key combination in which the Orca Modifier key is being held down. The latter is designed to prevent <application>Orca</application> from echoing flat review commands.
+Click on this button to select a font to use for displaying documents.
</para>
-</section>
-
-<section>
-<title>Enable Echo by Word</title>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>
+<guilabel>Desktop Font</guilabel>
+</term>
+<listitem>
<para>
-The next toggle on the key echo page is the "enable echo by word" check box, used to echo the word you just typed. The "echo by word" control is always available, regardless of whether any of the key echo options are checked.
+Click on this button to select a font to use for the text that is displayed on the desktop background only.
</para>
-</section>
-
-<section>
-<title>Enable Echo by Sentence</title>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Window Title Font</guilabel> </term>
+<listitem>
<para>
-The last toggle on the key echo page is the "enable echo by sentence" check box, used to echo the sentence you just typed. The echo by sentence control is always available, regardless of whether any of the key echo options are checked.
+Click on this button to select a font to use for the text that is displayed in the titlebar area of windows.
</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Fixed Width Font</guilabel> </term>
+<listitem>
<para>
-In summary, the key echo scheme can offer a great deal of flexibility. For example, one user might choose to enable all key echo options, while another might prefer to use word echo, but only have locking keys announced.
+Click on this button to select a font to use for editing documents.
</para>
-</section>
-</section>
-
-<section>
-<title>Magnifier Page</title>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/Magnifier_Tab.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - Magnifier Page
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><guilabel>Font Rendering</guilabel> </term>
+<listitem>
<para>
-The magnifier page allows you to enable/disable magnification and specify how magnification is performed.
+To specify how to render fonts on the desktop, select one of the following options:
</para>
-
-<section>
-<title>Enable Magnifier</title>
+<itemizedlist>
+<listitem>
<para>
-The first control on the magnifier page is the "enable magnifier" check box. This check box toggles whether or not <application>Orca</application> will provide magnification. This option, along with the ability to enable speech and enable braille support, allow <application>Orca</application> to be tailored to meet the needs of a wide variety of users.
+<guilabel>Monochrome</guilabel>
</para>
-</section>
-
-<section>
-<title>Zoomer Settings</title>
+</listitem>
+<listitem>
<para>
-Two zoomer GUI controls determine magnification characteristics:
+<guilabel>Best Shapes</guilabel>
</para>
-<itemizedlist>
+</listitem>
<listitem>
<para>
-Scale factor, which sets magnification power from 1.0x to 16.0x (fractional values are supported).
+<guilabel>Best Contrast</guilabel>
</para>
</listitem>
<listitem>
<para>
-Position, which sets the location and size of the magnifier window: Full Screen, Left Half, Right Half, Top Half, Bottom Half, and Custom. The default position is Full Screen. Choosing Custom causes four spin buttons to become available: Top, Left, Right, and Bottom. These spin buttons allow you to define the location of each edge of the zoom window. Units are in pixels.
+<guilabel>Subpixel Smoothing</guilabel>
</para>
</listitem>
</itemizedlist>
-</section>
-
-<section>
-<title>Border Settings</title>
+</listitem>
+</varlistentry>
+</variablelist>
<note>
<para>
-These options are not available in Full Screen mode.
+If you use large fonts, you may need to change the size of panes in some applications, such as the file manager and Help browser.
</para>
</note>
-
-<section>
-<title>Enable border</title>
<para>
-This option determines if a window border is visible for the magnifier.
+For more information about the <application>Appearance</application> preference tool and fonts, see the <ulink type="help" url="ghelp:user-guide?prefs-font">
+User Guide</ulink>.
</para>
</section>
-<section>
-<title>Border size</title>
+<section id="themes-cust">
+<title>Customizing Application Fonts</title>
+<indexterm>
+<primary>custom desktop appearance</primary>
+<secondary>set choose individual font</secondary>
+</indexterm>
<para>
-This value determines the size of the border in pixels.
+By default, GNOME applications use the default font specified in the <application>Appearance</application> preference tool. Some applications allow this default font to be customized. These applications are:
</para>
-</section>
-
-<section>
-<title>Border color</title>
-<para>
-Border color settings allow additional visual options.
+<itemizedlist>
+<listitem>
+<para><ulink type="help" url="ghelp:user-guide#yelp">
+Help Browser</ulink>
</para>
-
-<section>
-<title>Invert colors</title>
+</listitem>
+<listitem>
<para>
-Creates a reverse or negative-image effect.
-</para>
-</section>
-
-<section>
-<title>Brightness</title>
+<ulink type="help" url="ghelp:gedit?
+gedit-prefs-fontsandcolors">
+Text Editor</ulink> </para>
+</listitem>
+<listitem>
<para>
-Ranges from -1 to 1 (-1 is black/no brightness; 1 is white/total brightness; 0 is "normal"/unchanged).
+<ulink type="help" url="ghelp:gnome-terminal#
+gnome-terminal-prefs-general">
+Terminal</ulink>
</para>
-</section>
-
-<section>
-<title>Contrast</title>
+</listitem>
+<listitem>
<para>
-Ranges from -1 to 1 (-1 is grey/no contrast; 1 is maximum contrast; 0 is "normal"/unchanged).
+<ulink type="help" url="ghelp:epiphany#
+ephy-customize">Web Browser</ulink>
</para>
+</listitem>
+</itemizedlist>
+</section>
</section>
</section>
-<section>
-<title>Cursor Settings</title>
+<section id="themes-15">
+<title>Meeting Specific Accessibility Needs</title>
<para>
-These controls can be used to customize the size and color of the magnifier's cursor.
+The following sections summarize the steps you need to take to improve the accessibility of the desktop in a particular area.
</para>
-<section>
-<title>Enable cursor</title>
-<para>
-If this check box is enabled then a cursor is visible and the size and color options become available.
-</para>
-</section>
-
-<section>
-<title>Custom size</title>
-<para>
-Enable this check box if you would like to make the mouse pointer larger than it normally is. The cursor size can be changed from the default value of 32 pixels.
-</para>
-</section>
-
-<section>
-<title>Custom color</title>
-<para>
-If the cursor is enabled, a custom color can also be applied.
-</para>
-</section>
-</section>
-
-<section>
-<title>Cross-hair Settings</title>
-<para>
-This set of controls can be used to customize the magnifier's optional area-targeting cursor.
-</para>
-
-<section>
-<title>Enable cross-hair</title>
-<para>
-If checked, you can additionally configure the clipping behavior, size and color of the cross-hair.
-</para>
-</section>
-
-<section>
-<title>Enable cross-hair clip</title>
-<para>
-If enabled, the cross-hair will be "clipped" (removed) in the area immediately surrounding the mouse pointer.
-</para>
-</section>
-
-<section>
-<title>Cross-hair size</title>
-<para>
-This control sets the thickness of the cross-hair in pixels.
-</para>
-</section>
-
-<section>
-<title>Cross-hair color</title>
-<para>
-This control allows a custom color to be used for the cross-hair.
-</para>
-</section>
-</section>
-
-<section>
-<title>Tracking and Alignment Settings</title>
-<para>
-These options control the behavior of the mouse cursor.
-</para>
-
-<section>
-<title>Mouse pointer</title>
-<para>
-If unchecked, no mouse pointer is visible.
-</para>
-
-<section>
-<title>Centered</title>
-<para>
-Keep the mouse pointer at the center of the screen whenever possible. This is the default.
-</para>
-</section>
-
-<section>
-<title>Proportional</title>
-<para>
-Position the mouse pointer in the zoom window relative to its actual, unmagnified position. For instance, if the mouse pointer is 25% away from the left edge of the desktop, <application>Orca</application> positions the magnified mouse pointer 25% from the left edge of the zoom window.
-</para>
-</section>
-
-<section>
-<title>Push</title>
-<para>
-Move the zoomer window the least amount necessary to keep the mouse pointer on the screen.
-</para>
-</section>
-
-<section>
-<title>None</title>
-<para>
-Moving the mouse pointer has no impact on what the zoomer window displays.
-</para>
-</section>
-
-<section>
-<title>Pointer follows zoomer</title>
-<para>
-This option is enabled by default. If the mouse pointer is not on the screen when you initially move the mouse, it will be moved into the zoomer so that you can continue to see what you were working on. If your preferred mouse tracking mode is centered, the pointer will be moved to the center; otherwise it will be moved to the item with focus.
-</para>
-</section>
-</section>
-
-<section>
-<title>Control and menu item</title>
-<para>
-These options control additional behavior of the magnifier.
-</para>
-
-<section>
-<title>Centered</title>
-<para>
-When navigating via keyboard, keep the focused dialog box control or menu item at the center of the screen whenever possible.
-</para>
-</section>
-
-<section>
-<title>Push</title>
-<para>
-When navigating via keyboard, move the zoomer window the least amount necessary to display the focused dialog box control or menu item. This is the default.
-</para>
-</section>
-
-<section>
-<title>None</title>
-<para>
-Using the keyboard to navigate among dialog box controls and menu items will have no impact on what the zoomer window displays.
-</para>
-</section>
-
-<section>
-<title>Pointer follows focus</title>
-<para>
-If this option is enabled, the mouse pointer will follow you as you arrow through menu items and move among controls in dialog boxes. This option is disabled by default.
-</para>
-</section>
-</section>
-
-<section>
-<title>Text cursor</title>
-<para>
-These options control how the text cursor behaves.
-</para>
-
-<section>
-<title>Centered</title>
-<para>
-As the text cursor moves, keep it at the center of the screen whenever possible.
-</para>
-</section>
-
-<section>
-<title>Push</title>
-<para>
-As the text cursor moves, move the zoomer window the least amount necessary to display it. This is the default.
-</para>
-</section>
-
-<section>
-<title>None</title>
-<para>
-Moving the text cursor will have no impact on what the zoomer window displays.
-</para>
-</section>
-
-<section>
-<title>Edge margin</title>
-<para>
-The edge margin is how close the caret should be allowed to get to the edge of the screen before it's time to "push" the zoomer window. The margin can range from 0 to 50%, with 50% being the equivalent of choosing centering. The default value is 0.
-</para>
-<note>
-<para>
-This option is only available if "Push" is your text cursor tracking mode.
-</para>
-</note>
-</section>
-</section>
-
-<section>
-<title>Advanced Settings</title>
-<para>
-If you press the Advanced Settings button located near the bottom of the Magnifier page, the following dialog will appear:
-</para>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/Magnifier_Advanced.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - Magnifier - Advanced Settings
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
-
-<section>
-<title>Smoothing</title>
-<para>
-Bilinear or none.
-</para>
-</section>
-
-<section>
-<title>Brightness</title>
-<para>
-Red, Green, Blue: Individual controls for choosing customized brightness levels. Choosing different brightness levels for each color allows you to create the color scheme that works best for you.
-</para>
-</section>
-
-<section>
-<title>Contrast</title>
-<para>
-Red, Green, Blue: Individual controls for choosing customized contrast levels. While not as significant as changes to brightness, choosing different contrast levels for each color helps you to create the color scheme that works best for you.
-</para>
-</section>
-
-<section>
-<title>Color Filtering</title>
+<section id="themes-16">
+<title>Achieving a High- or Low-Contrast Desktop</title>
+<indexterm>
+<primary>high contrast desktop</primary>
+</indexterm>
+<indexterm>
+<primary>low contrast desktop</primary>
+</indexterm>
<para>
-Allows you to pick one of the colorblind filters available through libcolorblind.
+To achieve a high- or low-contrast desktop, perform the following steps:
</para>
-<note>
+<orderedlist>
+<listitem>
<para>
-In order to take advantage of this feature you will need to install libcolorblind and then rebuild gnome-mag.
+Use the <application>Appearance</application> preference tool to select the high-contrast or low-contrast desktop theme that you require from the <guilabel>Theme</guilabel> tab.
</para>
-</note>
-</section>
-
-<section>
-<title>Multi-Monitor Settings - Source Display</title>
+</listitem>
+<listitem>
<para>
-X Window System DISPLAY of what should be magnified. Written in the form ":0.x" where x is the number of the screen whose contents should be magnified.
+Use the <guilabel>Background</guilabel> tab to customize your desktop background as follows:
</para>
-</section>
-
-<section>
-<title>Multi-Monitor Settings - Target Display</title>
+<itemizedlist>
+<listitem>
<para>
-X Window System DISPLAY of where to put the zoomer window. Written in the form ":0.y" where y is the number of the screen where the zoomer window should appear.
+Set the <guilabel>Desktop Wallpaper</guilabel> to <guilabel>No Wallpaper</guilabel>.
</para>
-</section>
-</section>
-</section>
-</section>
-</section>
-
-<section>
-<title>Key Bindings Page</title>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/KeyBindings_Tab.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - Key Bindings Page
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
+</listitem>
+<listitem>
<para>
-The key bindings page allows you to examine and modify the key bindings for <application>Orca</application>.
+Set the <guilabel>Desktop Colors</guilabel> to <guilabel>Solid Color</guilabel>.
</para>
-
-<section>
-<title>Orca Modifier Key(s)</title>
+</listitem>
+<listitem>
<para>
-The first control on the key bindings page allows you to examine which key (or keys) acts as the "<application>Orca</application> modifier." The <application>Orca</application> modifier is the key that you press and hold in conjunction with other keys to give commands to <application>Orca</application>. For desktop keyboards, the Orca modifier defaults to <keycap>Insert</keycap>. For laptop keyboards, the <application>Orca</application> modifier defaults to the <keycap>Caps Lock</keycap> key.
+Select a background color that suits your needs.
</para>
-<note>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem>
<para>
-You cannot modify the <application>Orca</application> modifier key(s) using the Configuration GUI at this time.
+In the <application>Terminal</application> application, ensure that the <guilabel>Use colors from system theme</guilabel> option is selected in the <guilabel>Colors</guilabel> tabbed section of the <guilabel>Editing
+Profile</guilabel> dialog.
</para>
-</note>
-</section>
-
-<section>
-<title>Key Bindings Table</title>
+</listitem>
+<listitem>
<para>
-The key bindings table provides a list of <application>Orca</application> operations and the keys that are bound to them.
+In the <application>gedit</application> (Text Editor) application, ensure that the <guilabel>Use default theme colors</guilabel> option is selected in the <guilabel>Fonts & Colors</guilabel> tabbed section of the
+<guilabel>Preferences</guilabel> dialog.
</para>
+</listitem>
+</orderedlist>
+</section>
+
+<section id="themes-17">
+<title>Achieving a Large Print Desktop</title>
+<indexterm>
+<primary>large print desktop</primary>
+</indexterm>
<para>
-The "Function" column header is a description of the <application>Orca</application> operation to be performed.
+To achieve a large-print desktop, perform the following steps:
</para>
+<orderedlist>
+<listitem>
<para>
-The "Key Binding" header is the primary way to invoke the function from the keyboard. Note that the function description may include the word "Orca". This indicates that the <application>Orca</application> modifier key should be held down along with the other keys.
+Use the <application>Appearance</application> preference tool to select the <guilabel>Large Print</guilabel> theme.
</para>
+</listitem>
+<listitem>
<para>
-The "Alternate" header provides an alternate mechanism for invoking the function from the keyboard.
+Click on the <guibutton>Apply Font</guibutton> button to increase the size of the font that is used on the desktop and on window frames.
</para>
+</listitem>
+<listitem>
<para>
-To modify either the "Key Binding" or the "Alternate" bindings, arrow to the cell and press <keycap>Return</keycap>. Then, press a key combination and press <keycap>Return</keycap> to confirm the new combination. When you do so, the new keystroke will be saved and the check box in the last column (the "Modified" column) will indicate that the key binding has been modified.
+Use the <guilabel>Desktop Font</guilabel> option in the <guilabel>Font</guilabel> tab to increase the font that is displayed on desktop background objects.
</para>
+</listitem>
+<listitem>
<para>
-To undo a modified keybinding, merely arrow to the modified column, uncheck the checkbox, and press the "Apply" button <keycombo><keycap>Alt</keycap><keycap>A</keycap></keycombo>.
+Increase the font size that is used to display the contents of the <application>Terminal</application> application window.
</para>
+</listitem>
+<listitem>
<para>
-Beneath the list of <application>Orca</application> keybindings, you will find a group of "unbound" commands:
+If the <guilabel>Use default theme font</guilabel> option is selected in the <application>gedit</application> (Text Editor) <guilabel>Preferences</guilabel> dialog, <application>gedit</application> uses the font size that is specified in the large-print theme that you selected. However, if the <guilabel>Use default theme font
+</guilabel> option is not selected, increase the font size that is used to display the contents of the <application>gedit</application> text editor window. See the <ulink type="help" url="ghelp:gedit?gedit-prefs-fontsandcolors">gedit manual</ulink> for more information.
</para>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/KeyBindings_Tab_Unbound.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - Key Bindings Page showing the 'unbound' group of commands
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
+</listitem>
+<listitem>
<para>
-These are commands which we feel will be very useful for some users, but not needed by most users. Rather than "use up" a keystroke for such commands, we have left them unassigned. You can assign a keystroke to any of these unbound commands by following the procedure outlined above. In addition, you can unbind any bound command in a similar fashion: press <keycap>Return</keycap> to edit the keybinding, and when prompted for the new keybinding, press <keycap>Delete</keycap> or <keycap>Backspace</keycap>. You will be told that the key binding has been removed. Press <keycap>Return</keycap> to confirm.
+If you use applications that use panes, such as the file manager and help browser, you may need to change the size of panes to accommodate the large print. See the online help for the appropriate application for more information.
</para>
+</listitem>
+</orderedlist>
+</section>
</section>
</section>
-<section>
-<title>Pronunciation Page</title>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/Pronunciation_Tab.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - Pronunciation Page
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
+<section id="ats-2">
+<title>Orca: Screen Reader and Magnifier</title>
+<indexterm>
+<primary>Screen Reader and Magnifier</primary>
+</indexterm>
+<indexterm>
+<primary>Orca</primary>
+</indexterm>
<para>
-Sometimes your speech synthesizer just doesn't say the right thing for a given string. You might prefer to hear "laughing out loud" rather than "LOL." Or there may be a name or a technical term which the synthesizer mispronounces. The pronunciation page is where you can add, edit, and delete <application>Orca</application>'s pronunciation dictionary entries. Because the pronunciation page is also part of the application-specific settings dialog that's started when you give a particular application focus and type <keycombo><keycap>Orca_Modifier</keycap><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo>, you can customize your entries on an as-needed basis for each application you use.
+The <application>Orca</application> Screen Reader and Magnifier application enables users with limited or no vision to use the GNOME Desktop and associated applications. <application>Orca</application> provides the following functionality:
</para>
-
-<section>
-<title>Add a new dictionary entry</title>
-<procedure>
-<step>
+<itemizedlist>
+<listitem>
<para>
-Press the <guibutton>New Entry</guibutton> button (<keycombo><keycap>Alt</keycap><keycap>N</keycap></keycombo>).
+Screen Reader
</para>
-</step>
-<step>
<para>
-Type the text of the new entry and press <keycap>Return</keycap> to finish editing the actual string.
+The screen reader enables non-visual access to standard applications in the GNOME Desktop by using speech and braille output.
</para>
-</step>
-<step>
+</listitem>
+<listitem>
<para>
-Move to the Replacement String column and press <keycap>Return</keycap> to begin editing.
+Magnifier
</para>
-</step>
-<step>
<para>
-Type the text that you would like to have spoken instead and press <keycap>Return</keycap> to finish editing the replacement string.
+The magnifier provides automated focus tracking and full-screen magnification to aid low-vision users.
</para>
-</step>
-</procedure>
-</section>
-
-<section>
-<title>Edit an existing dictionary entry</title>
-<procedure>
-<step>
+</listitem>
+</itemizedlist>
<para>
-Move to the cell you wish to edit and press <keycap>Return</keycap> to begin editing.
+The following sections provide information about <application>Orca</application> and how to use it.
</para>
-</step>
-<step>
+
+<section>
+<title>Introduction to Orca</title>
+<section>
+<title>What is Orca?</title>
<para>
-Make your changes and then press <keycap>Return</keycap> to finish editing.
+Orca is a flexible, extensible, and powerful assistive technology for people with visual impairments. Using various combinations of speech synthesis, braille and magnification, Orca helps provide access to applications
+and toolkits that support the AT-SPI (e.g., the GNOME Desktop). <application>Orca</application> is also free open source software.
</para>
-</step>
-</procedure>
</section>
<section>
-<title>Delete an existing dictionary entry</title>
-<procedure>
-<step>
+<title>Why the name Orca?</title>
<para>
-Move to the entry you wish to delete.
+One of the first DOS screen readers was Flipper, made by Omnichron Corporation in Berkeley, CA. It was named Flipper in part because the blind wife of the programmer
+envisioned computers as being programmed by flipping switches (an accurate image of a bygone era). Then came another DOS screen reader, this one from Henter-Joyce in
+Florida - "Jobs Access With Speech" (or JAWS). And so on....
</para>
-</step>
-<step>
<para>
-Press the Delete button or <keycombo><keycap>Alt</keycap><keycap>D</keycap></keycombo>.
+Although no obvious connection exists between blindness and creatures from the sea, there is certainly a naming tradition for screen-reader software. Hence <application>Orca</application>, which is a lot tougher-sounding than Nemo, Ariel, Willy, or Mr. Limpet.
</para>
-</step>
-</procedure>
-</section>
</section>
<section>
-<title>Text Attributes Page</title>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata
-fileref="figures/TextAttributes_Tab.png"
-format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>
-<application>Orca</application> GUI Configuration - Text Attributes Page
-</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
+<title>What's the schedule?</title>
<para>
-<application>Orca</application> will speak known text attribute information about an object when you press <keycombo><keycap>Insert</keycap><keycap>F</keycap></keycombo> (desktop layout) or <keycombo><keycap>Caps_Lock</keycap><keycap>F</keycap></keycombo> (laptop layout). Because the number of text attributes is large, and not everyone cares about every attribute, the "Text Attributes" tab of the configuration
-GUI allows you to customize which text attributes <application>Orca</application> will present.
+<application>Orca</application> is part of the GNOME platform and <application>Orca</application>'s releases are coupled with the releases of the GNOME platform.
</para>
+</section>
+
+<section>
+<title>How do I request a new feature?</title>
<para>
-On this tab is a text attribute list, where each row consists of four columns:
+<ulink url="http://bugzilla.gnome.org/buglist.cgi?query=product:orca+";>Bugs</ulink> and feature/enhancement requests (RFEs)
+should be reported to the <ulink url="http://bugzilla.gnome.org";>GNOME Bug Tracking System
+</ulink>. Patches are always welcome, and instructions for creating patches can be found in the <ulink url="http://developer.gnome.org/tools/svn.html";>
+GNOME Introduction to Subversion (SVN)
+</ulink>.
</para>
-<itemizedlist>
-<listitem>
+</section>
+
+<section>
+<title>Where is the discussion list?</title>
<para>
-The name of the text attribute.
+You can get in touch with developers and other users by <ulink url="mailto:orca-list gnome org">sending an e-mail</ulink> to the <ulink url="http://mail.gnome.org/mailman/listinfo/orca-list";>Orca mailing list</ulink>
+(<ulink url="http://mail.gnome.org/archives/orca-list";>Archives</ulink>).
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Is braille supported?</title>
<para>
-A checkbox which the user can set to indicate whether this text attribute should be spoken or not.
+Yes! Braille is supported via BrlTTY and it is tightly integrated with Orca. BrlTTY offers support for nearly every refreshable braille display known to man.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Is contracted braille supported?</title>
<para>
-A checkbox which the user can set to indicate whether this text attribute should be "underlined" on the braille display.
+Yes, <application>Orca</application> fully supports contracted braille output.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>What voices are available?</title>
<para>
-An editable "Present unless" string value. By default, not all text attributes will have this set. If present, what it means (assuming the user wants this text attribute presented) is that the value of the attribute will only be presented if it is <emphasis>not</emphasis> this value.
+<application>Orca</application> provides interfaces to both <userinput>gnome-speech</userinput> and <userinput>emacspeak</userinput> speech services. As such, the available voices for <application>Orca</application> are only restricted by the speech engines supported by the available speech services. For free speech engines, you typically have a choice of the eSpeak, Festival, and FreeTTS speech engines. For commercial engines, you have a choice of
+additional engines such as Fonix DECtalk, Loquendo, Eloquence, Cepstral and IBMTTS, with others on the way. Periodically check the <userinput>gnome-speech</userinput> package for more progress in this area.
</para>
+</section>
+
+<section>
+<title>What languages are supported?</title>
<para>
-For example, by default the "underline" text attribute has a value of "none." If the user has this attribute checked and the user types
-<keycombo><keycap>Orca_Modifier</keycap><keycap>F</keycap></keycombo> and the text in question is not underlined, then this
-attribute is not spoken. If you always want this attribute to be spoken irrespective of whether the text is underlined, then the
-attribute should be checked and the "Present unless" value cleared.
+The <ulink url="http://l10n.gnome.org/teams";>
+GNOME translation teams</ulink> are composed of many passionate volunteers from around the world. These teams do a great job and keep an up-to-date status report. See the <ulink url="http://l10n.gnome.org/module/orca";>
+Orca translation status page</ulink> for the large number of languages into which <application>Orca</application> has been translated.
</para>
-</listitem>
-<listitem>
-<para>
-There is also a <guibutton>Reset</guibutton> button (<keycombo><keycap>Alt</keycap><keycap>R</keycap></keycombo>) which will set the list values back to their initial state when the dialog was first displayed.
+<para>
+Note: support for a language also depends on
+the speech synthesis engine also supporting the same language.
</para>
-</listitem>
-</itemizedlist>
+</section>
+
+<section>
+<title>How well does magnification work?</title>
<para>
-When you initially display the text attribute pane, all your checked attributes are put at the top of the list. They are given in the order that they will be spoken and brailled.
+<application>Orca</application> currently uses the <userinput>gnome-mag</userinput>
+magnification service. <userinput>gnome-mag</userinput> has incorporated support for smoother full-screen magnification, which
+relies upon newer extensions in the X Window System server. These extensions do not always function well on all platforms, so smooth full-screen magnification may not always work.
</para>
+</section>
+
+</section>
+
+<section id="enable-orca">
+<title>Enabling Orca</title>
<para>
-If you decide to check others or adjust the order, there are four buttons to help you do this:
+For a text-only guided setup, open a Run dialog with <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> or <keycombo><keycap>Meta</keycap><keycap>R</keycap></keycombo> and use the command <userinput>orca --text-setup</userinput> <keycap>Enter</keycap>.
</para>
-<itemizedlist>
-<listitem>
<para>
-<guibutton>Move to top</guibutton> (<keycombo><keycap>Alt</keycap><keycap>T</keycap></keycombo>) - moves the selected attribute to the top of the list.
+The first time <application>Orca</application> is launched you will be asked a few questions:
</para>
-</listitem>
-<listitem>
<para>
-<guibutton>Move up one</guibutton> (<keycombo><keycap>Alt</keycap><keycap>U</keycap></keycombo>) - moves the selected attribute up one row.
+First you will be presented with a list of languages to choose from; there are currently about 45 languages supported. Most of this list will scroll off the screen, so you may have to use the terminal's scrollbar to view earlier parts of the list. Type in the number of your language choice (e.g., 7 for American English) and press <keycap>Enter</keycap>. You do not need to wait for the entire list to be spoken, and Orca attempts to make your default language the first choice (choice 1).
</para>
-</listitem>
-<listitem>
<para>
-<guibutton>Move down one</guibutton> (<keycombo><keycap>Alt</keycap><keycap>D</keycap></keycombo>) - moves the selected attribute down one row.
+You are next asked to set <guilabel>Echo By Word</guilabel>. This option instructs <application>Orca</application> to speak words as you finish typing them. Type <keycap>y</keycap> or <keycap>n</keycap> and press <keycap>Enter</keycap>.
</para>
-</listitem>
-<listitem>
<para>
-<guibutton>Move to bottom</guibutton> (<keycombo><keycap>Alt</keycap><keycap>B</keycap></keycombo>) - moves the selected attribute to the bottom of the list.
+The next item is <guilabel>Key Echo</guilabel>. This option will speak all keys as they are pressed. Type <keycap>y</keycap> or <keycap>n</keycap> and press <keycap>Enter</keycap>.
</para>
-</listitem>
-</itemizedlist>
<para>
-Beneath these push buttons is the Braille Indicator group of radio buttons. Here you can select the cell or cells to be used to indicate text which has at least one of the specified attributes. Your choices are:
+Now select your desired keyboard layout; generally, you will want to choose the layout that matches your keyboard type - 1 for Desktop or 2 for Laptop. This choice will determine what key will act as the <application>Orca</application> modifier key. The Desktop layout uses <keycap>Insert</keycap> while the Laptop layout uses <keycap>Caps Lock</keycap>. A system, host, shift or modifier key is one which is used in conjunction with other keys, enabling keyboard access to most program functions.
</para>
-<itemizedlist>
-<listitem>
<para>
-None (the default)
+Next, specify if you require braille output. This functionality assumes a BrlTTY-compatible device is available. Type <keycap>y</keycap> or <keycap>n</keycap> and press <keycap>Enter</keycap>. Note that you can usually just enter <keycap>y</keycap> here; Orca will recover gracefully and function even if it cannot find BrlTTY.
</para>
-</listitem>
-<listitem>
<para>
-Dot 7
+Lastly, indicate whether you want an on-screen braille output monitor. This is mostly for developers who need to verify BrlTTY output, but may also be useful in other situations, such as visually diagnosing or verifying braille output. Type <keycap>y</keycap> or <keycap>n</keycap> and press <keycap>Enter</keycap>.
</para>
-</listitem>
-<listitem>
<para>
-Dot 8
+That's it! <application>Orca</application> is now ready for use. If accessibility was not yet enabled, <application>Orca</application> does so now and asks you to logout and back in for the services to start. Type <keycap>y</keycap> and press <keycap>Enter</keycap> to restart your login session.
</para>
-</listitem>
-<listitem>
<para>
-Dots 7 and 8
+After completing the first-time <application>Orca</application> settings, use <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> or <keycombo><keycap>Meta</keycap><keycap>R</keycap></keycombo> to bring up the Run dialog, type in <literal>orca</literal> and press <keycap>Enter</keycap>. Accessibility functions should now be active. Orca's Configuration GUI (<xref linkend="configuration-gui"/>) also has an option to let you indicate that Orca should be started automatically when you log in.
</para>
-</listitem>
-</itemizedlist>
<para>
-Text attributes can also be set on an individual application basis. The text attribute pane is also part of the application-specific settings dialog that's started when you give a particular application focus and type <keycombo><keycap>Orca_Modifier</keycap><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo>.
+If you plan to use the Magnifier portion of <application>Orca</application> in full screen mode, nonfirm the <application>Xserver</application> "Composite" extension is enabled: use <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> or <keycombo><keycap>Meta</keycap><keycap>R</keycap></keycombo> to bring up the Run dialog, type in <literal>xdpyinfo</literal> and press <keycap>Enter</keycap>. Look for the string "Composite" in the output.
</para>
</section>
-</section>
<section>
-<title>Orca Keyboard Commands</title>
-<para>
-You can get a complete list of available keyboard commands by visiting the <guilabel>Key Bindings</guilabel> page of the <application>Orca</application> Configuration GUI. To bring up the <application>Orca</application> Configuration GUI, press <keycombo><keycap>Orca_Modifier</keycap><keycap>Space</keycap></keycombo>, where <userinput>Orca_Modifier</userinput> is the <keycap>Insert</keycap> key for the <link linkend="orca-desktop-keys">desktop layout</link> and the <keycap>Caps_Lock</keycap> key for the <link linkend="orca-laptop-keys">laptop layout</link>. Note that you can also enter <application>Orca</application>'s "learn mode" while running <application>Orca</application> by pressing <keycombo><keycap>Orca_Modifier</keycap><keycap>H</keycap></keycombo>. When in learn mode, <application>Orca</application> will intercept all keyboard and braille input events and tell you what the effect would be. To exit learn mode, press the <keycap>Escape</keycap> key.
-</para>
-<note>
-<para>
-<application>Orca</application> provides additional commands for some applications, such as <application>Firefox</application>. To get the list of additional commands for an application, press <keycombo><keycap>Ctrl</keycap><keycap>Orca_Modifier</keycap><keycap>Space</keycap></keycombo> when that application has focus. This will bring up the <application>Orca</application> Configuration GUI in the "application-specific" state, and the additional commands will appear in the <guilabel>Key Bindings</guilabel> page.
-</para>
-<para>
-The GNOME Desktop itself also has <ulink url="http://library.gnome.org/users/user-guide/stable/shortcuts-global.html.en";>built in keyboard commands</ulink> to control the desktop and its applications.
-</para>
+<title>Using Orca</title>
+<section>
+<title>Initial Setup</title>
<para>
-WARNING: the MouseKeys functionality of AccessX can interfere with the <application>Orca</application> modifier key (see <ulink url="http://bugzilla.gnome.org/show_bug.cgi?id=548169";>bug 548169</ulink>), resulting in odd behavior. In particular, MouseKeys uses the <keycap>KP_Insert</keycap> key to emulate a mouse button press. When enabled, MouseKeys can conflict with <keycap>KP_Insert</keycap> as the <application>Orca</application> modifier, resulting in what appears to be a stuck <application>Orca</application> modifier key. As an alternative, you can use the <link linkend="orca-laptop-keys">laptop key bindings</link>, which avoids the keypad for <application>Orca</application> commands. If you accidentally enabled MouseKeys, you can disable it via the <application>gnome-keyboard-properties</application> application.
+When you run <application>Orca</application> for the first time, it will automatically enter setup mode. If you want to run setup
+at some later point, you can pass the
+<userinput>--setup</userinput> option to <application>Orca</application> the next
+time you run it. Furthermore, while <application>Orca</application> is running,
+you can press <keycombo><keycap>Insert</keycap><keycap>Space</keycap></keycombo> to bring up <application>Orca</application>'s Configuration GUI (<xref linkend="configuration-gui"/>). Finally, <application>Orca</application> provides a text setup utility that you can start by passing the
+<userinput>--text-setup</userinput> option to <application>Orca</application>. All of these options will create a <userinput>~/.orca/user-settings.py</userinput> file that holds your preferences and will also enable the accessibility infrastructure. You need to log out and log back in for the new settings to take effect.
</para>
-</note>
+</section>
-<section id="orca-desktop-keys">
-<title>Desktop Layout</title>
+<section>
+<title>How do I run Orca?</title>
<para>
-Following is a list of common <application>Orca</application> keyboard commands for desktop keyboards arranged by category:
+Run <application>Orca</application> by typing <userinput>orca</userinput> in a terminal session window. You can do so from a virtual
+console window if you do not yet have access to the GUI. With the GUI installed you can also press <keycombo><keycap>Alt</keycap>
+<keycap>F2</keycap></keycombo> or <keycombo><keycap>Meta</keycap>
+<keycap>R</keycap></keycombo> to bring up the Run dialog and then type <userinput>orca</userinput> as the command (followed by any optional parameters). Then, press <keycap>Enter</keycap>. <application>Orca</application> will automatically enter text setup mode if you run it from a virtual console window or your GUI environment is not yet set up for accessibility.
</para>
+</section>
<section>
-<title>Flat review commands</title>
+<title>Quitting Orca</title>
+<para>
+To quit <application>Orca</application>, press <keycombo><keycap>Insert</keycap>
+<keycap>Q</keycap></keycombo> (or <keycombo><keycap>CapsLock</keycap>
+<keycap>Q</keycap></keycombo> in laptop layout mode). A confirmation dialog will appear. Select <guilabel>Yes</guilabel> to quit. If the system seems unresponsive, you can try a few things:
+</para>
<itemizedlist>
<listitem>
<para>
-<keycap>Numpad-7</keycap> - move the flat review cursor to the previous line and read it.
+Run <userinput>orca --quit</userinput> from a terminal window, such as a virtual console; press <keycombo><keycap>Ctrl</keycap>
+<keycap>Alt</keycap><keycap>F1</keycap>
+</keycombo> (on most Linux platforms) to get to a virtual console, enter your commands, and then use <keycombo><keycap>Alt</keycap>
+<keycap>F7</keycap></keycombo> to get back to the desktop. This will kill the <application>Orca</application> process and reclaim system resources. You can then
+rerun <application>Orca</application> using the previously outlined methods.
</para>
</listitem>
<listitem>
<para>
-<keycap>Numpad-8</keycap> - read the current line.
+Press <keycombo><keycap>Ctrl</keycap>
+<keycap>Alt</keycap><keycap>Backspace</keycap>
+</keycombo> to end your login session and get back to the graphical login prompt (not implemented in all Linux distributions).
</para>
</listitem>
-<listitem>
+</itemizedlist>
+</section>
+</section>
+
+<section id="configuration-gui">
+<title>Orca Configuration GUI</title>
<para>
-<keycap>Numpad-9</keycap> - move the flat review cursor to the next line and read it.
+The <application>Orca</application> Configuration GUI allows you to customize the behavior and features of <application>Orca</application>, such as speech, braille, and magnification. For example, you can select which speech synthesis engine you want to use, whether braille is enabled or not, and which magnification preferences you want. You can select which general keyboard layout you want (desktop or laptop) and you can also examine and modify the existing keyboard layout with fine-grained control. To bring up the <application>Orca</application> Configuration GUI, press <keycombo><keycap>Orca_Modifier</keycap><keycap>Space</keycap></keycombo>, where <keycap>Orca_Modifier</keycap> is <keycap>Insert</keycap> when you use the Desktop Keyboard Layout (<xref linkend="orca-desktop-keys"/>) and <keycap>CapsLock</keycap> when you use the Laptop Keyboard Layout (<xref linkend="orca-laptop-keys"/>). If you want to change settings for a single application, press <keycombo><keycap>Ctr
l</keycap><keycap>Orca_Modifier</keycap><keycap>Space</keycap></keycombo> while the application has focus.
</para>
-</listitem>
-<listitem>
<para>
-<keycap>Numpad-4</keycap> - move the flat review cursor to the previous word and read it.
+The <application>Orca</application> Configuration GUI is a dialog containing several tabbed pages, each of which is described in the following sections.
</para>
-</listitem>
-<listitem>
+
+<section>
+<title>General Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/General_Tab.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - General Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
<para>
-<keycap>Numpad-5</keycap> - read the current word.
+The <guilabel>General</guilabel> page allows you to customize general aspects of <application>Orca</application>. These include the following:
</para>
-</listitem>
-<listitem>
+
+<section>
+<title>Keyboard Layout</title>
<para>
-<keycap>Numpad-6</keycap> - move the flat review cursor to the next word and read it.
+The keyboard layout section allows you to specify if you will be working on a laptop (small) or desktop (large, with a numeric keypad) keyboard. You select which layout you want by selecting one of the following options:
</para>
-</listitem>
-<listitem>
<para>
-<keycap>Numpad-1</keycap> - move the flat review cursor to the previous character and read it.
+<emphasis>Desktop</emphasis> - if selected, the Desktop Keyboard Layout (<xref linkend="orca-desktop-keys"/>) will be used.
</para>
-</listitem>
-<listitem>
<para>
-<keycap>Numpad-2</keycap> - read the current character.
+<emphasis>Laptop</emphasis> - if selected, the Laptop Keyboard Layout (<xref linkend="orca-laptop-keys"/>) will be used.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Show Orca main window</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/MainWindow.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Main window
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
<para>
-<keycap>Numpad-3</keycap> - move the flat review cursor to the next character and read it.
+The <application>Orca</application> main window provides you with a graphical way to display the <application>Orca</application> Configuration GUI (also accessible with <keycombo><keycap>Orca_Modifier</keycap><keycap>Space</keycap></keycombo>, where Orca_Modifier is <keycap>Insert</keycap> when you use the Desktop Keyboard Layout (<xref linkend="orca-desktop-keys"/>) and <keycap>Caps_Lock</keycap> when you use the Laptop Keyboard Layout (<xref linkend="orca-laptop-keys"/>)). The main window also provides a <guibutton>Quit</guibutton> option, also available with <keycombo><keycap>Orca_Modifier</keycap><keycap>Q</keycap></keycombo>). Many users do not like the <application>Orca</application> main window because it shows up in the window manager's tab order when you press <keycombo><keycap>Alt</keycap><keycap>Tab</keycap></keycombo> to switch windows. By deselecting the "Show Orca main window" button, you can tell <application>Orca</application> to not show the <application>Orc
a</application> main window.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Quit Orca without Confirmation</title>
<para>
-<keycap>Numpad-slash</keycap> - perform a left mouse click at the location of the flat review cursor.
+Normally, when you press <keycombo><keycap>Orca_Modifier</keycap><keycap>Q</keycap></keycombo> to quit <application>Orca</application> or press the <guibutton>Quit</guibutton> button in the <application>Orca</application> main window, <application>Orca</application> will pop up a confirmation dialog asking you if you want to quit. Unchecking this option prevents the confirmation window from appearing.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Disable gksu keyboard grab</title>
<para>
-<keycap>Numpad-star</keycap> - perform a right mouse click at the location of the flat review cursor.
+When running commands from the launch menu, many distributions use an application known as <application>gksu</application> to authorize the user to run these commands; <application>gksu</application> is the GUI that asks you for your password. When it runs, <application>gksu</application> enables what is known as a "keyboard grab," which is a feature to prevent keyboard actions from going to any other application on the desktop, including <application>Orca</application>. The result of a keyboard grab is that <application>Orca</application> will not receive any keyboard events, preventing <application>Orca</application> from functioning normally.
+</para>
+<para>
+By selecting the "Disable gksu keyboard grab" button, you will turn off the keyboard grab behavior, allowing <application>Orca</application> to function normally with system administration applications.
</para>
-</listitem>
-</itemizedlist>
<note>
<para>
-The above commands apply when working with objects as well as when working with text. For example, if the flat review cursor were positioned on a menu bar, pressing the "read current line" command would speak the names of all visible menus. Similarly, pressing the "read next word" command would speak the object to the right of the flat review cursor on the same line, or move flat review to the next line if no more objects were found.
+The keyboard grab is a security attempt by <application>gksu</application> to prevent nefarious applications from "sniffing" the keyboard and grabbing secret information. Please be advised that disabling the gksu keyboard grab feature can expose you to such nefarious behavior. If you do not feel comfortable with this, you can always use the root account for system administration purposes. To do so, you need to enable the root account for login, and then logout and log back in as root whenever you want to perform a system administration command.
</para>
</note>
</section>
<section>
-<title>Bookmark commands</title>
-<itemizedlist>
-<listitem>
+<title>Present tooltips</title>
<para>
-<keycombo><keycap>Alt</keycap><keycap>Insert</keycap><keycap>[1-6]</keycap></keycombo> - assign a bookmark to a numbered slot. If a bookmark already exists in the slot it will be replaced with the new one.
+When checked, this option will tell <application>Orca</application> to present information about tooltips when they appear as the result of mouse hovering. Specific actions to force tooltips to appear, such as pressing <keycombo><keycap>Ctrl</keycap><keycap>F1</keycap></keycombo> when an object has focus, will always result in tooltips being presented, regardless of this setting.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Speak object under mouse</title>
<para>
-<keycombo><keycap>Insert</keycap><keycap>[1-6]</keycap></keycombo> - go to the position pointed to by the bookmark bound to this numbered slot.
+When checked, this option will tell <application>Orca</application> to present information about the object under the mouse when you move it around the screen. Note that this can cause <application>Firefox</application> and <application>Thunderbird</application> versions 2.x and earlier to crash; this is not a problem with <application>Firefox</application> and <application>Thunderbird</application> versions 3.x and later.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Start Orca when you login</title>
<para>
-<keycombo><keycap>Alt</keycap><keycap>Shift</keycap><keycap>[1-6]</keycap></keycombo> - "Where am I" information for this bookmark relative to the current pointer location.
+When checked, this option will tell the system to automatically launch <application>Orca</application> when you log in.
</para>
-</listitem>
-<listitem>
+</section>
+</section>
+
+<section>
+<title>Speech Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/Speech_Tab.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Speech Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
<para>
-<keycombo><keycap>Insert</keycap><keycap>B</keycap></keycombo> and <keycombo><keycap>Insert</keycap><keycap>Shift</keycap><keycap>B</keycap></keycombo> - move between the given bookmarks for the given application or page.
+The speech page allows you to customize how <application>Orca</application> uses speech synthesis.
</para>
-</listitem>
-<listitem>
+
+<section>
+<title>Enable speech</title>
<para>
-<keycombo><keycap>Alt</keycap><keycap>Insert</keycap><keycap>B</keycap></keycombo> - save the defined bookmarks for the current application or page.
+The first control of note on the speech page is the "enable speech" check box. This check box toggles whether or not <application>Orca</application> will make use of a speech synthesizer. This option, along with the ability to enable braille and enable magnifier support, allow <application>Orca</application> to be tailored to meet the needs of a wide variety of users.
</para>
-</listitem>
-</itemizedlist>
</section>
<section>
-<title>Miscellaneous functions</title>
-<itemizedlist>
-<listitem>
-<para>
-<keycombo><keycap>Numpad</keycap><keycap>Plus</keycap></keycombo> - "say all" command; reads from the current position of the caret to the end of the document.
-</para>
-</listitem>
-<listitem>
+<title>Speech System and Speech Synthesizer</title>
<para>
-<keycombo><keycap>Numpad</keycap><keycap>Enter</keycap></keycombo> - "Where am I" command; speaks information such as the title of the current application window, as well as the name of the control that currently has focus.
+The next two controls deal with selecting the speech system and synthesizer. <application>Orca</application> provides support for a growing number of speech systems. At the time of this writing, these include GNOME-speech, Emacspeak, and an experimental backend for Speech Dispatcher. Depending upon how your machine is configured, you may have all or none of these options. Typically, you will have just GNOME-speech.
</para>
-</listitem>
-<listitem>
<para>
-<keycombo><keycap>Insert</keycap><keycap>H</keycap></keycombo> - enter into <application>Orca</application>'s "learn mode"; press <keycap>Escape</keycap> to exit.
+First, determine which speech system you would like to use - GNOME-speech works best at this time. After making your selection, tab to the speech synthesizer combo box and choose from the list of available synthesizers.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Voice Settings</title>
<para>
-<keycombo><keycap>Insert</keycap><keycap>F</keycap></keycombo> - speak font and attribute information for the current character.
+If your synthesizer supports it, <application>Orca</application> can utilize multiple voices in order to identify special cases within an application, such as hyperlinks or upper case text. The voice settings and person combo boxes can be adjusted to customize these settings to your liking. For example, assume you were using Fonix DECtalk and wanted the Betty voice to denote upper case. To accomplish this, you could do the following:
</para>
-</listitem>
-<listitem>
+<procedure>
+<step>
<para>
-<keycombo><keycap>Insert</keycap><keycap>Space</keycap></keycombo> - Launch the <application>Orca</application> Configuration dialog.
+Tab to the voice settings combo box, and down arrow until the upper case voice is selected.
</para>
-</listitem>
-<listitem>
+</step>
+<step>
<para>
-<keycombo><keycap>Insert</keycap><keycap>Control</keycap><keycap>Space</keycap></keycombo> - reload user settings and reinitialize services as necessary. Also launches the <application>Orca</application> Configuration dialog for the current application.
+Tab to the person combo box, and down arrow to choose the Betty voice.
</para>
-</listitem>
-<listitem>
+</step>
+</procedure>
<para>
-<keycombo><keycap>Insert</keycap><keycap>S</keycap></keycombo> - toggle speech on and off.
+The next three sliders in the tab order allow adjustment of the synthesizer's rate, pitch and volume, respectively.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Punctuation Level</title>
<para>
-<keycombo><keycap>Insert</keycap><keycap>F11</keycap></keycombo> - toggle the reading of tables, either by single cell or whole row.
+The punctuation level radio button group is used to adjust the amount of punctuation spoken by the synthesizer. The available levels are None, Some, Most and All.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Verbosity</title>
<para>
-<keycombo><keycap>Insert</keycap><keycap>Q</keycap></keycombo> - quit <application>Orca</application>.
+The verbosity setting determines the amount of information that will be spoken in certain situations. For example, if it is set to verbose, the synthesizer will speak shortcut keys for items in pull down menus. When it is set to brief, these shortcut keys are not announced.
</para>
-</listitem>
-</itemizedlist>
</section>
<section>
-<title>Commands for debugging</title>
-<itemizedlist>
-<listitem>
+<title>Table Row Speech</title>
<para>
-<keycombo><keycap>Insert</keycap><keycap>Home</keycap></keycombo> - report information on the currently active script.
+The table row speech option determines the way in which <application>Orca</application> will read items within tables. The available settings are "speak current row" or "speak current cell". The ability to adjust this behavior can be useful in many situations. For example, consider the process of browsing email messages in <application>Evolution</application>. In this instance it may be preferable to set table speech to "speak current row" so that while arrowing through the list of messages all relevant info, such as the sender, subject, and whether the message has attachments, is read automatically. While the current row setting is active, it is still possible to read individual cells by using the left and right arrows.
</para>
-</listitem>
-</itemizedlist>
<note>
<para>
-In order for the next three commands to be of use, <application>Orca</application> needs to be started from a virtual console or via gnome-terminal. Output is sent to the console only (i.e., it is not sent to speech or braille).
+You can quickly toggle this behavior by pressing <keycombo><keycap>Orca_Modifier</keycap><keycap>F11</keycap></keycombo>.
</para>
</note>
-<itemizedlist>
-<listitem>
+</section>
+
+<section>
+<title>Speak Progress Bar Updates</title>
<para>
-<keycombo><keycap>Insert</keycap><keycap>End</keycap></keycombo> - print a debug listing of all known applications to the console where <application>Orca</application> is running.
+If this setting is enabled, <application>Orca</application> will periodically announce the status of progress bars. How often the announcement is made is determined by the value chosen in the <guilabel>Update Interval</guilabel> spin button. Note that this spin button is only available if the "Speak progress bar updates" checkbox has been checked.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Speak Indentation and Justification</title>
<para>
-<keycombo><keycap>Insert</keycap><keycap>Page_Up</keycap></keycombo> - print debug information about the ancestry of the object with focus.
+When working with code or editing other documents it is often desirable to be aware of justification and indentation. Selecting the "Speak indentation and justification" check box will cause <application>Orca</application> to provide this information.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Speak Blank Lines</title>
<para>
-<keycombo><keycap>Insert</keycap><keycap>Page_Down</keycap></keycombo> - print debug information about the hierarchy of the application with focus.
+Some users desire to hear "blank" when navigating to a blank line in a document. Other users do not. If the "speak blank lines" check box is selected, <application>Orca</application> will speak blank lines.
</para>
-</listitem>
-</itemizedlist>
</section>
+
+<section>
+<title>Speak tutorial messages</title>
+<para>
+When moving from component to component in an interface, this option will provide spoken tutorial messages for how to work with the component.
+</para>
</section>
-<section id="orca-laptop-keys">
-<title>Laptop Layout</title>
+<section>
+<title>Say All By</title>
<para>
-Following is a list of common <application>Orca</application> keyboard commands for laptop keyboards arranged by category:
+This combo box allows you to specify whether the "say all" functionality of <application>Orca</application> speaks by sentence or line. See the Desktop Keyboard Layout (<xref linkend="orca-desktop-keys"/>) and Laptop Keyboard Layout (<xref linkend="orca-laptop-keys"/>) for how to invoke the "say all" functionality).
</para>
+</section>
+</section>
<section>
-<title>Flat review commands</title>
-<itemizedlist>
-<listitem>
+<title>Braille Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/Braille_Tab.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Braille Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>U</keycap></keycombo> - move the flat review cursor to the previous line and read it.
-Double-click to move flat review to the top of the current window.
+The braille page allows you to customize various aspects about the use of braille.
</para>
-</listitem>
-<listitem>
+<note>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>I</keycap></keycombo> - read the current line.
-Double-click to read the current line along with formatting and capitalization details.
+<application>Orca</application> does not automatically start BrlTTY for you; typically you need to do this yourself, usually at boot time.
</para>
-</listitem>
-<listitem>
+</note>
+
+<section>
+<title>Enable Braille Support</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>O</keycap></keycombo> - move the flat review cursor to the next line and read it. Double- click to move flat review to the bottom of the current window.
+The first control on the braille page is the "Enable braille support" check box. This check box toggles whether or not <application>Orca</application> will make use of a braille display. This option, along with the ability to enable braille and enable magnifier support, allow <application>Orca</application> to be tailored to meet the needs of a wide variety of users. By default, this check box is enabled. If BrlTTY is not running, <application>Orca</application> will recover gracefully and will not communicate with the braille display. If you configure BrlTTY later on, you need to restart <application>Orca</application> in order for it to use braille.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Enable Braille Monitor</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>J</keycap></keycombo> - move the flat review cursor to the previous word and read it.
-Double-click to move flat review to the word above the current word.
+<application>Orca</application>'s braille monitor provides an on-screen representation of what takes place on the braille display. This feature is mostly for demonstration purposes, but is also useful for <application>Orca</application> developers who do not have access to a braille display.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Abbreviated Role Names</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>K</keycap></keycombo> - read the current word.
-Double-click to spell the word. Triple-click to hear the word spelled phonetically.
+The "Abbreviated role names" check box determines the manner in which role names are displayed and can be used to help conserve real estate on the braille display. The "Abbreviated role names" option can be better understood if we consider the following example. Let us assume that a slider had focus, and that the abbreviated role names box was not checked. In this case, the word "slider" would be shown on the display, to reflect the fact that the current control was indeed a slider. If the abbreviated role names box were checked, the word "slider" would be abbreviated to "sldr".
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Disable end of line symbol</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>L</keycap></keycombo> - move the flat review cursor to the next word and read it. Double- click to move flat review to the word below the current word.
+When checked, this feature tells <application>Orca</application> to not present the "$l" string at the end of a line.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Contracted Braille</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>M</keycap></keycombo> - move the flat review cursor to the previous character and read it.
-Double-click to move flat review to the end of the current line.
+<application>Orca</application> supports contracted braille via the liblouis project. Refer to <ulink url="http://live.gnome.org/Orca/Braille#Braille";>the Orca WIKI</ulink>, where you can find additional information about setting up liblouis with <application>Orca</application>.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Verbosity</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Comma</keycap></keycombo> - read the current character. Double-click to pronounce the character phonetically if it is a letter.
+The verbosity radio button group determines the amount of information that will be brailled in certain situations. For example, if it is set to verbose, keyboard shortcut and role name information is displayed. This information is not displayed in brief mode.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Selection Indicator</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Period</keycap></keycombo> - move the flat review cursor to the next character and read it.
+When you select text, <application>Orca</application> will "underline" that text on your braille display with Dots 7 and 8. If you would prefer, you can change the indicator to only be Dot 7, only be Dot 8, or not be present at all.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Hyperlink Indicator</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>7</keycap></keycombo> - perform a left mouse click at the location of the flat review cursor.
+When you encounter a hyperlink, <application>Orca</application> will "underline" that text on your braille display with Dots 7 and 8. If you would prefer, you can change the indicator to only be Dot 7, only be Dot 8, or not be present at all.
</para>
-</listitem>
-<listitem>
+</section>
+</section>
+
+<section>
+<title>Key Echo Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/KeyEcho_Tab.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Key Echo Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>8</keycap></keycombo> - perform a right mouse click at the location of the flat review cursor.
+The key echo page allows you to specify the behavior of <application>Orca</application> when pressing keys on the page and whether words are spoken as you complete them.
</para>
-</listitem>
-<listitem>
+
+<section>
+<title>Enable Key Echo</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>8</keycap></keycombo> - perform a right mouse click at the location of the flat review cursor.
+The first control on the key echo page is the "Enable key echo" check box. When this box is selected, six additional check boxes become available. These are: "Enable alphanumeric and punctuation keys", "Enable modifier keys", "Enable locking keys", "Enable function keys", "Enable action keys", and "Enable navigation keys".
</para>
-</listitem>
-</itemizedlist>
-<note>
<para>
-The above commands apply when working with objects as well as when working with text. For example, if the flat review cursor were positioned on a menu bar, pressing the "read current line" command would speak the names of all visible menus. Similarly, pressing the "read next word" command would speak the object to the right of the flat review cursor on the same line, or move flat review to the next line if no more objects were found.
+The alphanumeric and function key groups are relatively self explanatory.
</para>
-</note>
-</section>
-
-<section>
-<title>Bookmark commands</title>
-<itemizedlist>
-<listitem>
<para>
-<keycombo><keycap>Alt</keycap><keycap>Caps_Lock</keycap><keycap>[1-6]</keycap></keycombo> - add a bookmark to the numbered slot. If a bookmark already exists for the slot it will be replaced with the new one.
+Modifier keys are those such as <keycap>Shift</keycap>, <keycap>Ctrl</keycap>, and <keycap>Alt</keycap>.
</para>
-</listitem>
-<listitem>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>[1-6]</keycap></keycombo> - go to the position pointed to by the bookmark bound to this numbered slot.
+Locking keys include <keycap>Caps Lock</keycap>, <keycap>Scroll Lock</keycap> and <keycap>Num Lock</keycap>.
</para>
-</listitem>
-<listitem>
<para>
-<keycombo><keycap>Alt</keycap><keycap>Shift</keycap><keycap>[1-6]</keycap></keycombo> - "Where am I" information for this bookmark relative to the current pointer location.
+The action keys group consists of keys that perform some logical action, such as <keycap>Backspace</keycap>, <keycap>Return</keycap> and <keycap>Tab</keycap>.
</para>
-</listitem>
-<listitem>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>B</keycap></keycombo>and <keycombo><keycap>Caps_Lock</keycap><keycap>Shift</keycap><keycap>B</keycap></keycombo> - move between the given bookmarks for the given application or page.
+The navigation keys group include the four arrow keys as well as any key combination in which the Orca Modifier key is being held down. The latter is designed to prevent <application>Orca</application> from echoing flat review commands.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Enable Echo by Word</title>
<para>
-<keycombo><keycap>Alt</keycap><keycap>Caps_Lock</keycap><keycap>B</keycap></keycombo> - save the defined bookmarks for the current application or page.
+The next toggle on the key echo page is the "Enable echo by word" check box, used to echo the word you just typed. The "Echo by word" control is always available, regardless of whether any of the key echo options are checked.
</para>
-</listitem>
-</itemizedlist>
</section>
<section>
-<title>Miscellaneous functions</title>
-<itemizedlist>
-<listitem>
+<title>Enable Echo by Sentence</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Semicolon</keycap></keycombo> - "Say all" command; reads from the current position of the caret to the end of the document.
+The last toggle on the key echo page is the "Enable echo by sentence" check box, used to echo the sentence you just typed. The echo by sentence control is always available, regardless of whether any of the key echo options are checked.
</para>
-</listitem>
-<listitem>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Enter</keycap></keycombo> - "Where am I" command; speaks information such as the title of the current application window, as well as the name of the control that currently has focus.
+In summary, the key echo scheme can offer a great deal of flexibility. For example, one user might choose to enable all key echo options, while another might prefer to use word echo, but only have locking keys announced.
</para>
-</listitem>
-<listitem>
+</section>
+</section>
+
+<section>
+<title>Magnifier Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/Magnifier_Tab.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Magnifier Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>H</keycap></keycombo> - enter learn mode (press <keycap>Escape</keycap> to exit).
+The magnifier page allows you to enable/disable magnification and specify how magnification is performed.
</para>
-</listitem>
-<listitem>
+
+<section>
+<title>Enable Magnifier</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>F</keycap></keycombo> - speak font and attribute information for the current character.
+The first control on the magnifier page is the "Enable magnifier" check box. This check box toggles whether or not <application>Orca</application> will provide magnification. This option, along with the ability to enable speech and enable braille support, allow <application>Orca</application> to be tailored to meet the needs of a wide variety of users.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Zoomer Settings</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Space</keycap></keycombo> - launch the <application>Orca</application> Configuration dialog.
+Two zoomer GUI controls determine magnification characteristics:
</para>
-</listitem>
+<itemizedlist>
<listitem>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Control</keycap><keycap>Space</keycap></keycombo> - reload user settings and reinitialize services as necessary; also launches the <application>Orca</application> Configuration dialog for the current application.
+"Scale factor", which sets magnification power from 1.0x to 16.0x (fractional values are supported).
</para>
</listitem>
<listitem>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>S</keycap></keycombo> - toggle speech on and off.
+"Position", which sets the location and size of the magnifier window: "Full Screen", "Left Half", "Right Half", "Top Half", "Bottom Half", and "Custom". The default position is "Full Screen". Choosing "Custom" causes four spin buttons to become available: "Top", "Left", "Right", and "Bottom". These spin buttons allow you to define the location of each edge of the zoom window. Units are in pixels.
</para>
</listitem>
-<listitem>
+</itemizedlist>
+</section>
+
+<section>
+<title>Border Settings</title>
+<note>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>F11</keycap></keycombo> - toggle the reading of tables, either by single cell or whole row.
+These options are not available in "Full Screen" mode.
</para>
-</listitem>
-<listitem>
+</note>
+
+<section>
+<title>Enable border</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Q</keycap></keycombo> - quit <application>Orca</application>.
+This option determines if a window border is visible for the magnifier.
</para>
-</listitem>
-</itemizedlist>
</section>
<section>
-<title>Commands for debugging</title>
-<itemizedlist>
-<listitem>
+<title>Border size</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Alt</keycap><keycap>Control</keycap><keycap>Home</keycap></keycombo> - report information on the currently active script.
+This value determines the size of the border in pixels.
</para>
-</listitem>
-</itemizedlist>
-<note>
+</section>
+</section>
+
+<section>
+<title>Cursor Settings</title>
<para>
-In order for the next three commands to be of use, <application>Orca</application> needs to be started from a virtual console or via <application>gnome-terminal</application>. Output is sent to the console only (i.e.,
-it is not sent to speech or braille).
+These controls can be used to customize the size and color of the magnifier's cursor.
</para>
-</note>
-<itemizedlist>
-<listitem>
+
+<section>
+<title>Enable cursor</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Alt</keycap><keycap>Control</keycap><keycap>End</keycap></keycombo> - prints a debug listing of all known applications to the console where <application>Orca</application> is running.
+If this check box is enabled then a cursor is visible and the size and color options become available.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Custom size</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Alt</keycap><keycap>Control</keycap><keycap>Page_Up</keycap></keycombo> - prints debug information about the ancestry of the object with focus.
+Enable this check box if you would like to make the mouse pointer larger than it normally is. The cursor size can be changed from the default value of 32 pixels.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Custom color</title>
<para>
-<keycombo><keycap>Caps_Lock</keycap><keycap>Alt</keycap><keycap>Control</keycap><keycap>Page_Down</keycap></keycombo> - prints debug information about the object hierarchy of the application with focus.
+If the cursor is enabled, a custom color can also be applied.
</para>
-</listitem>
-</itemizedlist>
</section>
</section>
-</section>
<section>
-<title>Application-Specific Information</title>
+<title>Cross-hair Settings</title>
+<para>
+This set of controls can be used to customize the magnifier's optional area-targeting cursor.
+</para>
+
<section>
-<title>Accessible Applications</title>
+<title>Enable cross-hair</title>
<para>
-<application>Orca</application> is designed to work with applications and toolkits that support the Assistive Technology Service Provider Interface (AT-SPI). This includes the GNOME Desktop and its bundled applications: OpenOffice, Firefox, and the Java platform. Some applications work better than others, however, and the <application>Orca</application> community continually works to provide superior access to more and more applications.
+If checked, you can additionally configure the clipping behavior, size and color of the cross-hair.
</para>
</section>
<section>
-<title>Using Adobe's Acrobat Reader</title>
+<title>Enable cross-hair clip</title>
<para>
-We are currently working on a script for Adobe's Acrobat Reader, and the initial version has been contributed to <application>Orca</application> v2.17.5. Note that there is still work to do, and we are very encouraged by Adobe's commitment to accessibility.
+If enabled, the cross-hair will be "clipped" (removed) in the area immediately surrounding the mouse pointer.
</para>
+</section>
<section>
-<title>Installation</title>
+<title>Cross-hair size</title>
<para>
-If you get Adobe Acrobat Reader directly from the <ulink url='http://www.adobe.com/products/acrobat/readstep2.html'>Adobe site</ulink>, you may find that the software will not launch. If launched from the Applications menu, it may appear that nothing has happened, or if launched from a terminal window you may receive a long series of syntax error messages. Should this occur, you will need to edit your /usr/bin/acroread file as described in this <ulink url='http://ubuntuforums.org/showthread.php?t=233514'>Ubuntu forum thread</ulink>.
+This control sets the thickness of the cross-hair in pixels.
</para>
+</section>
+
+<section>
+<title>Cross-hair color</title>
<para>
-If you instead choose to install Acrobat Reader from your distribution's packages, be sure to install both <application>acroread</application> and <application>acroread-plugins</application>. Without the plugins package, you will not have the access to the "Reading" category in the <menuchoice>
-<guimenuitem>Edit-</guimenuitem>
-<guimenuitem>Preferences</guimenuitem>
-</menuchoice> dialog.
+This control allows a custom color to be used for the cross-hair.
</para>
+</section>
+</section>
+
+<section>
+<title>Color Settings</title>
<para>
-Note: If you use Ubuntu and cannot locate the
-<application>acroread</application> package, you will likely need to edit your /etc/apt/sources.list to include the 'multiverse' repository. Then run <userinput>apt-get update</userinput>. Having done so, you should then be able to install both <application>acroread</application> and <application>acroread-plugins</application>.
+This allows you to do some rough color adjustments of the magnified region.
</para>
-</section>
<section>
-<title>Enabling Accessibility and Caret Navigation</title>
+<title>Invert colors</title>
<para>
-Once you've installed Reader, you need to enable accessibility:
+Creates a reverse or negative-image effect.
</para>
-<orderedlist numeration='arabic'>
-<listitem>
+</section>
+
+<section>
+<title>Brightness</title>
<para>
-In the "Accessibility" tab of the
-<menuchoice>
-<guimenuitem>Edit-</guimenuitem>
-<guimenuitem>Preferences</guimenuitem>
-</menuchoice> dialog, make sure
-<guilabel>Always display the keyboard selection cursor</guilabel> (<keycombo>
-<keycap>Alt</keycap><keycap>D</keycap>
-</keycombo>) is checked.
+Ranges from -1 to 1 (-1 is black/no brightness; 1 is white/total brightness; 0 is "normal"/unchanged).
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Contrast</title>
<para>
-In the "Reading" tab of the
-<menuchoice>
-<guimenuitem>Edit-</guimenuitem>
-<guimenuitem>Preferences</guimenuitem>
-</menuchoice> dialog, make sure
-<guilabel>Enable Document Accessibility
-</guilabel> ((<keycombo><keycap>Alt</keycap>
-<keycap>E</keycap></keycombo>) is checked.
+Ranges from -1 to 1 (-1 is grey/no contrast; 1 is maximum contrast; 0 is "normal"/unchanged).
</para>
-</listitem>
-</orderedlist>
+</section>
</section>
<section>
-<title>Working with Untagged Documents</title>
+<title>Tracking and Alignment Settings</title>
<para>
-When you open an untagged document, you will be presented with a dialog box asking you to specify the reading order and the reading mode options. The default reading order is
-<guilabel>Infer reading order from document
-</guilabel>. This setting works well for most documents.
+These options control the tracking of the mouse cursor.
</para>
+
+<section>
+<title>Mouse pointer</title>
<para>
-The default reading mode will vary depending on the length of the document; for short documents, the default is <guilabel>Read the entire document</guilabel>; for long documents the default is <guilabel>Read currently visible pages only</guilabel>. <application>Orca</application> tends to work better when <guilabel>Read the entire document</guilabel> is selected.
+Choose from the following options:
</para>
+
+<section>
+<title>Centered</title>
<para>
-If you find that a document seems to be missing parts of the text, try changing the reading options. To do so, get into the Document menu and select <guilabel>Change Accessibility Reading Options...</guilabel> or use the shortcut <keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>5</keycap></keycombo>.
+Keeps the mouse pointer at the center of the screen whenever possible. This is the default.
</para>
</section>
<section>
-<title>Page Layout</title>
+<title>Proportional</title>
<para>
-The best page layout for reading a document with <application>Orca</application> is <guilabel>Single Page</guilabel>. When <guilabel>Continuous</guilabel> is chosen, moving focus to text as the page is scrolling
-can cause that text not to be read. You can change the page layout to <guilabel>Single Page</guilabel> by getting into the View menu and selecting the Page Layout submenu.
+Positions the mouse pointer in the zoom window relative to its actual, unmagnified position. For instance, if the mouse pointer is 25% away from the left edge of the desktop, <application>Orca</application> positions the magnified mouse pointer 25% from the left edge of the zoom window.
</para>
</section>
<section>
-<title>Navigating Tables</title>
+<title>Push</title>
<para>
-As far as we know there isn't currently a whole lot of keyboard support for tables in
-<application>Acrobat Reader</application>. We hope Adobe will remedy this soon.
+Moves the zoomer window the least amount necessary to keep the mouse pointer on the screen.
</para>
+</section>
+
+<section>
+<title>None</title>
<para>
-Basically, there are the arrow keys. Their behavior is to move you first within the cell with focus, then to the next cell with data in it. Note that currently, Up and Down Arrow do not seem to move you vertically among cells - at least that has been the experience
-with the tables we have tried. Instead, Up and Down seem to move you horizontally until you run out of cells on the current row.
+Moving the mouse pointer has no impact on what the zoomer window displays.
</para>
</section>
</section>
<section>
-<title>Making Application-Specific Settings</title>
-<para>
-To customize the settings for a particular application, you will first need to run that application. Make sure the application has focus, then press <keycombo><keycap>ORCA_MODIFIER</keycap>
-<keycap>Control</keycap><keycap>Space</keycap>
-</keycombo> (by default, this will be
-<keycombo><keycap>Insert</keycap><keycap>Control</keycap>
-<keycap>Space</keycap></keycombo> for the Desktop keyboard layout).
-</para>
+<title>Pointer follows zoomer</title>
<para>
-This brings up a tabbed dialog window very similar to the <application>Orca</application> configuration dialog, but with the following differences:
+This option is enabled by default. If the mouse pointer is not on the screen when you initially move the mouse, it will be moved into the zoomer so that you can continue to see what you were working on. If your preferred mouse tracking mode is centered, the pointer will be moved to the center; otherwise it will be moved to the item with focus.
</para>
-<orderedlist numeration='arabic'>
-<listitem>
+</section>
+
+<section>
+<title>Control and menu item</title>
<para>
-There is no initial General pane.
+These options control additional behavior of the magnifier.
</para>
-</listitem>
-<listitem>
+
+<section>
+<title>Centered</title>
<para>
-The Speech System and Speech Synthesizer combo
-boxes on the Speech pane will be grayed out (made inactive).
+When navigating via keyboard, keep the focused dialog box control or menu item at the center of the screen whenever possible.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Push</title>
<para>
-Any existing application-specific key bindings will appear at the top of the list on the Key Bindings pane.
+When navigating via keyboard, move the zoomer window the least amount necessary to display the focused dialog box control or menu item. This is the default.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>None</title>
<para>
-There may be a new application-specific settings pane at the end of the set of tabbed panes. Note that pressing the End key from the tab list will get you directly to the right-most tab.
+Using the keyboard to navigate among dialog box controls and menu items will have no impact on what the zoomer window displays.
</para>
-</listitem>
-</orderedlist>
+</section>
+
+<section>
+<title>Pointer follows focus</title>
<para>
-Adjust your application-specific settings in the same way you set your general <application>Orca</application> preferences.
-For example, you may have Key Echo disabled generally in <application>Orca</application> but would like to specifically have it enabled for the <application>gcalctool</application> (GNOME Calculator) application. Here's where you could easily set that.
+If this option is enabled, the mouse pointer will follow you as you arrow through menu items and move among controls in dialog boxes. This option is disabled by default.
</para>
+</section>
+</section>
+
+<section>
+<title>Text cursor</title>
<para>
-When you have your application settings customized the way you want, press the <guilabel>OK</guilabel> button. These settings will be written to your
-<userinput>~/.orca/app-settings</userinput> directory in a file called
-<userinput><APPNAME>.py</userinput>, where <userinput><APPNAME></userinput> is the name of the application.
+These options control how the text cursor behaves.
</para>
+
+<section>
+<title>Centered</title>
<para>
-These files are automatically written by <application>Orca</application>. The contents of the file will be overwritten each time you change your application settings for that
-application.
+As the text cursor moves, keep it at the center of the screen whenever possible.
</para>
+</section>
+
+<section>
+<title>Push</title>
<para>
-If you want to have some extra application-specific settings or code that you don't want to lose, then you should put it in a file called <userinput>~/.orca/app-settings/<APPNAME>-customizations.py</userinput>. This file will be automatically read when the settings for the
-<userinput><APPNAME></userinput> application are loaded.
+As the text cursor moves, move the zoomer window the least amount necessary to display it. This is the default.
</para>
+</section>
+
+<section>
+<title>None</title>
<para>
-Note that this is an advanced feature that we don't expect many people to use. It's just there if you really want it.
+Moving the text cursor will have no impact on what the zoomer window displays.
</para>
+</section>
+
+<section>
+<title>Edge margin</title>
<para>
-There is currently one known bug (some people would call it a feature) that we are trying to track down and fix:
+The edge margin is how close the caret should be allowed to get to the edge of the screen before it's time to "push" the zoomer window. The margin can range from 0 to 50%, with 50% being the equivalent of choosing centering. The default value is 0.
</para>
<note>
<para>
-If you adjust one or more application-specific key bindings, the new values will not take effect until you've pressed the <guilabel>OK</guilabel> button. The work-around is to either restart <application>Orca</application>, or Alt-Tab
-away to some other application and then Alt-Tab back to the one that you've just changed the key bindings for.
+This option is only available if "Push" is your text cursor tracking mode.
</para>
</note>
</section>
</section>
+</section>
<section>
-<title>Braille</title>
+<title>Advanced Settings</title>
<para>
-<application>Orca</application> uses
-<ulink url='http://mielke.cc/brltty/'>BrlTTY</ulink> for braille support. On Linux systems, BrlTTY is used to access the text mode console content. On a typical braille-enabled installation of Linux, BrlTTY is already running and providing access to the text consoles. When Orca starts, it connects to BrlTTY. If you switch from a text console to your X Windows session, your braille display will automatically follow and display the content that Orca is presenting to you.
+If you press the Advanced Settings button located near the bottom of the Magnifier page, the following dialog will appear:
</para>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/Magnifier_Advanced.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Magnifier - Advanced Settings
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
+<section>
+<title>Smoothing</title>
<para>
-<application>Orca</application> attempts to work with various releases of BrlTTY. It works well with BrlTTY v3.7.2, and we've also been working with the BrlTTY team to get it going for BrlTTY v3.8. The remainder of this document provides information related to using <application>Orca</application> with <application>BrlTTY</application> 3.8.
+Bilinear or none.
</para>
+</section>
+<section>
+<title>Brightness</title>
<para>
-Below are descriptions of the necessary tasks to install/setup BrlTTY in Ubuntu and Solaris. For both, you need to first obtain
-<ulink url='http://mielke.cc/brltty/releases/
-brltty-3.8.tar.gz'>brltty-3.8.tar.gz</ulink> from the BrlTTY site.
+Red, Green, Blue: Individual controls for choosing customized brightness levels. Choosing different brightness levels for each color allows you to create the color scheme that works best for you.
</para>
+</section>
<section>
-<title>BrlTTY 3.8 on Ubuntu</title>
+<title>Contrast</title>
<para>
-First, configure your build environment to build BrlTTY. Much of this setup is done for you automatically in the Ubuntu distribution with products such as G++ already present. In addition, <emphasis>you must</emphasis>
-also install tcl, Pyrex, and the Python developer environment. To do this, execute the following commands as <userinput>root</userinput>:
+Red, Green, Blue: Individual controls for choosing customized contrast levels. While not as significant as changes to brightness, choosing different contrast levels for each color helps you to create the color scheme that works best for you.
</para>
-<para></para>
-<screen>
-<![CDATA[apt-get build-dep brltty
-apt-get install tcl8.4 python-pyrex python-dev
-]]>
-</screen>
+</section>
+
+<section>
+<title>Color Filtering</title>
<para>
-Then, when you build BrlTTY, avoid configuring the package with --prefix=/usr. Use the standard procedure instead, executing the following commands as <userinput>root</userinput>:
+Allows you to pick one of the colorblind filters available through libcolorblind.
</para>
-<para></para>
-<screen>
-<![CDATA[gunzip -c brltty-3.8.tar.gz | tar xvf -
-cd brltty-3.8
-./autogen
-./configure
-make
-make install
-]]>
-</screen>
+<note>
<para>
-Run BrlTTY as <userinput>root</userinput>:
+In order to take advantage of this feature you will need to install libcolorblind and then rebuild gnome-mag.
</para>
-<para></para>
-<screen>
-<![CDATA[/bin/brltty -bauto -d/dev/ttyUSB0
-]]>
-</screen>
+</note>
+</section>
+
+<section>
+<title>Multi-Monitor Settings - Source Display</title>
<para>
-If you want, you can remove the existing
-<userinput>/sbin/brltty</userinput> and replace it with the <userinput>/bin/brltty</userinput>, either by copying the <userinput>/bin/brltty</userinput> to <userinput>/sbin/brltty</userinput> or just by making a
-symbolic link. Do so at your own risk.
+X Window System DISPLAY of what should be magnified. Written in the form ":0.x" where x is the number of the screen whose contents should be magnified.
</para>
-<para />
-</section>
</section>
<section>
-<title>Troubleshooting</title>
-<section>
-<title>Orca is not speaking. What is going wrong?</title>
+<title>Multi-Monitor Settings - Target Display</title>
<para>
-See
-<ulink url='http://live.gnome.org/Orca/GnomeSpeech'>
-Troubleshooting Speech</ulink>.
+X Window System DISPLAY of where to put the zoomer window. Written in the form ":0.y" where y is the number of the screen where the zoomer window should appear.
</para>
</section>
+</section>
+</section>
<section>
-<title>My desktop has stopped responding. What do I do?
-</title>
+<title>Key Bindings Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/KeyBindings_Tab.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Key Bindings Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
<para>
-Press <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> or <keycombo><keycap>Meta</keycap><keycap>R</keycap></keycombo> to open the Run dialog and restart <application>Orca</application> by running a new instance: type <userinput>orca</userinput> and press <keycap>Enter</keycap>. This will force any existing <application>Orca</application> processes to exit and will then restart <application>Orca</application>. This
-sometimes has the effect of unhanging the desktop (which is usually due to an ill-behaved application).
+The key bindings page allows you to examine and modify the key bindings for <application>Orca</application>.
</para>
+
+<section>
+<title>Orca Modifier Key(s)</title>
<para>
-If you cannot get to a terminal window, try
-pressing <keycombo><keycap>Ctrl</keycap>
-<keycap>Alt</keycap><keycap>Backspace</keycap>
-</keycombo>: shut down the X Window System server. This should return you to the login screen.
+The first control on the key bindings page allows you to examine which key (or keys) acts as the "<application>Orca</application> modifier." The <application>Orca</application> modifier is the key that you press and hold in conjunction with other keys to give commands to <application>Orca</application>. For desktop keyboards, the Orca modifier defaults to <keycap>Insert</keycap>. For laptop keyboards, the <application>Orca</application> modifier defaults to the <keycap>Caps Lock</keycap> key. See the Desktop Keyboard Layout (<xref linkend="orca-desktop-keys"/>) and Laptop Keyboard Layout (<xref linkend="orca-laptop-keys"/>) sections for the default values.
</para>
-</section>
-</section>
+<note>
+<para>
+You cannot modify the <application>Orca</application> modifier key(s) using the Configuration GUI at this time.
+</para>
+</note>
</section>
-<section id="themes-0">
-<title>Desktop Appearance Enhancement</title>
+<section>
+<title>Key Bindings Table</title>
<para>
-This chapter describes the methods you can use to change the appearance of the GNOME Desktop in order to enhance the accessibility of the desktop for users with visual
-impairments.
+The key bindings table provides a list of <application>Orca</application> operations and the keys that are bound to them.
</para>
-
-<section id="themes-1">
-<title>Customization Options</title>
-<indexterm>
-<primary>customizing the desktop appearance</primary>
-</indexterm>
<para>
-There are several ways to customize the appearance of the GNOME Desktop to suit your
-specific needs:
+The "Function" column header is a description of the <application>Orca</application> operation to be performed.
</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 them to achieve the type of desktop environment that you require.
+The "Key Binding" header is the primary way to invoke the function from the keyboard. Note that the function description may include the word "Orca". This indicates that the <application>Orca</application> modifier key should be held down along with the other keys.
</para>
-</listitem>
-</varlistentry>
-<varlistentry>
-<term>Desktop and Application-Specific Configuration Settings
-</term>
-<listitem>
<para>
-You can customize different components of the desktop to achieve the display settings that you require. You can configure the desktop and applications in addition to using themes or as an alternative to themes. See <xref linkend="themes-7"/> for more information.
+The "Alternate" header provides an alternate mechanism for invoking the function from the keyboard.
</para>
-</listitem>
-</varlistentry>
-</variablelist>
<para>
-The following table summarizes the changes that you can make to the GNOME Desktop and where you can make the changes. This guide 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 Help for each tool or to the <ulink type="help" url="ghelp:user-guide?prefs">User Guide</ulink>.
+To modify either the "Key Binding" or the "Alternate" bindings, arrow to the cell and press <keycap>Return</keycap>. Then, press a key combination and press <keycap>Return</keycap> to confirm the new combination. When you do so, the new keystroke will be saved and the check box in the last column (the "Modified" column) will indicate that the key binding has been modified.
</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">
-<colspec colname="colspec0" colwidth="33.04*"/>
-<colspec colname="colspec1" colwidth="14.50*"/>
-<thead>
-<row rowsep="1">
-<entry valign="top">
-<para>To change the...</para>
-</entry>
-<entry valign="top">
-<para>Use...
+<para>
+To undo a modified keybinding, merely arrow to the modified column, uncheck the checkbox, and press the "Apply" button <keycombo><keycap>Alt</keycap><keycap>A</keycap></keycombo>.
</para>
-</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry valign="top">
<para>
-Overall appearance of the desktop using high-contrast colors, low-contrast colors, or large print.
+Beneath the list of <application>Orca</application> keybindings, you will find a group of "unbound" commands:
</para>
-</entry>
-<entry valign="top">
-<para>The <guilabel>Theme</guilabel> section of the <application>Appearance</application> preference tool.
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/KeyBindings_Tab_Unbound.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Key Bindings Page showing the 'unbound' group of commands
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+<para>
+These are commands which we feel will be very useful for some users, but not needed by most users. Rather than "use up" a keystroke for such commands, we have left them unassigned. You can assign a keystroke to any of these unbound commands by following the procedure outlined above. In addition, you can unbind any bound command in a similar fashion: press <keycap>Return</keycap> to edit the keybinding, and when prompted for the new keybinding, press <keycap>Delete</keycap> or <keycap>Backspace</keycap>. You will be told that the key binding has been removed. Press <keycap>Return</keycap> to confirm.
</para>
-</entry>
-</row>
-<row>
-<entry valign="top">
+</section>
+</section>
+
+<section>
+<title>Pronunciation Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/Pronunciation_Tab.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Pronunciation Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+<para>
+Sometimes your speech synthesizer just doesn't say the right thing for a given string. You might prefer to hear "laughing out loud" rather than "LOL." Or there may be a name or a technical term which the synthesizer mispronounces. The pronunciation page is where you can add, edit, and delete <application>Orca</application>'s pronunciation dictionary entries. Because the pronunciation page is also part of the application-specific settings dialog that's started when you give a particular application focus and type <keycombo><keycap>Orca_Modifier</keycap><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo>, you can customize your entries on an as-needed basis for each application you use.
+</para>
+
+<section>
+<title>Add a new dictionary entry</title>
+<procedure>
+<step>
+<para>
+Press the <guibutton>New Entry</guibutton> button (<keycombo><keycap>Alt</keycap><keycap>N</keycap></keycombo>).
+</para>
+</step>
+<step>
+<para>
+Type the text of the new entry and press <keycap>Return</keycap> to finish editing the actual string.
+</para>
+</step>
+<step>
+<para>
+Move to the Replacement String column and press <keycap>Return</keycap> to begin editing.
+</para>
+</step>
+<step>
+<para>
+Type the text that you would like to have spoken instead and press <keycap>Return</keycap> to finish editing the replacement string.
+</para>
+</step>
+</procedure>
+</section>
+
+<section>
+<title>Edit an existing dictionary entry</title>
+<procedure>
+<step>
<para>
-Appearance of the desktop background only.
+Move to the cell you wish to edit and press <keycap>Return</keycap> to begin editing.
</para>
-</entry>
-<entry valign="top">
+</step>
+<step>
<para>
-The <guilabel>Desktop Background</guilabel> section of the <application>Appearance</application> preference tool; also the file manager <guilabel>Backgrounds and Emblems</guilabel> menu item.
+Make your changes and then press <keycap>Return</keycap> to finish editing.
</para>
-</entry>
-</row>
+</step>
+</procedure>
+</section>
-<row>
-<entry valign="top">
+<section>
+<title>Delete an existing dictionary entry</title>
+<procedure>
+<step>
<para>
-Appearance of the mouse pointer.
+Move to the entry you wish to delete.
</para>
-</entry>
-<entry valign="top">
+</step>
+<step>
<para>
-The <guilabel>Theme</guilabel> section of the <application>Appearance</application> preference tool; use the <guilabel>Pointers</guilabel> tab of the <guilabel>Customize</guilabel> option.
+Press the Delete button or <keycombo><keycap>Alt</keycap><keycap>D</keycap></keycombo>.
</para>
-</entry>
-</row>
+</step>
+</procedure>
+</section>
+</section>
-<row>
-<entry valign="top">
+<section>
+<title>Text Attributes Page</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata
+fileref="figures/TextAttributes_Tab.png"
+format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>
+<application>Orca</application> GUI Configuration - Text Attributes Page
+</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
<para>
-Font displayed on the desktop background and
-in all desktop applications.
+<application>Orca</application> will speak known text attribute information about an object when you press <keycombo><keycap>Insert</keycap><keycap>F</keycap></keycombo> (desktop layout) or <keycombo><keycap>Caps_Lock</keycap><keycap>F</keycap></keycombo> (laptop layout). Because the number of text attributes is large, and not everyone cares about every attribute, the "Text Attributes" tab of the configuration
+GUI allows you to customize which text attributes <application>Orca</application> will present.
</para>
-</entry>
-<entry valign="top">
<para>
-The <guilabel>Font</guilabel> section of the <application>Appearance</application> preference tool.
+On this tab is a text attribute list, where each row consists of four columns:
</para>
-</entry>
-</row>
-<row>
-<entry valign="top">
+<itemizedlist>
+<listitem>
<para>
-Default font settings of the <application>Text Editor</application>, <application>Terminal</application> or <application>Help</application> application.
+The name of the text attribute.
</para>
-</entry>
-<entry valign="top">
+</listitem>
+<listitem>
<para>
-Normally these applications use the default
-application font that is specified in the <guilabel>Font</guilabel> section of the <application>Appearance</application> preference tool, but these font settings can also be overridden in the <guilabel>Preferences</guilabel> dialog for the application.
+A checkbox which the user can set to indicate whether this text attribute should be spoken or not.
</para>
-</entry>
-</row>
-</tbody>
-</tgroup>
-</table>
-</section>
-
-<section id="themes-2">
-<title>Using Themes to Customize the Desktop</title>
+</listitem>
+<listitem>
<para>
-This section describes how to use themes to customize the appearance of the GNOME Desktop.
+A checkbox which the user can set to indicate whether this text attribute should be "underlined" on the braille display.
</para>
-
-<section id="themes-3">
-<title>Introduction to Themes</title>
-<indexterm>
-<primary>themes</primary>
-</indexterm>
+</listitem>
+<listitem>
<para>
-A theme is a group of coordinated settings that specifies how a desktop component or a group of desktop components appears. You can use themes to modify and control the appearance of the desktop in a consistent manner. 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. Some themes have suggested font settings that may optionally be auto-set; in addition, most colors within a theme can be customized.
+An editable "Present unless" string value. By default, not all text attributes will have this set. If present, what it means (assuming the user wants this text attribute presented) is that the value of the attribute will only be presented if it is <emphasis>not</emphasis> this value.
</para>
<para>
-A theme contains settings that affect different parts of the desktop:
+For example, by default the "underline" text attribute has a value of "none." If the user has this attribute checked and the user types
+<keycombo><keycap>Orca_Modifier</keycap><keycap>F</keycap></keycombo> and the text in question is not underlined, then this
+attribute is not spoken. If you always want this attribute to be spoken irrespective of whether the text is underlined, then the
+attribute should be checked and the "Present unless" value cleared.
</para>
-<variablelist>
-<varlistentry>
-<term>Controls</term>
+</listitem>
<listitem>
<para>
-The controls setting for a theme determines the visual appearance of all windows, applications, panels, and panel applications. The controls setting also determines the visual appearance of the GNOME-compliant interface items that appear on windows, applications, panels, and panel applications such as menus, icons, and buttons. Some of the control options that are available in the desktop are designed for special accessibility needs.
+There is also a <guibutton>Reset</guibutton> button (<keycombo><keycap>Alt</keycap><keycap>R</keycap></keycombo>) which will set the list values back to their initial state when the dialog was first displayed.
</para>
</listitem>
-</varlistentry>
-<varlistentry>
-<term>Window Border</term>
+</itemizedlist>
+<para>
+When you initially display the text attribute pane, all your checked attributes are put at the top of the list. They are given in the order that they will be spoken and brailled.
+</para>
+<para>
+If you decide to check others or adjust the order, there are four buttons to help you do this:
+</para>
+<itemizedlist>
<listitem>
<para>
-The window frame setting determines the appearance of the border around windows only.
+<guibutton>Move to top</guibutton> (<keycombo><keycap>Alt</keycap><keycap>T</keycap></keycombo>) - moves the selected attribute to the top of the list.
</para>
</listitem>
-</varlistentry>
-<varlistentry>
-<term>Icon</term>
<listitem>
<para>
-The icon setting determines the appearance of icons on panels and on the desktop background.
+<guibutton>Move up one</guibutton> (<keycombo><keycap>Alt</keycap><keycap>U</keycap></keycombo>) - moves the selected attribute up one row.
</para>
</listitem>
-</varlistentry>
-</variablelist>
-</section>
-
-<section id="themes-4">
-<title>Choosing Themes</title>
-<indexterm>
-<primary>themes</primary>
-<secondary>desktop</secondary>
-</indexterm>
-<para>To choose a theme, perform the following steps:
-</para>
-<orderedlist>
<listitem>
<para>
-Choose <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu><guimenuitem>Appearance
-</guimenuitem></menuchoice>. The themes
-are listed under the <guilabel>Theme</guilabel> tab.
+<guibutton>Move down one</guibutton> (<keycombo><keycap>Alt</keycap><keycap>D</keycap></keycombo>) - moves the selected attribute down one row.
</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, and may also prompt whether to apply a suggested font for the theme.
+<guibutton>Move to bottom</guibutton> (<keycombo><keycap>Alt</keycap><keycap>B</keycap></keycombo>) - moves the selected attribute to the bottom of the list.
</para>
+</listitem>
+</itemizedlist>
<para>
-There are several themes available that suit different accessibility needs, as described in the following table:
+Beneath these push buttons is the Braille Indicator group of radio buttons. Here you can select the cell or cells to be used to indicate text which has at least one of the specified attributes. Your choices are:
</para>
-<table frame="topbot" id="themes-TBL-2">
-<title>Themes Designed for Accessibility Requirements
-</title>
-<tgroup cols="2" colsep="0" rowsep="0">
-<colspec colname="colspec0" colwidth="50*"/>
-<colspec colname="colspec1" colwidth="50*"/>
-<thead>
-<row rowsep="1">
-<entry valign="top">
-<para>Theme Name</para>
-</entry>
-<entry valign="top">
-<para>Description</para>
-</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry valign="top">
+<itemizedlist>
+<listitem>
<para>
-<guilabel>High Contrast</guilabel>
+None (the default)
</para>
-</entry>
-<entry valign="top">
+</listitem>
+<listitem>
<para>
-Provides dark text on a light background using high-contrast colors.
+Dot 7
</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0" valign="top">
+</listitem>
+<listitem>
<para>
-<guilabel>High Contrast Inverse</guilabel>
+Dot 8
</para>
-</entry>
-<entry colname="colspec1" valign="top">
+</listitem>
+<listitem>
<para>
-Provides light text on a dark background using high-contrast colors.
+Dots 7 and 8
</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0" valign="top">
+</listitem>
+</itemizedlist>
<para>
-<guilabel>Large Print</guilabel>
+Text attributes can also be set on an individual application basis. The text attribute pane is also part of the application-specific settings dialog that's started when you give a particular application focus and type <keycombo><keycap>Orca_Modifier</keycap><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo>.
</para>
-</entry>
-<entry colname="colspec1" valign="top">
+</section>
+</section>
+
+<section>
+<title>Orca Keyboard Commands</title>
<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.
+You can get a complete list of available keyboard commands by visiting the <guilabel>Key Bindings</guilabel> page of the <application>Orca</application> Configuration GUI. To bring up the <application>Orca</application> Configuration GUI, press <keycombo><keycap>Orca_Modifier</keycap><keycap>Space</keycap></keycombo>, where <userinput>Orca_Modifier</userinput> is the <keycap>Insert</keycap> key for the <link linkend="orca-desktop-keys">desktop layout</link> and the <keycap>Caps_Lock</keycap> key for the <link linkend="orca-laptop-keys">laptop layout</link>. Note that you can also enter <application>Orca</application>'s "learn mode" while running <application>Orca</application> by pressing <keycombo><keycap>Orca_Modifier</keycap><keycap>H</keycap></keycombo>. When in learn mode, <application>Orca</application> will intercept all keyboard and braille input events and tell you what the effect would be. To exit learn mode, press the <keycap>Escape</keycap> key.
</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0" valign="top">
+<note>
<para>
-<guilabel>High Contrast Large Print</guilabel>
+<application>Orca</application> provides additional commands for some applications, such as <application>Firefox</application>. To get the list of additional commands for an application, press <keycombo><keycap>Ctrl</keycap><keycap>Orca_Modifier</keycap><keycap>Space</keycap></keycombo> when that application has focus. This will bring up the <application>Orca</application> Configuration GUI in the "application-specific" state, and the additional commands will appear in the <guilabel>Key Bindings</guilabel> page.
</para>
-</entry>
-<entry colname="colspec1" valign="top">
<para>
-This theme suggests an increased font size of 18pt using dark text on a light background. To apply the suggested font, click on the <guibutton>Apply Font</guibutton> button.
+The GNOME Desktop itself also has <ulink url="http://library.gnome.org/users/user-guide/stable/shortcuts-global.html.en";>built in keyboard commands</ulink> to control the desktop and its applications.
</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0" valign="top">
<para>
-<guilabel>High Contrast Large Print Inverse</guilabel>
+WARNING: the MouseKeys functionality of AccessX can interfere with the <application>Orca</application> modifier key (see <ulink url="http://bugzilla.gnome.org/show_bug.cgi?id=548169";>bug 548169</ulink>), resulting in odd behavior. In particular, MouseKeys uses the <keycap>KP_Insert</keycap> key to emulate a mouse button press. When enabled, MouseKeys can conflict with <keycap>KP_Insert</keycap> as the <application>Orca</application> modifier, resulting in what appears to be a stuck <application>Orca</application> modifier key. As an alternative, you can use the <link linkend="orca-laptop-keys">laptop key bindings</link>, which avoids the keypad for <application>Orca</application> commands. If you accidentally enabled MouseKeys, you can disable it via the <application>gnome-keyboard-properties</application> application.
</para>
-</entry>
-<entry colname="colspec1" valign="top">
+</note>
+
+<section id="orca-desktop-keys">
+<title>Desktop Layout</title>
<para>
-This theme suggests an increased font size of 18pt using light text on a dark background. To apply the suggested font, click on the <guibutton>Apply Font</guibutton> button.
+Following is a list of common <application>Orca</application> keyboard commands for desktop keyboards arranged by category:
</para>
-</entry>
-</row>
-</tbody>
-</tgroup>
-</table>
-</listitem>
-</orderedlist>
+
+<section>
+<title>Flat review commands</title>
+<itemizedlist>
+<listitem>
<para>
-In some GNOME distributions there are also prebuilt low-contrast/low-contrast-large-print themes to complement the high-contrast theme set.
+<keycap>Numpad-7</keycap> - move the flat review cursor to the previous line and read it.
</para>
+</listitem>
+<listitem>
<para>
-To view the controls, window frame, and icon settings that are associated with a theme, select a theme in the <guilabel>Appearance </guilabel> preference tool, then click on the <guibutton>Theme</guibutton> tab. The <guilabel>Customize</guilabel> option contains a tabbed section for each setting category. Each tabbed section lists the options that are available and the current setting for the theme is highlighted.
+<keycap>Numpad-8</keycap> - read the current line.
</para>
-</section>
-
-<section id="themes-20">
-<title>Modifying the Controls Setting for a Theme</title>
+</listitem>
+<listitem>
<para>
-To modify the controls setting that is associated with a theme, perform the following steps:
+<keycap>Numpad-9</keycap> - move the flat review cursor to the next line and read it.
</para>
-<orderedlist>
+</listitem>
<listitem>
<para>
-Within the <guilabel>Theme</guilabel> tab, select the theme that you want to modify.
+<keycap>Numpad-4</keycap> - move the flat review cursor to the previous word and read it.
</para>
</listitem>
<listitem>
<para>
-Click on the <guibutton>Customize</guibutton> button. The <guilabel>Customize Theme</guilabel> dialog is displayed.
+<keycap>Numpad-5</keycap> - read the current word.
</para>
</listitem>
<listitem>
<para>
-Click on the <guilabel>Controls</guilabel> tab to display the controls options that are available.
+<keycap>Numpad-6</keycap> - move the flat review cursor to the next word and read it.
</para>
</listitem>
<listitem>
<para>
-Select the controls option that you want to associate with the current theme from the list box, then click <guibutton>Close</guibutton>. The following table lists the controls options that are suitable for accessibility needs:
+<keycap>Numpad-1</keycap> - move the flat review cursor to the previous character and read it.
</para>
</listitem>
-</orderedlist>
-<table frame="topbot">
-<title>Controls Options Designed for Accessibility Requirements
-</title>
-<tgroup cols="2" colsep="0" rowsep="0">
-<colspec colname="colspec0" colwidth="50*"/>
-<colspec colname="colspec1" colwidth="50*"/>
-<thead>
-<row rowsep="1">
-<entry valign="top">
-<para>Control Option</para>
-</entry>
-<entry valign="top">
-<para>Description</para>
-</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry valign="top">
+<listitem>
<para>
-<guilabel>HighContrast</guilabel>
+<keycap>Numpad-2</keycap> - read the current character.
</para>
-</entry>
-<entry valign="top">
+</listitem>
+<listitem>
<para>
-Provides dark text on a light background using high-contrast colors.
+<keycap>Numpad-3</keycap> - move the flat review cursor to the next character and read it.
</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0" valign="top">
+</listitem>
+<listitem>
<para>
-<guilabel>HighContrastInverse</guilabel>
+<keycap>Numpad-slash</keycap> - perform a left mouse click at the location of the flat review cursor.
</para>
-</entry>
-<entry colname="colspec1" valign="top">
+</listitem>
+<listitem>
<para>
-Provides light text on a dark background using high-contrast colors.
+<keycap>Numpad-star</keycap> - perform a right mouse click at the location of the flat review cursor.
</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0" valign="top">
+</listitem>
+</itemizedlist>
+<note>
<para>
-<guilabel>LargePrint</guilabel>
+The above commands apply when working with objects as well as when working with text. For example, if the flat review cursor were positioned on a menu bar, pressing the "read current line" command would speak the names of all visible menus. Similarly, pressing the "read next word" command would speak the object to the right of the flat review cursor on the same line, or move flat review to the next line if no more objects were found.
</para>
-</entry>
-<entry colname="colspec1" valign="top">
+</note>
+</section>
+
+<section>
+<title>Bookmark commands</title>
+<itemizedlist>
+<listitem>
<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.
+<keycombo><keycap>Alt</keycap><keycap>Insert</keycap><keycap>[1-6]</keycap></keycombo> - assign a bookmark to a numbered slot. If a bookmark already exists in the slot it will be replaced with the new one.
</para>
-</entry>
-</row>
-<row>
-<entry valign="top">
+</listitem>
+<listitem>
<para>
-<guilabel>HighContrastLargePrint</guilabel>
+<keycombo><keycap>Insert</keycap><keycap>[1-6]</keycap></keycombo> - go to the position pointed to by the bookmark bound to this numbered slot.
</para>
-</entry>
-<entry valign="top">
+</listitem>
+<listitem>
<para>
-Provides dark text on a light background using high-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.
+<keycombo><keycap>Alt</keycap><keycap>Shift</keycap><keycap>[1-6]</keycap></keycombo> - "Where am I" information for this bookmark relative to the current pointer location.
</para>
-</entry>
-</row>
-<row>
-<entry valign="top">
+</listitem>
+<listitem>
<para>
-<guilabel>HighContrastLargePrintInverse</guilabel>
+<keycombo><keycap>Insert</keycap><keycap>B</keycap></keycombo> and <keycombo><keycap>Insert</keycap><keycap>Shift</keycap><keycap>B</keycap></keycombo> - move between the given bookmarks for the given application or page.
</para>
-</entry>
-<entry valign="top">
+</listitem>
+<listitem>
<para>
-Provides light text on a dark background using high-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.
+<keycombo><keycap>Alt</keycap><keycap>Insert</keycap><keycap>B</keycap></keycombo> - save the defined bookmarks for the current application or page.
</para>
-</entry>
-</row>
-</tbody>
-</tgroup>
-</table>
+</listitem>
+</itemizedlist>
</section>
-<section id="themes-5">
-<title>Modifying the Window Border Setting for a Theme
-</title>
-<indexterm>
-<primary>themes</primary>
-<secondary>window border</secondary>
-</indexterm>
+<section>
+<title>Miscellaneous functions</title>
+<itemizedlist>
+<listitem>
<para>
-To modify the window border setting that is associated with a theme, perform the following steps:
+<keycombo><keycap>Numpad</keycap><keycap>Plus</keycap></keycombo> - "say all" command; reads from the current position of the caret to the end of the document.
</para>
-<orderedlist>
+</listitem>
<listitem>
<para>
-In the <application>Appearance</application> preference tool, choose the <guilabel>Theme</guilabel> tab and the theme you want to modify.
+<keycombo><keycap>Numpad</keycap><keycap>Enter</keycap></keycombo> - "Where am I" command; speaks information such as the title of the current application window, as well as the name of the control that currently has focus.
</para>
</listitem>
<listitem>
<para>
-Click on the <guibutton>Customize</guibutton> button. The <guilabel>Customize Theme</guilabel> dialog is displayed.
+<keycombo><keycap>Insert</keycap><keycap>H</keycap></keycombo> - enter into <application>Orca</application>'s "learn mode"; press <keycap>Escape</keycap> to exit.
</para>
</listitem>
<listitem>
<para>
-Click on the <guilabel>Window Border</guilabel> tab to display the window frame options that are available.
+<keycombo><keycap>Insert</keycap><keycap>F</keycap></keycombo> - speak font and attribute information for the current character.
</para>
</listitem>
<listitem>
<para>
-Select the window frame option that you want to associate with the current theme from the list box, then click <guibutton>Close</guibutton>. The <guilabel>Atlanta</guilabel> option is designed for accessibility.
+<keycombo><keycap>Insert</keycap><keycap>Space</keycap></keycombo> - Launch the <application>Orca</application> Configuration dialog.
</para>
</listitem>
-</orderedlist>
-</section>
-
-<section id="themes-19">
-<title>Modifying the Icon Setting for a Theme</title>
-<indexterm>
-<primary>themes</primary>
-<secondary>icon</secondary>
-</indexterm>
+<listitem>
<para>
-To modify the icon setting that is associated with a theme, perform the following steps:
+<keycombo><keycap>Insert</keycap><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo> - reload user settings and reinitialize services as necessary. Also launches the <application>Orca</application> Configuration dialog for the current application.
</para>
-<orderedlist>
+</listitem>
<listitem>
<para>
-In the <application>Appearance</application> preference tool, choose the <guilabel>Theme</guilabel> tab and select the theme that you want to modify.
+<keycombo><keycap>Insert</keycap><keycap>S</keycap></keycombo> - toggle speech on and off.
</para>
</listitem>
<listitem>
<para>
-Click on the <guibutton>Customize</guibutton> button. The <guilabel>Customize Theme</guilabel> dialog is displayed.
+<keycombo><keycap>Insert</keycap><keycap>F11</keycap></keycombo> - toggle the reading of tables, either by single cell or whole row.
</para>
</listitem>
<listitem>
<para>
-Click on the <guilabel>Icons</guilabel> tab to display the icon options that are available.
+<keycombo><keycap>Insert</keycap><keycap>Q</keycap></keycombo> - quit <application>Orca</application>.
</para>
</listitem>
+</itemizedlist>
+</section>
+
+<section>
+<title>Commands for debugging</title>
+<itemizedlist>
<listitem>
<para>
-Select the icon option that you want to associate with the theme from the list box, then click <guibutton>Close</guibutton>. The following table lists the icon options that are suitable for accessibility needs:
+<keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Insert</keycap><keycap>Home</keycap></keycombo> - report information on the currently active script.
</para>
</listitem>
-</orderedlist>
-<table frame="topbot">
-<title>Icon Options Designed for Accessibility Requirements
-</title>
-<tgroup cols="2" colsep="0" rowsep="0">
-<colspec colname="colspec0" colwidth="50*"/>
-<colspec colname="colspec1" colwidth="50*"/>
-<thead>
-<row rowsep="1">
-<entry valign="top">
-<para>Icon Option</para>
-</entry>
-<entry valign="top">
-<para>Description</para>
-</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry valign="top">
+</itemizedlist>
+<note>
<para>
-<guilabel>HighContrast</guilabel>
+In order for the next three commands to be of use, <application>Orca</application> needs to be started from a virtual console or via gnome-terminal. Output is sent to the console only (i.e., it is not sent to speech or braille).
</para>
-</entry>
-<entry valign="top">
+</note>
+<itemizedlist>
+<listitem>
<para>
-Provides dark-on-light icons using high-contrast colors.
+<keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Insert</keycap><keycap>End</keycap></keycombo> - print a debug listing of all known applications to the console where <application>Orca</application> is running.
</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0" valign="top">
+</listitem>
+<listitem>
<para>
-<guilabel>HighContrastInverse</guilabel>
+<keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Insert</keycap><keycap>Page_Up</keycap></keycombo> - print debug information about the ancestry of the object with focus.
</para>
-</entry>
-<entry colname="colspec1" valign="top">
+</listitem>
+<listitem>
<para>
-Provides light-on-dark icons using high-contrast colors.
+<keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Insert</keycap><keycap>Page_Down</keycap></keycombo> - print debug information about the hierarchy of the application with focus.
</para>
-</entry>
-</row>
-<!--<row>
-<entry colname="colspec0" valign="top">
+</listitem>
+</itemizedlist>
+</section>
+</section>
+
+<section id="orca-laptop-keys">
+<title>Laptop Layout</title>
<para>
-<guilabel>LargePrint</guilabel>
+Following is a list of common <application>Orca</application> keyboard commands for laptop keyboards arranged by category:
</para>
-</entry>
-<entry colname="colspec1" valign="top">
+
+<section>
+<title>Flat review commands</title>
+<itemizedlist>
+<listitem>
<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.
+<keycombo><keycap>Caps_Lock</keycap><keycap>U</keycap></keycombo> - move the flat review cursor to the previous line and read it.
+Double-click to move flat review to the top of the current window.
</para>
-</entry>
-</row>
-<row>
-<entry valign="top">
+</listitem>
+<listitem>
+<para>
+<keycombo><keycap>Caps_Lock</keycap><keycap>I</keycap></keycombo> - read the current line.
+Double-click to read the current line along with formatting and capitalization details.
+</para>
+</listitem>
+<listitem>
+<para>
+<keycombo><keycap>Caps_Lock</keycap><keycap>O</keycap></keycombo> - move the flat review cursor to the next line and read it. Double- click to move flat review to the bottom of the current window.
+</para>
+</listitem>
+<listitem>
+<para>
+<keycombo><keycap>Caps_Lock</keycap><keycap>J</keycap></keycombo> - move the flat review cursor to the previous word and read it.
+Double-click to move flat review to the word above the current word.
+</para>
+</listitem>
+<listitem>
<para>
-<guilabel>HighContrastLargePrint</guilabel>
+<keycombo><keycap>Caps_Lock</keycap><keycap>K</keycap></keycombo> - read the current word.
+Double-click to spell the word. Triple-click to hear the word spelled phonetically.
</para>
-</entry>
-<entry valign="top">
+</listitem>
+<listitem>
<para>
-Provides dark text on a light background using
-high-contrast colors. To increase the font size, you
-must use the <application>Font</application> Preference
-tool.
+<keycombo><keycap>Caps_Lock</keycap><keycap>L</keycap></keycombo> - move the flat review cursor to the next word and read it. Double- click to move flat review to the word below the current word.
</para>
-</entry>
-</row>
-<row>
-<entry valign="top">
+</listitem>
+<listitem>
<para>
-<guilabel>HighContrastLargePrintInverse</guilabel>
+<keycombo><keycap>Caps_Lock</keycap><keycap>M</keycap></keycombo> - move the flat review cursor to the previous character and read it.
+Double-click to move flat review to the end of the current line.
</para>
-</entry>
-<entry valign="top">
+</listitem>
+<listitem>
<para>
-Provides light text on a dark background using
-high-contrast colors. To increase the font size, you
-must use the <application>Font</application> Preference
-tool.
+<keycombo><keycap>Caps_Lock</keycap><keycap>Comma</keycap></keycombo> - read the current character. Double-click to pronounce the character phonetically if it is a letter.
</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0" valign="top">
+</listitem>
+<listitem>
<para>
-<guilabel>LowContrastLargePrint</guilabel>
+<keycombo><keycap>Caps_Lock</keycap><keycap>Period</keycap></keycombo> - move the flat review cursor to the next character and read it.
</para>
-</entry>
-<entry colname="colspec1" valign="top">
+</listitem>
+<listitem>
<para>
-Uses low-contrast colors for the background and
-foreground text. To increase the font size, you must use
-the <application>Font</application> Preference tool.
+<keycombo><keycap>Caps_Lock</keycap><keycap>7</keycap></keycombo> - perform a left mouse click at the location of the flat review cursor.
</para>
-</entry>
-</row>-->
-</tbody>
-</tgroup>
-</table>
-</section>
-
-<section id="themes-6">
-<title>Creating Your Own Themes</title>
-<indexterm>
-<primary>themes</primary>
-<secondary>creating own</secondary>
-</indexterm>
+</listitem>
+<listitem>
<para>
-For information about how to create your own themes, see the <ulink type="help"
-url="ghelp:system-admin-guide?themes-0">
-System Administration Guide</ulink>.
+<keycombo><keycap>Caps_Lock</keycap><keycap>8</keycap></keycombo> - perform a right mouse click at the location of the flat review cursor.
</para>
-</section>
-</section>
-
-<section id="themes-7">
-<title>Customizing Specific Components of the Desktop
-</title>
+</listitem>
+<listitem>
<para>
-This section describes how to customize specific components of the GNOME Desktop individually.
+<keycombo><keycap>Caps_Lock</keycap><keycap>8</keycap></keycombo> - perform a right mouse click at the location of the flat review cursor.
</para>
-
-<section id="themes-8">
-<title>Customizing the Desktop Background</title>
-<indexterm>
-<primary>customizing desktop appearance</primary>
-<secondary>desktop background</secondary>
-</indexterm>
+</listitem>
+</itemizedlist>
+<note>
<para>
-The themes do not affect the desktop background. To set the desktop background, choose <menuchoice><guimenu>System</guimenu><guisubmenu>Preferences</guisubmenu>
-<guimenuitem>Appearance</guimenuitem></menuchoice> and select a background from the <guilabel>Background</guilabel> tab. If no background is chosen, the first entry listed here may be used.
+The above commands apply when working with objects as well as when working with text. For example, if the flat review cursor were positioned on a menu bar, pressing the "read current line" command would speak the names of all visible menus. Similarly, pressing the "read next word" command would speak the object to the right of the flat review cursor on the same line, or move flat review to the next line if no more objects were found.
</para>
+</note>
</section>
-<section id="themes-9">
-<title>Customizing Desktop Background Objects</title>
-<indexterm>
-<primary>customizing desktop appearance</primary>
-<secondary>desktop background objects</secondary>
-</indexterm>
+<section>
+<title>Bookmark commands</title>
+<itemizedlist>
+<listitem>
<para>
-The size of the icons that are displayed on the desktop background is controlled by the <application>File Management</application> preference tool. To change the size of the icons, perform the following steps:
+<keycombo><keycap>Alt</keycap><keycap>Caps_Lock</keycap><keycap>[1-6]</keycap></keycombo> - add a bookmark to the numbered slot. If a bookmark already exists for the slot it will be replaced with the new one.
</para>
-<orderedlist>
+</listitem>
<listitem>
<para>
-From the <application>File Manager</application> window, choose the <menuchoice><guimenu>Edit</guimenu>
-<guisubmenu>Preferences</guisubmenu></menuchoice> menu item.
+<keycombo><keycap>Caps_Lock</keycap><keycap>[1-6]</keycap></keycombo> - go to the position pointed to by the bookmark bound to this numbered slot.
</para>
</listitem>
<listitem>
<para>
-Select the <guilabel>Views</guilabel> tabbed section.
+<keycombo><keycap>Alt</keycap><keycap>Shift</keycap><keycap>[1-6]</keycap></keycombo> - "Where am I" information for this bookmark relative to the current pointer location.
</para>
</listitem>
<listitem>
<para>
-In the <guilabel>Icon View Defaults</guilabel> group, select the zoom level that you require in the <guilabel>Default Zoom Level</guilabel> drop-down list.
+<keycombo><keycap>Caps_Lock</keycap><keycap>B</keycap></keycombo>and <keycombo><keycap>Caps_Lock</keycap><keycap>Shift</keycap><keycap>B</keycap></keycombo> - move between the given bookmarks for the given application or page.
</para>
</listitem>
-</orderedlist>
-</section>
-
-<section id="themes-10">
-<title>Customizing Fonts</title>
-<indexterm>
-<primary>customizing desktop appearance</primary>
-<secondary>fonts</secondary>
-</indexterm>
-<anchor id="themes-13"/>
-<anchor id="themes-14"/>
+<listitem>
<para>
-This section describes how to customize
-the font settings for the desktop and frequently-used applications.
+<keycombo><keycap>Alt</keycap><keycap>Caps_Lock</keycap><keycap>B</keycap></keycombo> - save the defined bookmarks for the current application or page.
</para>
+</listitem>
+</itemizedlist>
+</section>
+
+<section>
+<title>Miscellaneous functions</title>
+<itemizedlist>
+<listitem>
<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 settings to suit your needs.
+<keycombo><keycap>Caps_Lock</keycap><keycap>Semicolon</keycap></keycombo> - "Say all" command; reads from the current position of the caret to the end of the document.
</para>
+</listitem>
+<listitem>
<para>
-You can specify individual font settings for the following desktop components and applications:
+<keycombo><keycap>Caps_Lock</keycap><keycap>Enter</keycap></keycombo> - "Where am I" command; speaks information such as the title of the current application window, as well as the name of the control that currently has focus.
</para>
-<itemizedlist>
+</listitem>
<listitem>
<para>
-Entire desktop (excluding the desktop background)
+<keycombo><keycap>Caps_Lock</keycap><keycap>H</keycap></keycombo> - enter learn mode (press <keycap>Escape</keycap> to exit).
</para>
</listitem>
<listitem>
-<para>Desktop background only</para>
+<para>
+<keycombo><keycap>Caps_Lock</keycap><keycap>F</keycap></keycombo> - speak font and attribute information for the current character.
+</para>
</listitem>
<listitem>
-<para>Terminal</para>
+<para>
+<keycombo><keycap>Caps_Lock</keycap><keycap>Space</keycap></keycombo> - launch the <application>Orca</application> Configuration dialog.
+</para>
</listitem>
<listitem>
-<para>Text Editor</para>
+<para>
+<keycombo><keycap>Caps_Lock</keycap><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo> - reload user settings and reinitialize services as necessary; also launches the <application>Orca</application> Configuration dialog for the current application.
+</para>
</listitem>
<listitem>
-<para>Help</para>
+<para>
+<keycombo><keycap>Caps_Lock</keycap><keycap>S</keycap></keycombo> - toggle speech on and off.
+</para>
</listitem>
<listitem>
-<para>Web Browser</para>
-</listitem>
-</itemizedlist>
-<section id="themes-11">
-<title>Customizing Desktop Fonts</title>
-<indexterm>
-<primary>customizing desktop appearance</primary>
-<secondary>desktop fonts</secondary>
-</indexterm>
<para>
-The <application>Appearance</application> preference tool allows you to specify the default fonts for the desktop.
+<keycombo><keycap>Caps_Lock</keycap><keycap>F11</keycap></keycombo> - toggle the reading of tables, either by single cell or whole row.
</para>
+</listitem>
+<listitem>
<para>
-To start the <application>Appearance</application> preference tool, choose <menuchoice><guimenu>System</guimenu>
-<guisubmenu>Preferences</guisubmenu><guimenuitem>Appearance</guimenuitem></menuchoice>. The <guilabel>
-Fonts</guilabel> tab contains the following options:
+<keycombo><keycap>Caps_Lock</keycap><keycap>Q</keycap></keycombo> - quit <application>Orca</application>.
</para>
-<variablelist>
-<varlistentry>
-<term>
-<guilabel>Application Font</guilabel>
-</term>
+</listitem>
+</itemizedlist>
+</section>
+
+<section>
+<title>Commands for debugging</title>
+<itemizedlist>
<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 dialogs associated with GNOME-compliant applications and panel applications.
+<keycombo><keycap>Caps_Lock</keycap><keycap>Alt</keycap><keycap>Ctrl</keycap><keycap>Home</keycap></keycombo> - report information on the currently active script.
</para>
+</listitem>
+</itemizedlist>
<note>
<para>
-If you use a predefined theme and you click on the <guibutton>Apply Font</guibutton> button, the font that is associated with the theme overrides the font from the <application>Appearance</application> preference tool.
+In order for the next three commands to be of use, <application>Orca</application> needs to be started from a virtual console or via <application>gnome-terminal</application>. Output is sent to the console only (i.e.,
+it is not sent to speech or braille).
</para>
</note>
-</listitem>
-</varlistentry>
-<varlistentry>
-<term>
-<guilabel>Document Font</guilabel>
-</term>
+<itemizedlist>
<listitem>
<para>
-Click on this button to select a font to use for displaying documents.
+<keycombo><keycap>Caps_Lock</keycap><keycap>Alt</keycap><keycap>Ctrl</keycap><keycap>End</keycap></keycombo> - prints a debug listing of all known applications to the console where <application>Orca</application> is running.
</para>
</listitem>
-</varlistentry>
-<varlistentry>
-<term>
-<guilabel>Desktop Font</guilabel>
-</term>
<listitem>
<para>
-Click on this button to select a font to use for the text that is displayed on the desktop background only.
+<keycombo><keycap>Caps_Lock</keycap><keycap>Alt</keycap><keycap>Ctrl</keycap><keycap>Page_Up</keycap></keycombo> - prints debug information about the ancestry of the object with focus.
</para>
</listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>Window Title Font</guilabel> </term>
<listitem>
<para>
-Click on this button to select a font to use for the text that is displayed in the titlebar area of windows.
+<keycombo><keycap>Caps_Lock</keycap><keycap>Alt</keycap><keycap>Ctrl</keycap><keycap>Page_Down</keycap></keycombo> - prints debug information about the object hierarchy of the application with focus.
+</para>
+</listitem>
+</itemizedlist>
+</section>
+</section>
+
+</section>
+<section>
+<title>Application-Specific Information</title>
+<section>
+<title>Accessible Applications</title>
+<para>
+<application>Orca</application> is designed to work with applications and toolkits that support the Assistive Technology Service Provider Interface (AT-SPI). This includes the GNOME Desktop and its bundled applications: OpenOffice, Firefox, and the Java platform. Some applications work better than others, however, and the <application>Orca</application> community continually works to provide superior access to more and more applications.
+</para>
+</section>
+
+<!--
+<section>
+<title>Using Adobe's Acrobat Reader</title>
+<para>
+We are currently working on a script for Adobe's Acrobat Reader, and the initial version has been contributed to <application>Orca</application> v2.17.5. Note that there is still work to do, and we are very encouraged by Adobe's commitment to accessibility.
+</para>
+
+<section>
+<title>Installation</title>
+<para>
+If you get Adobe Acrobat Reader directly from the <ulink url='http://www.adobe.com/products/acrobat/readstep2.html'>Adobe site</ulink>, you may find that the software will not launch. If launched from the Applications menu, it may appear that nothing has happened, or if launched from a terminal window you may receive a long series of syntax error messages. Should this occur, you will need to edit your /usr/bin/acroread file as described in this <ulink url='http://ubuntuforums.org/showthread.php?t=233514'>Ubuntu forum thread</ulink>.
+</para>
+<para>
+If you instead choose to install Acrobat Reader from your distribution's packages, be sure to install both <application>acroread</application> and <application>acroread-plugins</application>. Without the plugins package, you will not have the access to the "Reading" category in the <menuchoice>
+<guimenuitem>Edit-</guimenuitem>
+<guimenuitem>Preferences</guimenuitem>
+</menuchoice> dialog.
+</para>
+<para>
+Note: If you use Ubuntu and cannot locate the
+<application>acroread</application> package, you will likely need to edit your /etc/apt/sources.list to include the 'multiverse' repository. Then run <userinput>apt-get update</userinput>. Having done so, you should then be able to install both <application>acroread</application> and <application>acroread-plugins</application>.
+</para>
+</section>
+
+<section>
+<title>Enabling Accessibility and Caret Navigation</title>
+<para>
+Once you've installed Reader, you need to enable accessibility:
</para>
-</listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>Fixed Width Font</guilabel> </term>
+<orderedlist numeration='arabic'>
<listitem>
<para>
-Click on this button to select a font to use for editing documents.
+In the "Accessibility" tab of the
+<menuchoice>
+<guimenuitem>Edit-</guimenuitem>
+<guimenuitem>Preferences</guimenuitem>
+</menuchoice> dialog, make sure
+<guilabel>Always display the keyboard selection cursor</guilabel> (<keycombo>
+<keycap>Alt</keycap><keycap>D</keycap>
+</keycombo>) is checked.
</para>
</listitem>
-</varlistentry>
-<varlistentry>
-<term><guilabel>Font Rendering</guilabel> </term>
<listitem>
<para>
-To specify how to render fonts on the desktop, select one of the following options:
+In the "Reading" tab of the
+<menuchoice>
+<guimenuitem>Edit-</guimenuitem>
+<guimenuitem>Preferences</guimenuitem>
+</menuchoice> dialog, make sure
+<guilabel>Enable Document Accessibility
+</guilabel> ((<keycombo><keycap>Alt</keycap>
+<keycap>E</keycap></keycombo>) is checked.
</para>
-<itemizedlist>
-<listitem>
+</listitem>
+</orderedlist>
+</section>
+
+<section>
+<title>Working with Untagged Documents</title>
<para>
-<guilabel>Monochrome</guilabel>
+When you open an untagged document, you will be presented with a dialog box asking you to specify the reading order and the reading mode options. The default reading order is
+<guilabel>Infer reading order from document
+</guilabel>. This setting works well for most documents.
</para>
-</listitem>
-<listitem>
<para>
-<guilabel>Best Shapes</guilabel>
+The default reading mode will vary depending on the length of the document; for short documents, the default is <guilabel>Read the entire document</guilabel>; for long documents the default is <guilabel>Read currently visible pages only</guilabel>. <application>Orca</application> tends to work better when <guilabel>Read the entire document</guilabel> is selected.
</para>
-</listitem>
-<listitem>
<para>
-<guilabel>Best Contrast</guilabel>
+If you find that a document seems to be missing parts of the text, try changing the reading options. To do so, get into the Document menu and select <guilabel>Change Accessibility Reading Options...</guilabel> or use the shortcut <keycombo><keycap>Ctrl</keycap><keycap>Shift</keycap><keycap>5</keycap></keycombo>.
</para>
-</listitem>
-<listitem>
+</section>
+
+<section>
+<title>Page Layout</title>
<para>
-<guilabel>Subpixel Smoothing</guilabel>
+The best page layout for reading a document with <application>Orca</application> is <guilabel>Single Page</guilabel>. When <guilabel>Continuous</guilabel> is chosen, moving focus to text as the page is scrolling
+can cause that text not to be read. You can change the page layout to <guilabel>Single Page</guilabel> by getting into the View menu and selecting the Page Layout submenu.
</para>
-</listitem>
-</itemizedlist>
-</listitem>
-</varlistentry>
-</variablelist>
-<note>
+</section>
+
+<section>
+<title>Navigating Tables</title>
<para>
-If you use large fonts, you may need to change the size of panes in some applications, such as the file manager and Help browser.
+As far as we know there isn't currently a whole lot of keyboard support for tables in
+<application>Acrobat Reader</application>. We hope Adobe will remedy this soon.
</para>
-</note>
<para>
-For more information about the <application>Appearance</application> preference tool and fonts, see the <ulink type="help" url="ghelp:user-guide?prefs-font">
-User Guide</ulink>.
+Basically, there are the arrow keys. Their behavior is to move you first within the cell with focus, then to the next cell with data in it. Note that currently, Up and Down Arrow do not seem to move you vertically among cells - at least that has been the experience
+with the tables we have tried. Instead, Up and Down seem to move you horizontally until you run out of cells on the current row.
</para>
</section>
+</section>
+-->
-<section id="themes-cust">
-<title>Customizing Application Fonts</title>
-<indexterm>
-<primary>custom desktop appearance</primary>
-<secondary>set choose individual font</secondary>
-</indexterm>
+<section>
+<title>Making Application-Specific Settings</title>
<para>
-By default, GNOME applications use the default font specified in the <application>Appearance</application> preference tool. Some applications allow this default font to be customized. These applications are:
+To customize the settings for a particular application, you will first need to run that application. Make sure the application has focus, then press <keycombo><keycap>Orca_Modifier</keycap>
+<keycap>Ctrl</keycap><keycap>Space</keycap>
+</keycombo> (by default, this will be
+<keycombo><keycap>Insert</keycap><keycap>Ctrl</keycap>
+<keycap>Space</keycap></keycombo> for the Desktop keyboard layout).
</para>
-<itemizedlist>
+<para>
+This brings up a tabbed dialog window very similar to the <application>Orca</application> configuration dialog, but with the following differences:
+</para>
+<orderedlist numeration='arabic'>
<listitem>
-<para><ulink type="help" url="ghelp:user-guide#yelp">
-Help Browser</ulink>
+<para>
+There is no initial General pane.
</para>
</listitem>
<listitem>
<para>
-<ulink type="help" url="ghelp:gedit?
-gedit-prefs-fontsandcolors">
-Text Editor</ulink> </para>
+The Speech System and Speech Synthesizer combo
+boxes on the Speech pane will be grayed out (made inactive).
+</para>
</listitem>
<listitem>
<para>
-<ulink type="help" url="ghelp:gnome-terminal#
-gnome-terminal-prefs-general">
-Terminal</ulink>
+Any existing application-specific key bindings will appear at the top of the list on the Key Bindings pane.
</para>
</listitem>
<listitem>
<para>
-<ulink type="help" url="ghelp:epiphany#
-ephy-customize">Web Browser</ulink>
+There may be a new application-specific settings pane at the end of the set of tabbed panes. Note that pressing the End key from the tab list will get you directly to the right-most tab.
</para>
</listitem>
-</itemizedlist>
-</section>
-</section>
-</section>
-
-<section id="themes-15">
-<title>Meeting Specific Accessibility Needs</title>
+</orderedlist>
<para>
-The following sections summarize the steps you need to take to improve the accessibility of the desktop in a particular area.
+Adjust your application-specific settings in the same way you set your general <application>Orca</application> preferences.
+For example, you may have Key Echo disabled generally in <application>Orca</application> but would like to specifically have it enabled for the <application>gcalctool</application> (GNOME Calculator) application. Here's where you could easily set that.
</para>
-
-<section id="themes-16">
-<title>Achieving a High- or Low-Contrast Desktop</title>
-<indexterm>
-<primary>high contrast desktop</primary>
-</indexterm>
-<indexterm>
-<primary>low contrast desktop</primary>
-</indexterm>
<para>
-To achieve a high- or low-contrast desktop, perform the following steps:
+When you have your application settings customized the way you want, press the <guilabel>OK</guilabel> button. These settings will be written to your
+<userinput>~/.orca/app-settings</userinput> directory in a file called
+<userinput><APPNAME>.py</userinput>, where <userinput><APPNAME></userinput> is the name of the application.
</para>
-<orderedlist>
-<listitem>
<para>
-Use the <application>Appearance</application> preference tool to select the high-contrast or low-contrast desktop theme that you require from the <guilabel>Theme</guilabel> tab.
+These files are automatically written by <application>Orca</application>. The contents of the file will be overwritten each time you change your application settings for that
+application.
</para>
-</listitem>
-<listitem>
<para>
-Use the <guilabel>Background</guilabel> tab to customize your desktop background as follows:
+If you want to have some extra application-specific settings or code that you don't want to lose, then you should put it in a file called <userinput>~/.orca/app-settings/<APPNAME>-customizations.py</userinput>. This file will be automatically read when the settings for the
+<userinput><APPNAME></userinput> application are loaded.
</para>
-<itemizedlist>
-<listitem>
<para>
-Set the <guilabel>Desktop Wallpaper</guilabel> to <guilabel>No Wallpaper</guilabel>.
+Note that this is an advanced feature that we don't expect many people to use. It's just there if you really want it.
</para>
-</listitem>
-<listitem>
<para>
-Set the <guilabel>Desktop Colors</guilabel> to <guilabel>Solid Color</guilabel>.
+There is currently one known bug (some people would call it a feature) that we are trying to track down and fix:
</para>
-</listitem>
-<listitem>
+<note>
<para>
-Select a background color that suits your needs.
+If you adjust one or more application-specific key bindings, the new values will not take effect until you've pressed the <guilabel>OK</guilabel> button. The work-around is to either restart <application>Orca</application>, or Alt-Tab
+away to some other application and then Alt-Tab back to the one that you've just changed the key bindings for.
</para>
-</listitem>
-</itemizedlist>
-</listitem>
-<listitem>
+</note>
+</section>
+</section>
+
+<section>
+<title>Braille</title>
<para>
-In the <application>Terminal</application> application, ensure that the <guilabel>Use colors from system theme</guilabel> option is selected in the <guilabel>Colors</guilabel> tabbed section of the <guilabel>Editing
-Profile</guilabel> dialog.
+<application>Orca</application> uses
+<ulink url='http://mielke.cc/brltty/'>BrlTTY</ulink> for braille support. On Linux systems, BrlTTY is used to access the text mode console content. On a typical braille-enabled installation of Linux, BrlTTY is already running and providing access to the text consoles. When Orca starts, it connects to BrlTTY. If you switch from a text console to your X Windows session, your braille display will automatically follow and display the content that Orca is presenting to you.
</para>
-</listitem>
-<listitem>
<para>
-In the <application>gedit</application> (Text Editor) application, ensure that the <guilabel>Use default theme colors</guilabel> option is selected in the <guilabel>Fonts & Colors</guilabel> tabbed section of the
-<guilabel>Preferences</guilabel> dialog.
+<application>Orca</application> attempts to work with various releases of BrlTTY. It works well with BrlTTY v3.7.2, and we've also been working with the BrlTTY team to get it going for BrlTTY v3.8. The remainder of this document provides information related to using <application>Orca</application> with <application>BrlTTY</application> 3.8.
</para>
-</listitem>
-</orderedlist>
-</section>
-<section id="themes-17">
-<title>Achieving a Large Print Desktop</title>
-<indexterm>
-<primary>large print desktop</primary>
-</indexterm>
<para>
-To achieve a large-print desktop, perform the following steps:
+Below are descriptions of the necessary tasks to install/setup BrlTTY in Ubuntu and Solaris. For both, you need to first obtain
+<ulink url='http://mielke.cc/brltty/releases/
+brltty-3.8.tar.gz'>brltty-3.8.tar.gz</ulink> from the BrlTTY site.
</para>
-<orderedlist>
-<listitem>
+
+<section>
+<title>BrlTTY 3.8 on Ubuntu</title>
<para>
-Use the <application>Appearance</application> preference tool to select the <guilabel>Large Print</guilabel> theme.
+First, configure your build environment to build BrlTTY. Much of this setup is done for you automatically in the Ubuntu distribution with products such as G++ already present. In addition, <emphasis>you must</emphasis>
+also install tcl, Pyrex, and the Python developer environment. To do this, execute the following commands as <userinput>root</userinput>:
</para>
-</listitem>
-<listitem>
+<para></para>
+<screen>
+<![CDATA[apt-get build-dep brltty
+apt-get install tcl8.4 python-pyrex python-dev
+]]>
+</screen>
<para>
-Click on the <guibutton>Apply Font</guibutton> button to increase the size of the font that is used on the desktop and on window frames.
+Then, when you build BrlTTY, avoid configuring the package with --prefix=/usr. Use the standard procedure instead, executing the following commands as <userinput>root</userinput>:
</para>
-</listitem>
-<listitem>
+<para></para>
+<screen>
+<![CDATA[gunzip -c brltty-3.8.tar.gz | tar xvf -
+cd brltty-3.8
+./autogen
+./configure
+make
+make install
+]]>
+</screen>
<para>
-Use the <guilabel>Desktop Font</guilabel> option in the <guilabel>Font</guilabel> tab to increase the font that is displayed on desktop background objects.
+Run BrlTTY as <userinput>root</userinput>:
</para>
-</listitem>
-<listitem>
+<para></para>
+<screen>
+<![CDATA[/bin/brltty -bauto -d/dev/ttyUSB0
+]]>
+</screen>
<para>
-Increase the font size that is used to display the contents of the <application>Terminal</application> application window.
+If you want, you can remove the existing
+<userinput>/sbin/brltty</userinput> and replace it with the <userinput>/bin/brltty</userinput>, either by copying the <userinput>/bin/brltty</userinput> to <userinput>/sbin/brltty</userinput> or just by making a
+symbolic link. Do so at your own risk.
</para>
-</listitem>
-<listitem>
+<para />
+</section>
+</section>
+
+<section>
+<title>Troubleshooting</title>
+<section>
+<title>My desktop has stopped responding. What do I do?
+</title>
<para>
-If the <guilabel>Use default theme font</guilabel> option is selected in the <application>gedit</application> (Text Editor) <guilabel>Preferences</guilabel> dialog, <application>gedit</application> uses the font size that is specified in the large-print theme that you selected. However, if the <guilabel>Use default theme font
-</guilabel> option is not selected, increase the font size that is used to display the contents of the <application>gedit</application> text editor window. See the <ulink type="help" url="ghelp:gedit?gedit-prefs-fontsandcolors">gedit manual</ulink> for more information.
+Press <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> or <keycombo><keycap>Meta</keycap><keycap>R</keycap></keycombo> to open the Run dialog and restart <application>Orca</application> by running a new instance: type <userinput>orca</userinput> and press <keycap>Enter</keycap>. This will force any existing <application>Orca</application> processes to exit and will then restart <application>Orca</application>. This
+sometimes has the effect of unhanging the desktop (which is usually due to an ill-behaved application).
</para>
-</listitem>
-<listitem>
<para>
-If you use applications that use panes, such as the file manager and help browser, you may need to change the size of panes to accommodate the large print. See the online help for the appropriate application for more information.
+If you cannot get to a terminal window, try
+pressing <keycombo><keycap>Ctrl</keycap>
+<keycap>Alt</keycap><keycap>Backspace</keycap>
+</keycombo>: shut down the X Window System server. This should return you to the login screen.
</para>
-</listitem>
-</orderedlist>
</section>
</section>
</section>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
