gnome-user-docs r925 - trunk/gnome2-accessibility-guide/C



Author: vpalexander
Date: Tue Jul 29 18:44:32 2008
New Revision: 925
URL: http://svn.gnome.org/viewvc/gnome-user-docs?rev=925&view=rev

Log:
resectioning per willie walker sun com

Modified:
   trunk/gnome2-accessibility-guide/C/enable.xml
   trunk/gnome2-accessibility-guide/C/general.xml
   trunk/gnome2-accessibility-guide/C/gnome-access-guide.xml
   trunk/gnome2-accessibility-guide/C/low-vision.xml
   trunk/gnome2-accessibility-guide/C/mobility.xml

Modified: trunk/gnome2-accessibility-guide/C/enable.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/enable.xml	(original)
+++ trunk/gnome2-accessibility-guide/C/enable.xml	Tue Jul 29 18:44:32 2008
@@ -1,281 +1,5 @@
 <chapter id="enabling-accessibility" status="writing">
-<title>Enabling Accessibility Tools</title>
 
-<para>
-Before moving forward, be sure you are familiar with these essential GNOME commands:
-</para>
-<para>
-<keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo> - display and activate the GNOME Desktop menu bar. This grants access to the <guimenu>Applications</guimenu>, <guimenu>Places</guimenu> and <guimenu>System</guimenu> menu bar items.
-</para>
-<note>
-<para>
-For Solaris systems, this key is <keycombo><keycap>Ctrl</keycap><keycap>Esc</keycap></keycombo> (as with Microsoft Windows).
-</para>
-</note>
-<para>
-<keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> - summons the <application>Run</application> dialog, where you can issue terminal commands with or without parameters. If a file needs to be passed as one of these parameters, use the <guilabel>Run With File</guilabel> button to easily locate the file needed. This dialog also presents an alternate list of known applications which may be easier to navigate for some than the typical <keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo> approach.
-</para>
-<note>
-<para>
-For Solaris systems, this key is <keycombo><keycap>Meta</keycap><keycap>R</keycap></keycombo> (as with Microsoft Windows). A meta- or super-key is an OS-logo shift key.
-</para>
-</note>
-<para>
-<keycap>Tab</keycap> and <keycombo><keycap>Shift</keycap><keycap>Tab</keycap></keycombo> - move focus within an application between controls; use <keycap>Tab</keycap> to cycle forward through controls and <keycombo><keycap>Shift</keycap><keycap>Tab</keycap></keycombo> to cycle backwards. Controls are any user-interactive element that you can manipulate, such as buttons, drop-down lists, text fields, etc. <keycombo><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo> and <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo> are used instead where <keycap>Tab</keycap> and <keycombo><keycap>Shift</keycap><keycap>Tab</keycap></keycombo> are reserved for use by the focused control.
-</para>
-<para>
-<keycombo><keycap>Alt</keycap><keycap>Tab</keycap></keycombo> and <keycombo><keycap>Shift</keycap><keycap>Alt</keycap><keycap>Tab</keycap></keycombo> - switches between currently running applications. If you have multiple programs running, use <keycombo><keycap>Alt</keycap><keycap>Tab</keycap></keycombo> to cycle forward through the applications and <keycombo><keycap>Shift</keycap><keycap>Alt</keycap><keycap>Tab</keycap></keycombo> to cycle backwards. <keycombo><keycap>Alt</keycap><keycap>Esc</keycap></keycombo> and <keycombo><keycap>Shift</keycap><keycap>Alt</keycap><keycap>Esc</keycap></keycombo> also cycle between applications, but without an application preview window.
-</para>
 
-<section id="enable-gok">
-<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>
-<procedure>
-<step>
-<para>
-Choose <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Assistive Technologies</guimenuitem></menuchoice>.
-</para>
-</step>
-<step>
-<para>
-Select <guilabel>Enable assistive technologies
-</guilabel> and then press <guibutton>Close and Log Out</guibutton>.
-</para>
-</step>
-<step>
-<para>
-Log back in. The assistive technology services will be started automatically.
-</para>
-</step>
-</procedure>
-
-<para>
-The next steps enable <application>gok</application> (GNOME Onscreen Keyboard). These steps are not necessary for Solaris and target Debian platforms (Ubuntu, etc.). See further down for rpm-based distributions (RedHat, Fedora, etc.).
-</para>
-<procedure>
-<step>
-<para>
-Choose <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice>.
-</para>
-</step>
-<step>
-<para>
-Enter: <userinput>sudo apt-get install gok</userinput>
-</para>
-</step>
-<step>
-<para>
-Enter: <userinput>gok</userinput>
-</para>
-</step>
-</procedure>
-<para>
-If the Sticky Keys feature is not yet enabled, <application>gok</application> will do so the first time it runs.
-</para>
-<para>
-TESTING -- Installing gok for rpm-based systems (specifically, Fedora RedHat):
-</para>
-<procedure>
-<step>
-<para>
-Download <ulink 
-url="http://rpmfind.net/linux/rpm2html/search.php?query=gnome-common";>the gok RPM package</ulink>.
-</para>
-<figure id="enable-gok-fig1">
-<title>RPM Search Results</title>
-<screenshot>
-<mediaobject>
-<imageobject>
-<imagedata fileref="figures/RPM_search_gnome_common.png" format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>Package listing</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
-</figure>
-</step>
-<step>
-<para>
-Choose <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice>.
-</para>
-</step>
-
-<step>
-<para>
-Enter: <userinput>rpm -Uvh your_downloaded_file.rpm</userinput>
-</para>
-</step>
-<step>
-<para>
-You will need to install several additional files from the RedHat distribution:
-</para>
-<para>
-<userinput>cd /distro_path/redhat-8.0/RedHat/RPMS</userinput>
-</para>
-<para>
-<userinput>rpm -Uvh perl-SGMLSpm-1.03ii-6.noarch.rpm</userinput>
-</para>
-<para>
-<userinput>rpm -Uvh docbook-style-dsssl-1.76-6.noarch.rpm</userinput>
-</para>
-<para>
-<userinput>rpm -Uvh docbook-utils-0.6.11-2.noarch.rpm</userinput>
-</para>
-<para>
-<userinput>rpm -Uvh gtk-doc-0.9-5.noarch.rpm</userinput>
-</para>
-<para>
-<userinput>rpm -Uvh at-spi-1.0.1-4.i386.rpm</userinput>
-</para>
-<para>
-<userinput>rpm -Uvh at-spi-devel-1.0.1-4.i386.rpm</userinput>
-</para>
-<para>
-<userinput>rpm -Uvh libwnck-devel-0.17-1.i386.rpm</userinput>
-</para>
-</step>
-
-<step>
-<para>
-Install the latest version of <application>gok</application> from GNOME CVS:
-</para>
-<note>
-<para>
-When prompted for a password, press <keycap>Enter</keycap>.
-</para>
-</note>
-<para>
-<userinput>
-cvs -d :pserver:anonymous anoncvs gnome org:
-/cvs/gnome login
-</userinput>
-</para>
-<para>
-<userinput>
-cvs -d :pserver:anonymous anoncvs gnome org:/cvs/gnome -z3 checkout gok
-</userinput>
-</para>
-<note>
-<para>
-To update this release, use the terminal command <userinput>cvs -q up -P -d</userinput>
-</para>
-</note>
-</step>
-
-<step>
-<para>
-Run the autogen script:
-</para>
-<para>
-<userinput>cd gok/</userinput>
-</para>
-<para>
-<userinput>./autogen.sh</userinput>
-</para>
-<para>
-<userinput>make</userinput>
-</para>
-<para>
-<userinput>su -</userinput>
-</para>
-<para>
-<userinput>make install</userinput>
-</para>
-<para>
-<userinput>gok</userinput>
-</para>
-<note>
-<para>
-Because <application>gok</application> does not install <application>gconf</application> settings for individual users, run as root instead of an unpriviledged user.
-</para>
-</note>
-</step>
-</procedure>
-</section>
-
-<section id="enable-orca">
-<title>Orca</title>
-<para>
-For a text-only guided setup, open a terminal session (<keycap>Alt-F1 : Applications - Accessories - Terminal</keycap>) and use the command <userinput>orca --text-setup</userinput> <keycap>Enter</keycap>.
-</para>
-<para>
-Alternatively, use <keycap>Alt-F2</keycap> to bring up the <emphasis>Run</emphasis> dialog, type in <literal>orca</literal> and press <keycap>Enter</keycap>.
-</para>
-<para>
-The first time <application>Orca</application> is launched you will be asked a few questions:
-</para>
-<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>.
-</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>.
-</para>
-<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>.
-</para>
-<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.
-</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>.
-</para>
-<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>.
-</para>
-<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.
-</para>
-<para>
-After completing the first-time <application>Orca</application> settings, use <keycap>Alt-F2</keycap> to bring up the <emphasis>Run</emphasis> dialog, type in <literal>orca</literal> and press <keycap>Enter</keycap>. Accessibility functions should now be active.
-</para>
-</section>
-
-<section id="enable-dasher">
-<title>Dasher</title>
-<para>
-Dasher is an information-efficient text-entry interface, driven by natural continuous pointing gestures. Dasher is a competitive text-entry system wherever a full-size keyboard cannot be used - for example on a palmtop or wearable computer, or when operating any computer one-handed (by joystick, touchscreen or mouse) or zero-handed (eg, by head-mouse or eye-tracker).
-</para>
-<procedure>
-<step>
-<para>
-Choose <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice>.
-</para>
-</step>
-<step>
-<para>
-Enter: <userinput>sudo apt-get install dasher
-</userinput>
-</para>
-</step>
-<step>
-<para>
-Enter: <userinput>dasher</userinput>
-</para>
-</step>
-</procedure>
-<para>
-Dasher may also be installed from the <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Add/Remove</guimenuitem></menuchoice> dialog. In either case, it may later be launched in these ways:
-</para>
-<itemizedlist>
-<listitem>
-<para>
-Press <keycap>Alt-F2</keycap> for the <emphasis>Run</emphasis> dialog, type <userinput>dasher</userinput> and press <keycap>Enter</keycap>.
-</para>
-</listitem>
-<listitem>
-<para>
-Choose <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice> and execute <userinput>dasher</userinput>.
-</para>
-</listitem>
-<listitem>
-<para>
-Press <keycap>Alt-F1</keycap> and select <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Universal Access</guimenuitem><guimenuitem>Dasher</guimenuitem></menuchoice>.
-</para>
-</listitem>
-</itemizedlist>
-</section>
 
 </chapter>

Modified: trunk/gnome2-accessibility-guide/C/general.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/general.xml	(original)
+++ trunk/gnome2-accessibility-guide/C/general.xml	Tue Jul 29 18:44:32 2008
@@ -7,6 +7,14 @@
 <listitem>
 <para>
 <emphasis>
+Essential Keyboard Commands
+</emphasis>
+ - covers some basic keyboard commands.
+</para>
+</listitem>
+<listitem>
+<para>
+<emphasis>
 Keyboard Desktop Navigation
 </emphasis>
  - allows users to navigate the desktop without using a mouse or pointer device.
@@ -22,6 +30,35 @@
 </listitem>
 </itemizedlist>
 
+<section>
+<title>Essential Keyboard Commands</title>
+<para>
+Before moving forward, be sure you are familiar with these essential GNOME commands:
+</para>
+<para>
+<keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo> - display and activate the GNOME Desktop menu bar. This grants access to the <guimenu>Applications</guimenu>, <guimenu>Places</guimenu> and <guimenu>System</guimenu> menu bar items.
+</para>
+<note>
+<para>
+For Solaris systems, this key is <keycombo><keycap>Ctrl</keycap><keycap>Esc</keycap></keycombo> (as with Microsoft Windows).
+</para>
+</note>
+<para>
+<keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> - summons the <application>Run</application> dialog, where you can issue terminal commands with or without parameters. If a file needs to be passed as one of these parameters, use the <guilabel>Run With File</guilabel> button to easily locate the file needed. This dialog also presents an alternate list of known applications which may be easier to navigate for some than the typical <keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo> approach.
+</para>
+<note>
+<para>
+For Solaris systems, this key is <keycombo><keycap>Meta</keycap><keycap>R</keycap></keycombo> (as with Microsoft Windows). A meta- or super-key is an OS-logo shift key.
+</para>
+</note>
+<para>
+<keycap>Tab</keycap> and <keycombo><keycap>Shift</keycap><keycap>Tab</keycap></keycombo> - move focus within an application between controls; use <keycap>Tab</keycap> to cycle forward through controls and <keycombo><keycap>Shift</keycap><keycap>Tab</keycap></keycombo> to cycle backwards. Controls are any user-interactive element that you can manipulate, such as buttons, drop-down lists, text fields, etc. <keycombo><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo> and <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>Tab</keycap></keycombo> are used instead where <keycap>Tab</keycap> and <keycombo><keycap>Shift</keycap><keycap>Tab</keycap></keycombo> are reserved for use by the focused control.
+</para>
+<para>
+<keycombo><keycap>Alt</keycap><keycap>Tab</keycap></keycombo> and <keycombo><keycap>Shift</keycap><keycap>Alt</keycap><keycap>Tab</keycap></keycombo> - switches between currently running applications. If you have multiple programs running, use <keycombo><keycap>Alt</keycap><keycap>Tab</keycap></keycombo> to cycle forward through the applications and <keycombo><keycap>Shift</keycap><keycap>Alt</keycap><keycap>Tab</keycap></keycombo> to cycle backwards. <keycombo><keycap>Alt</keycap><keycap>Esc</keycap></keycombo> and <keycombo><keycap>Shift</keycap><keycap>Alt</keycap><keycap>Esc</keycap></keycombo> also cycle between applications, but without an application preview window.
+</para>
+</section>
+
 <section id="sysadmin-27">
 <title>Accessible Login</title>
 <indexterm>

Modified: trunk/gnome2-accessibility-guide/C/gnome-access-guide.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/gnome-access-guide.xml	(original)
+++ trunk/gnome2-accessibility-guide/C/gnome-access-guide.xml	Tue Jul 29 18:44:32 2008
@@ -7,7 +7,6 @@
   <!ENTITY LEGAL SYSTEM "legal.xml">
   <!ENTITY accessintro SYSTEM "accessintro.xml">
   <!ENTITY sysadmin SYSTEM "sysadmin.xml">
-  <!ENTITY enable SYSTEM "enable.xml">
   <!ENTITY low-vision SYSTEM "low-vision.xml">
   <!ENTITY mobility SYSTEM "mobility.xml">
   <!ENTITY general SYSTEM "general.xml">
@@ -249,7 +248,6 @@
 </bookinfo>
 
 &accessintro;
-&enable;
 &general;
 &low-vision;
 &mobility;

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 Jul 29 18:44:32 2008
@@ -166,6 +166,43 @@
 </section>
 </section>
 
+<section id="enable-orca">
+<title>Enabling Orca</title>
+<para>
+For a text-only guided setup, open a terminal session (<keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo>) : Applications - Accessories - Terminal) and use the command <userinput>orca --text-setup</userinput> <keycap>Enter</keycap>.
+</para>
+<para>
+Alternatively, use <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> to bring up the <emphasis>Run</emphasis> dialog, type in <literal>orca</literal> and press <keycap>Enter</keycap>.
+</para>
+<para>
+The first time <application>Orca</application> is launched you will be asked a few questions:
+</para>
+<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>.
+</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>.
+</para>
+<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>.
+</para>
+<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.
+</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>.
+</para>
+<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>.
+</para>
+<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.
+</para>
+<para>
+After completing the first-time <application>Orca</application> settings, use <keycap>Alt-F2</keycap> to bring up the <emphasis>Run</emphasis> dialog, type in <literal>orca</literal> and press <keycap>Enter</keycap>. Accessibility functions should now be active.
+</para>
+</section>
+
 <section>
 <title>Using Orca</title>
 <section>
@@ -2185,7 +2222,7 @@
 </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 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>

Modified: trunk/gnome2-accessibility-guide/C/mobility.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/mobility.xml	(original)
+++ trunk/gnome2-accessibility-guide/C/mobility.xml	Tue Jul 29 18:44:32 2008
@@ -20,7 +20,7 @@
 </itemizedlist>
 
 <section>
-<title>On-Screen Keyboard</title>
+<title>GNOME On-Screen Keyboard (gok)</title>
 <indexterm>
 <primary>On-Screen Keyboard</primary>
 </indexterm>
@@ -43,15 +43,178 @@
 </para>
 </listitem>
 </itemizedlist>
+
+
 <para>
-To start <application>On-Screen Keyboard</application>, choose <menuchoice><guimenu>Applications</guimenu>
-<guisubmenu>Accessibility</guisubmenu>
-<guimenuitem>On-Screen Keyboard</guimenuitem>
-</menuchoice>. For more information about the 
-<application>On-Screen Keyboard</application> 
-application, see the <ulink type="help" 
-url="ghelp:gok"> Help for <application>On-Screen Keyboard</application></ulink>.
+You must enable the assistive technology services before you are able to use many of the accessibility tools available.
+</para>
+<procedure>
+<step>
+<para>
+Choose <menuchoice><guimenuitem>System</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>Assistive Technologies</guimenuitem></menuchoice>.
+</para>
+</step>
+<step>
+<para>
+Select <guilabel>Enable assistive technologies
+</guilabel> and then press <guibutton>Close and Log Out</guibutton>.
+</para>
+</step>
+<step>
+<para>
+Log back in. The assistive technology services will be started automatically.
+</para>
+</step>
+</procedure>
+
+<para>
+The next steps enable <application>gok</application> (GNOME Onscreen Keyboard). These steps are not necessary for Solaris and target Debian platforms (Ubuntu, etc.). See further down for rpm-based distributions (RedHat, Fedora, etc.).
+</para>
+<procedure>
+<step>
+<para>
+Choose <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice>.
+</para>
+</step>
+<step>
+<para>
+Enter: <userinput>sudo apt-get install gok</userinput>
+</para>
+</step>
+<step>
+<para>
+Enter: <userinput>gok</userinput>
+</para>
+</step>
+</procedure>
+<para>
+If the Sticky Keys feature is not yet enabled, <application>gok</application> will do so the first time it runs.
+</para>
+<para>
+TESTING -- Installing gok for rpm-based systems (specifically, Fedora RedHat):
+</para>
+<procedure>
+<step>
+<para>
+Download <ulink 
+url="http://rpmfind.net/linux/rpm2html/search.php?query=gnome-common";>the gok RPM package</ulink>.
+</para>
+<figure id="enable-gok-fig1">
+<title>RPM Search Results</title>
+<screenshot>
+<mediaobject>
+<imageobject>
+<imagedata fileref="figures/RPM_search_gnome_common.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Package listing</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+</figure>
+</step>
+<step>
+<para>
+Choose <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice>.
+</para>
+</step>
+
+<step>
+<para>
+Enter: <userinput>rpm -Uvh your_downloaded_file.rpm</userinput>
+</para>
+</step>
+<step>
+<para>
+You will need to install several additional files from the RedHat distribution:
+</para>
+<para>
+<userinput>cd /distro_path/redhat-8.0/RedHat/RPMS</userinput>
+</para>
+<para>
+<userinput>rpm -Uvh perl-SGMLSpm-1.03ii-6.noarch.rpm</userinput>
+</para>
+<para>
+<userinput>rpm -Uvh docbook-style-dsssl-1.76-6.noarch.rpm</userinput>
+</para>
+<para>
+<userinput>rpm -Uvh docbook-utils-0.6.11-2.noarch.rpm</userinput>
+</para>
+<para>
+<userinput>rpm -Uvh gtk-doc-0.9-5.noarch.rpm</userinput>
+</para>
+<para>
+<userinput>rpm -Uvh at-spi-1.0.1-4.i386.rpm</userinput>
+</para>
+<para>
+<userinput>rpm -Uvh at-spi-devel-1.0.1-4.i386.rpm</userinput>
+</para>
+<para>
+<userinput>rpm -Uvh libwnck-devel-0.17-1.i386.rpm</userinput>
+</para>
+</step>
+
+<step>
+<para>
+Install the latest version of <application>gok</application> from GNOME CVS:
+</para>
+<note>
+<para>
+When prompted for a password, press <keycap>Enter</keycap>.
+</para>
+</note>
+<para>
+<userinput>
+cvs -d :pserver:anonymous anoncvs gnome org:
+/cvs/gnome login
+</userinput>
+</para>
+<para>
+<userinput>
+cvs -d :pserver:anonymous anoncvs gnome org:/cvs/gnome -z3 checkout gok
+</userinput>
+</para>
+<note>
+<para>
+To update this release, use the terminal command <userinput>cvs -q up -P -d</userinput>
+</para>
+</note>
+</step>
+
+<step>
+<para>
+Run the autogen script:
+</para>
+<para>
+<userinput>cd gok/</userinput>
+</para>
+<para>
+<userinput>./autogen.sh</userinput>
+</para>
+<para>
+<userinput>make</userinput>
 </para>
+<para>
+<userinput>su -</userinput>
+</para>
+<para>
+<userinput>make install</userinput>
+</para>
+<para>
+<userinput>gok</userinput>
+</para>
+<note>
+<para>
+Because <application>gok</application> does not install <application>gconf</application> settings for individual users, run as root instead of an unpriviledged user.
+</para>
+</note>
+</step>
+</procedure>
+<para>
+For more information about the 
+<application>On-Screen Keyboard</application> application, see the <ulink type="help" url="ghelp:gok"> Help for <application>On-Screen Keyboard</application></ulink>.
+</para>
+</section>
 
 <section id="ats-5">
 <title>Maximizing Application Windows for On-Screen Keyboard Users
@@ -86,7 +249,6 @@
 </listitem>
 </orderedlist>
 </section>
-</section>
 
 <section id="dtconfig-0">
 <title>Mouse and Keyboard Enhancements</title>
@@ -343,7 +505,8 @@
 <emphasis>"Allow to control the pointer using the keyboard" (Alt-A)</emphasis> - this determines if the keyboard can be used to control the mouse pointer.
 </para>
 <para>
-<emphasis>Acceleration (Alt-C)</emphasis> - determines how quickly mouse motion will accelerate when keyboard directional keys are pressed.
+<emphasis>Acceleration (Alt-C)</emphasis> - determines how quickly mouse motion will accelerate when keyboard directional keys are 
+pressed.
 </para>
 <para>
 <emphasis>Speed (Alt-S)</emphasis> - determines how quickly the mouse pointer will move when keyboard directional keys are pressed.
@@ -423,6 +586,60 @@
 </section>
 </section>
 
+<section id="enable-dasher">
+<title>Dasher</title>
+<para>
+Dasher is an information-efficient text-entry interface, driven by natural continuous pointing gestures. Dasher is a competitive text-entry system wherever a full-size keyboard cannot be used - for example on a palmtop or wearable computer, or when operating any computer one-handed (by joystick, touchscreen or mouse) or zero-handed (eg, by head-mouse or eye-tracker).
+</para>
+<procedure>
+<step>
+<para>
+Choose <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice>.
+</para>
+</step>
+<step>
+<para>
+Enter: <userinput>sudo apt-get install dasher
+</userinput>
+</para>
+</step>
+<step>
+<para>
+Enter: <userinput>dasher</userinput>
+</para>
+</step>
+</procedure>
+<para>
+Dasher may also be installed from the <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Add/Remove</guimenuitem></menuchoice> dialog. In either case, it may later be launched in these ways:
+</para>
+<itemizedlist>
+<listitem>
+<para>
+Press <keycap>Alt-F2</keycap> for the <emphasis>Run</emphasis> dialog, type <userinput>dasher</userinput> and press <keycap>Enter</keycap>.
+</para>
+</listitem>
+<listitem>
+<para>
+Choose <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Accessories</guimenuitem><guimenuitem>Terminal</guimenuitem></menuchoice> and execute <userinput>dasher</userinput>.
+</para>
+</listitem>
+<listitem>
+<para>
+Press <keycap>Alt-F1</keycap> and select <menuchoice><guimenuitem>Applications</guimenuitem><guimenuitem>Universal Access</guimenuitem><guimenuitem>Dasher</guimenuitem></menuchoice>.
+</para>
+</listitem>
+</itemizedlist>
+</section>
+
+<section>
+<title>onBoard</title>
+<para>
+<application>onBoard</application> (formerly known as <application>sok</application>) is an alternate implementation of an on-screen keyboard (similar to <application>gok - GNOME Onscreen Keyboard</application>). The <application>onBoard</application> application is available for Ubuntu version 6.10 and forward. Packages may be downloaded for other distributions. 
+</para>
+</section>
+
+
+
 <!--
 <listitem>
 <para>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]