_File: GAG/enable.xml _Reas: resectioning ch2

svn path=/trunk/; revision=884

2 files changed, 60 insertions, 11 deletions

diff --git a/gnome2-accessibility-guide/C/ChangeLog b/gnome2-accessibility-guide/C/ChangeLog
index 0c8ef7e..4f312e8 100644
--- a/gnome2-accessibility-guide/C/ChangeLog
+++ b/gnome2-accessibility-guide/C/ChangeLog
@@ -1,3 +1,7 @@
+2008-06-19  Vincent Alexander <vpalexander@svn.gnome.org>
+
+	* enable.xml: Ch#2 sectioning
+
 2008-06-18  Vincent Alexander <vpalexander@svn.gnome.org>
 
 	* low-vision.xml: reworded BrlTTY intro
diff --git a/gnome2-accessibility-guide/C/enable.xml b/gnome2-accessibility-guide/C/enable.xml
index 244487a..fdad068 100644
--- a/gnome2-accessibility-guide/C/enable.xml
+++ b/gnome2-accessibility-guide/C/enable.xml
@@ -1,17 +1,17 @@
 <chapter id="enabling-accessibility" status="writing">
 <title>Enabling Accessibility Tools</title>
 
-<section id="enable-1">
-<title>Essential Keyboard Commands</title>
 <para>
 Before moving forward, be sure you are familiar with these essential GNOME commands:
 </para>
 <para>
 <keycap>Alt-F1</keycap> - display and activate the GNOME Desktop menu bar. This grants access to the <guilabel>Applications</guilabel>, <guilabel>Places</guilabel> and <guilabel>System</guilabel> menu bar items.
 </para>
+<note>
 <para>
 For Solaris systems, this key is <keycap>Ctrl-Esc</keycap> (as with Microsoft Windows).
 </para>
+</note>
 <para>
 <keycap>Alt-F2</keycap> - summons the <emphasis>Run</emphasis> 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 <keycap>Alt-F1</keycap> approach.
 </para>
@@ -25,8 +25,8 @@ For Solaris systems, this key is <keycap>Ctrl-Esc</keycap> (as with Microsoft Wi
 Knowing how to interact with common GNOME-standard user controls (such as text boxes, drop-down lists and radio groups) is also essential - review [todo: ulink here] to become familiar with these elements and how to quickly and efficiently navigate them.
 </para>
 
-<section>
-<title>Starting GOK (GNOME Onscreen Keyboard)</title>
+<section id="enable-gok">
+<title>GOK (GNOME Onscreen Keyboard)</title>
 <para>
 You must enable the assistive technology services before you are able to use many of the accessibility tools available.
 </para>
@@ -72,7 +72,6 @@ Enter: <userinput>gok</userinput>
 <para>
 If the Sticky Keys feature is not yet enabled, <application>gok</application> will do so the first time it runs.
 </para>
-
 <para>
 Installing gok for rpm-based systems: [not impl.]
 </para>
@@ -95,8 +94,8 @@ Enter: <userinput>gok</userinput>
 </procedure>
 </section>
 
-<section>
-<title>Starting Orca</title>
+<section id="enable-orca">
+<title>Orca</title>
 <para>
 Use <keycap>Alt-F2</keycap> to bring up the <emphasis>Run</emphasis> dialog, type in <literal>orca</literal> and press <keycap>Enter</keycap>. The first time <application>Orca</application> is launched you will be asked a few questions:
 </para>
@@ -127,8 +126,53 @@ After completing the first-time <application>Orca</application> settings, use <k
 </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>
+
 <section>
-<title>Setting Orca Preferences</title>
+<title>[todo: relocate onward] Setting Orca Preferences</title>
 <para>
 When the <application>Orca</application> main window appears, the default button is <guilabel>Preferences</guilabel>; just press <keycap>Enter</keycap> and the GUI configuration dialog will appear. If you move control focus from this button, use <keycap>Alt-P</keycap> to open <guilabel>Preferences</guilabel> while the <application>Orca</application> main window has application focus.
 </para>
@@ -138,14 +182,17 @@ To adjust <application>Orca</application> for your requirements, <keycap>Alt-Tab
 <para>
 If you are using large print fonts, the entire <guilabel>Preferences</guilabel> configuration dialog may not fit on your screen. You may have to temporarily downsize to another theme or adjust your monitor resolution before effectively using the <guilabel>Preferences</guilabel> dialog.
 </para>
+<note>
 <para>
 [Orca may later employ a fully scrollable window (with both vertical and horizontal scroll bars) or the GNOME Desktop itself may add this windowing feature (perhaps by panelizing all child controls). This particular window behavior is currently developer-dependent.]
 </para>
+</note>
 <para>
 The GUI configuration dialog is made up of several sections, each denoted by a notebook tab at the top of the dialog. These tabs can be navigated with the left/right arrow keys when the tabstrip has focus. Press the down arrow or <keycap>Tab</keycap> to move from the tabstrip into the options area for the currently highlighted tab/section. To return to the tabstrip, use <keycap>Shift-Tab</keycap> until the tabstrip is selected again.
 </para>
+</section>
 
-<section id="orca_prefs">
+<section>
 <title>Orca Preferences - General Section</title>
 <para>
 <emphasis>Keyboard Layout</emphasis> - this radio group offers two mutually-exclusive options for indicating which keyboard layout applies to you: Desktop or Laptop. To quickly access <application>Orca</application> functions an "Orca modifier key" is used as a shift-type key, to be used in conjunction with other keys meaningful to <application>Orca</application>. This modifier (also called a system, shift or host key) is the <keycap>Insert</keycap> key for the Desktop layout and the <keycap>Caps Lock</keycap> key for the Laptop layout. For example, to bring up the GUI configuration dialog would require <keycap>Insert + Space</keycap> with the Desktop layout, or <keycap>Caps Lock + Space</keycap> when using the Laptop layout.
@@ -209,6 +256,4 @@ If speech is enabled, there are several additional settings which you can adjust
 
 
 </section>
-</section>
-</section>
 </chapter>