summaryrefslogtreecommitdiffstats
path: root/gnome2-accessibility-guide/C
diff options
context:
space:
mode:
Diffstat (limited to 'gnome2-accessibility-guide/C')
-rwxr-xr-xgnome2-accessibility-guide/C/config.xml2
-rw-r--r--gnome2-accessibility-guide/C/enable.xml66
-rw-r--r--gnome2-accessibility-guide/C/gnome-access-guide.xml35
-rw-r--r--gnome2-accessibility-guide/C/low-vision.xml50
4 files changed, 111 insertions, 42 deletions
diff --git a/gnome2-accessibility-guide/C/config.xml b/gnome2-accessibility-guide/C/config.xml
index dce3775..fe358e1 100755
--- a/gnome2-accessibility-guide/C/config.xml
+++ b/gnome2-accessibility-guide/C/config.xml
@@ -158,7 +158,7 @@ of time to move the mouse to indicate the click type; after that time has elapse
the dwell time of the next pointer stop. The following options describe how to configure the controls in the <guilabel>Accessibility</guilabel> tab.
</para>
<para>
-The Dwell panel applet can be enabled by right-clicking the GNOME Desktop menu bar / system panel, selecting <guilabel>Add to Panel</guilabel>, choosing <application>Dwell Click</application> and clicking the <guilabel>Add</guilabel> button.
+The <application>Dwell Click</application> panel applet can be enabled by right-clicking the GNOME Desktop menu bar / system panel, selecting <guilabel>Add to Panel</guilabel>, choosing <application>Dwell Click</application> and clicking the <guilabel>Add</guilabel> button.
</para>
<para>
<emphasis>Trigger secondary click (Alt-T)</emphasis> - a secondary click can be issued by using the primary button and keeping it held down for a specified delay (Alt-D).
diff --git a/gnome2-accessibility-guide/C/enable.xml b/gnome2-accessibility-guide/C/enable.xml
index 5f7a2ad..1ababdc 100644
--- a/gnome2-accessibility-guide/C/enable.xml
+++ b/gnome2-accessibility-guide/C/enable.xml
@@ -36,7 +36,7 @@ o to become familiar with these elements and how to quickly and efficiently navi
</para>
-->
<section id="enable-gok">
-<title>GOK (GNOME Onscreen Keyboard)</title>
+<title>GOK (GNOME On-Screen Keyboard)</title>
<para>
You must enable the assistive technology services before you are able to use many of the accessibility tools available.
</para>
@@ -285,4 +285,68 @@ Press <keycap>Alt-F1</keycap> and select <menuchoice><guimenuitem>Applications</
</listitem>
</itemizedlist>
</section>
+
+<section>
+<title>MouseTweaks</title>
+<para>
+<application>MouseTweaks</application> is a collection of accessibility enhancements for pointing devices.
+</para>
+
+<section>
+<title>Dwell Click</title>
+<para>
+Additional accessibility options related to mouse-type pointing devices can be adjusted by using <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Mouse</guimenuitem></menuchoice> and selecting the <guilabel>Accessibility</guilabel> tab.
+</para>
+<para>
+There are two modes to aid mouse usage; in the first, the click type is chosen beforehand by using the <guilabel>ClickType</guilabel> window or the <guilabel>Dwell Click</guilabel> panel applet. In the second mode, click-type is
+determined by the direction in which the user moves the mouse after the dwell time has elapsed. There is only a determined amount
+of time to move the mouse to indicate the click type; after that time has elapsed the pointer movement does not trigger a click until after
+the dwell time of the next pointer stop. The following options describe how to configure the controls in the <guilabel>Accessibility</guilabel> tab.
+</para>
+<para>
+The <application>Dwell Click</application> panel applet can be enabled by right-clicking the GNOME Desktop menu bar / system panel, selecting <guilabel>Add to Panel</guilabel>, choosing <application>Dwell Click</application> and clicking the <guilabel>Add</guilabel> button.
+</para>
+<para>
+<emphasis>Trigger secondary click (Alt-T)</emphasis> - a secondary click can be issued by using the primary button and keeping it held down for a specified delay (Alt-D).
+</para>
+<para>
+<emphasis>Initiate click when stopping pointer movement (Alt-I)</emphasis> - a "dwell click" can be performed with a given delay (Alt-E) and motion threshold (Alt-M). The type of click may optionally be set beforehand (Alt-B) with the ClickType floating window (Alt-W) or Dwell Click panel applet. The click-type can be single, double, drag or right. Lastly, mouse direction movement can also specify the click type to be issued (Alt-U) - eg, moving the mouse left will result in a single click by default, or you may specify which direction equals what type of click.
+</para>
+<para>
+The two available operating modes may be summarized as follows:
+</para>
+<para>
+<emphasis>Choose type of click beforehand (Alt-B)</emphasis> - the click type selected in the ClickType floating window (Alt-W) or the Dwell Click applet is automatically issued after the given delay.
+</para>
+<para>
+<emphasis>Choose type of click with mouse movement (Alt-U)</emphasis> - at the end of the given delay, the shape of the pointer turns into a cross. If the user moves the pointer while it is showing the cross, the direction of the movement specifies what click type is issued and triggers the click. If the user does not move the pointer while it is showing a cross (which lasts only a short time) it turns back to its arrow shape and no automatic click is performed for that move-stop cycle.
+</para>
+</section>
+
+<section>
+<title>Pointer Capture</title>
+<para>
+The mouse pointer can be locked into an area of the screen so the pointing device is free for other tasks.
+</para>
+<para>
+The <application>Pointer Capture</application> panel applet creates such an area on the panel, into which the user can lock the pointer until released in a determined way.
+</para>
+
+<para>
+The <application>Pointer Capture</application> panel applet can be enabled by right-clicking the GNOME Desktop menu bar / system panel, selecting <guilabel>Add to Panel</guilabel>, choosing <application>Pointer Capture</application> and clicking the <guilabel>Add</guilabel> button.
+</para>
+<para>
+Preferences may be set by choosing <guilabel>Preferences</guilabel> in the context menu of the <application>Pointer Capture</application> applet:
+</para>
+<para>
+In the <guilabel>Capture Pointer</guilabel> section, the user can specify under what circumstances the pointer gets captured when it moves into the capture area. For example, if the <keycap>Ctrl</keycap> modifier key is checked, the pointer gets captured when it is over the capture area and the user presses the <keycap>Ctrl</keycap> modifier key. If no modifier is checked and the mouse button is set to 0, the pointer only has to move into the capture area to get locked. It is also possible to specify a combination of modifiers with the chosen mouse button.
+</para>
+<para>
+In the <guilabel>Release Pointer</guilabel> section, the user can specify what modifier or mouse button releases the pointer. It is also possible to specify a combination of modifiers with the chosen mouse button.
+</para>
+<para>
+In the <guilabel>Size of Capture Area</guilabel> section, the user can specify the width of the capture area on the GNOME panel.
+</para>
+</section>
+</section>
</chapter>
diff --git a/gnome2-accessibility-guide/C/gnome-access-guide.xml b/gnome2-accessibility-guide/C/gnome-access-guide.xml
index d42c501..fcc64fe 100644
--- a/gnome2-accessibility-guide/C/gnome-access-guide.xml
+++ b/gnome2-accessibility-guide/C/gnome-access-guide.xml
@@ -1,21 +1,19 @@
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
- <!ENTITY gnomeversion "2.20">
- <!ENTITY manrevision "2.14.0">
- <!ENTITY date "September 2007">
+ <!ENTITY gnomeversion "2.22">
+ <!ENTITY manrevision "2.22.0">
+ <!ENTITY date "September 2008">
<!ENTITY LEGAL SYSTEM "legal.xml">
<!ENTITY accessintro SYSTEM "accessintro.xml">
<!ENTITY sysadmin SYSTEM "sysadmin.xml">
<!ENTITY enable SYSTEM "enable.xml">
- <!ENTITY config SYSTEM "config.xml">
<!ENTITY low-vision SYSTEM "low-vision.xml">
<!ENTITY mobility SYSTEM "mobility.xml">
<!ENTITY general SYSTEM "general.xml">
<!ENTITY author1 "Sun">
<!ENTITY author2 "Java Desktop System Documentation Team">
-]>
-<?db.chunk.max_depth 4?>
+]><?db.chunk.max_depth 4?>
<book id="index">
<title>GNOME Desktop Accessibility Guide</title>
<bookinfo>
@@ -57,6 +55,14 @@ GNOME Documentation Project
<authorgroup>
<author>
+<firstname>Vincent</firstname>
+<surname>Alexander</surname>
+<affiliation>
+<orgname>GNOME Documentation Project</orgname>
+</affiliation>
+</author>
+
+<author>
<firstname>Don</firstname>
<surname>Scorgie</surname>
<affiliation>
@@ -100,6 +106,22 @@ GNOME Documentation Project
<revision>
<revnumber>
+GNOME &gnomeversion;
+Desktop Accessibility Guide V&manrevision;
+</revnumber>
+<date>&date;</date>
+<revdescription>
+<para role="author">
+GNOME Documentation Project
+</para>
+<para role="publisher">
+GNOME Documentation Project
+</para>
+</revdescription>
+</revision>
+
+<revision>
+<revnumber>
GNOME 2.10 Desktop Accessibility Guide V2.10.1
</revnumber>
<date>July 2005</date>
@@ -228,7 +250,6 @@ url="ghelp:user-guide?feedback">GNOME Feedback Page</ulink>.
&accessintro;
&enable;
-&config;
&general;
&low-vision;
&mobility;
diff --git a/gnome2-accessibility-guide/C/low-vision.xml b/gnome2-accessibility-guide/C/low-vision.xml
index 1d4ffcb..fe960e5 100644
--- a/gnome2-accessibility-guide/C/low-vision.xml
+++ b/gnome2-accessibility-guide/C/low-vision.xml
@@ -305,14 +305,16 @@ described in the following sections.
</para>
<section>
-<title>General Page</title>
-<para>The General page allows you to customize general aspects of <application>Orca</application>. These include the following:
+<title>General</title>
+<para>
+The General section details the following items:
</para>
+</section>
<section>
<title>Keyboard Layout</title>
<para>
-The keyboard layout section lets you choose between a small keyboard layout (Laptop) or large keyboard layout with a numeric keypad (Desktop). If you choose Laptop the <application>Orca</application> system key is CapsLock; for the Desktop layout the system key is Insert.
+The <guilabel>keyboard layout</guilabel> option lets you choose between a small keyboard layout (<guilabel>Laptop</guilabel>) or large keyboard layout with a numeric keypad (<guilabel>Desktop</guilabel>). If you choose <guilabel>Laptop</guilabel> the <application>Orca</application> system key is <keycap>Caps Lock</keycap>; for the <guilabel>Desktop</guilabel> layout the system key is <keycap>Insert</keycap>.
</para>
</section>
@@ -392,8 +394,7 @@ and choose from the list of available synthesizers.
<section>
<title>Voice Settings</title>
<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 uppercase text. The voice settings and person combo boxes can be
-adjusted to customize these settings to your liking. For example, assume you were using Fonix DECtalk and wanted the Betty voice to denote uppercase. To accomplish this, you could do the following:
+If your synthesizer supports it, <application>Orca</application> can utilize multiple voices in order to identify special cases within an application, such as hyperlinks or uppercase text. The voice settings and person combo boxes can be adjusted to customize these settings to your liking. For example, assume you were using Fonix DECtalk and wanted the Betty voice to denote uppercase. To accomplish this, you could do the following:
</para>
<orderedlist numeration='arabic'>
<listitem>
@@ -421,8 +422,7 @@ Note that you can quickly raise/lower the pitch by pressing <keycombo><keycap>In
<section>
<title>Punctuation Level</title>
<para>
-The <guilabel>Punctuation Level</guilabel> radio button group is used to adjust the amount of punctuation spoken by the synthesizer. The available levels are
-None, Some, Most and All.
+The <guilabel>Punctuation Level</guilabel> radio button group is used to adjust the amount of punctuation spoken by the synthesizer. The available levels are None, Some, Most and All.
</para>
</section>
@@ -439,9 +439,7 @@ will speak shortcut keys for items in pull-down menus. When it is set to <guilab
<para>
The table row speech option determines the way in which <application>Orca</application> will read items within tables. The available
settings are <guilabel>Speak Current Row
-</guilabel> or <guilabel>Speak Current Cell</guilabel>. The ability to adjust this behavior can be useful in many situations. For example, consider the process of
-browsing email messages in Evolution. In this instance it may be preferable to set table speech to <guilabel>Speak Current Row</guilabel>, so arrowing through the list of messages causes all relevant info, such as the sender, subject, and whether the message has attachments, is read automatically.
-While the current row setting is active, it is still possible to read individual cells by using the left and right arrows.
+</guilabel> or <guilabel>Speak Current Cell</guilabel>. The ability to adjust this behavior can be useful in many situations. For example, consider the process of browsing email messages in Evolution. In this instance it may be preferable to set table speech to <guilabel>Speak Current Row</guilabel>, so arrowing through the list of messages causes all relevant info, such as the sender, subject, and whether the message has attachments, is read automatically. While the current row setting is active, it is still possible to read individual cells by using the left and right arrows.
</para>
<para>
Note that you can quickly toggle this behavior by pressing <keycombo><keycap>Insert</keycap><keycap>F11</keycap></keycombo>.
@@ -494,16 +492,14 @@ purposes, but is also useful for <application>Orca</application> developers who
The <guilabel>Abbreviated Role Names</guilabel> check box determines the manner in which role names are displayed and can be used to help conserve real estate on the Braille display. This option is best explained by example:
</para>
<para>
-Let us assume that a slider had focus, and that the abbreviated role names box was not checked. In that case, the word "slider" would be shown on the display, to reflect the fact that the current control was indeed
-a slider. If the abbreviated role names box was checked, the word "slider" would be abbreviated to "sldr".
+Let us assume that a slider had focus, and that the abbreviated role names box was not checked. In that case, the word "slider" would be shown on the display, to reflect the fact that the current control was indeed a slider. If the abbreviated role names box was checked, the word "slider" would be abbreviated to "sldr".
</para>
</section>
<section>
<title>Verbosity</title>
<para>
-The <guilabel>Verbosity</guilabel> radio button group determines the amount of information that will be output to Braille in certain situations. For example, if it is set to Verbose, keyboard shortcut and role name
-information is displayed. This information is not displayed in Brief mode.
+The <guilabel>Verbosity</guilabel> radio button group determines the amount of information that will be output to Braille in certain situations. For example, if it is set to Verbose, keyboard shortcut and role name information is displayed. This information is not displayed in Brief mode.
</para>
</section>
</section>
@@ -525,8 +521,7 @@ The first control on the key echo page is the
The alphanumeric and punctuation option determines if letter, number and punctuation characters are echoed as you type them.
</para>
<para>
-Modifier keys are those such as <keycap>Shift</keycap>,
-<keycap>Control</keycap>, and
+Modifier keys are those such as <keycap>Shift</keycap>, <keycap>Control</keycap>, and
<keycap>Alt</keycap>.
</para>
@@ -774,8 +769,7 @@ If you decide to check others or wish to adjust the order, there are four button
</listitem>
</itemizedlist>
<para>
-Text attributes can also be set on an individual application basis. The text attribute pane is also part of the application specific settings dialog that is
-started when you give a particular application focus and press <keycombo>
+Text attributes can also be set on an individual application basis. The text attribute pane is also part of the application specific settings dialog that is started when you give a particular application focus and press <keycombo>
<keycap>Insert</keycap><keycap>Ctrl</keycap>
<keycap>Space</keycap></keycombo>.
</para>
@@ -788,8 +782,7 @@ started when you give a particular application focus and press <keycombo>
<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.
+<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>
@@ -802,26 +795,18 @@ We are currently working on a script for Adobe's Acrobat Reader, and the initial
<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>.
+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>
+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>.
+<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>
@@ -1267,7 +1252,6 @@ pressing <keycombo><keycap>Ctrl</keycap>
</para>
</section>
</section>
-</section>
<section id="themes-0">
<title>Desktop Appearance Enhancement</title>