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

[vpalexander svn gnome org]

Author: vpalexander
Date: Fri Jun 20 17:18:21 2008
New Revision: 885
URL: http://svn.gnome.org/viewvc/gnome-user-docs?rev=885&view=rev

Log:
_File: GAG/enable.xml,GAG/config.xml _Reas: sectioning ch2/ch3

Added:
   trunk/gnome2-accessibility-guide/C/config.xml   (contents, props changed)
Modified:
   trunk/gnome2-accessibility-guide/C/ChangeLog
   trunk/gnome2-accessibility-guide/C/enable.xml
   trunk/gnome2-accessibility-guide/C/gnome-access-guide.xml

Added: trunk/gnome2-accessibility-guide/C/config.xml
==============================================================================
--- (empty file)
+++ trunk/gnome2-accessibility-guide/C/config.xml	Fri Jun 20 17:18:21 2008
@@ -0,0 +1,89 @@
+<chapter id="configuring-accessibility" status="writing">
+<title>Configuring Accessibility Tools</title>
+
+<para>
+This chapter outlines how to configure and establish preferences for GNOME accessibility tools.
+</para>
+
+<section>
+<title>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>
+<para>
+To adjust <application>Orca</application> for your requirements, <keycap>Alt-Tab</keycap> to the <application>Orca</application> main window and press <keycap>Tab</keycap> by itself until <application>Orca</application> announces the <guilabel>Preferences</guilabel> button. Press <keycap>Enter</keycap> and you are presented with the GUI configuration dialog.
+</para>
+<note>
+<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>
+<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>
+<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.
+</para>
+<para>
+<emphasis>Show Orca main window</emphasis> - if enabled, the <application>Orca</application> application window will be shown in typical desktop Z-order and can be acessed with <keycap>Alt-Tab</keycap>. This provides access to the GUI configuration dialog and some other functionality, such as quitting <application>Orca</application>. If unchecked, no program window is displayed and all <application>Orca</application> functionality is achieved through keyboard or other means. Experienced users will likely prefer the window not shown, to avoid encountering it unnecessarily while using <keycap>Alt-Tab</keycap> or other window navigation methods.
+</para>
+<para>
+<emphasis>Quit Orca without confirmation</emphasis> - if checked, <application>Orca</application> will shut down without prompting to be sure the action was intended. If unchecked, <application>Orca</application> will always confirm any action that would quit <application>Orca</application> services.
+</para>
+<para>
+<emphasis>Disable gksu keyboard grab</emphasis> - checking this option will allow <application>Orca</application> to provide an accessible login. Disallowing the gksu keyboard grab also allows malicious software to observe everything you type, including login names and passwords, so be aware your security is somewhat reduced with this option enabled. 
+</para>
+<para>
+<emphasis>Present tooltips</emphasis> - if enabled, <application>Orca</application> will relay all application tooltips (balloon help messages), regardless of tooltip settings elsewhere. This is a global override option.
+</para>
+</section>
+
+<section>
+<title>Orca Preferences - Speech Section</title>
+<para>
+<emphasis>Enable Speech (Alt-E)</emphasis> - check this option to make use of speech functionality. If unchecked, the other controls in this section will be disabled, as their settings are not relevant without speech being enabled. 
+</para>
+<para>
+If speech is enabled, there are several additional settings which you can adjust:
+</para>
+<para>
+<emphasis>Speech System (Alt-S)</emphasis> - If you have additional hardware or software speech services, they can be selected here. Otherwise the only setting is GNOME Speech Services (the default, always-available option). 
+</para>
+<para>
+<emphasis>Speech Synthesizer (Alt-Z)</emphasis> - If you have additional hardware or software speech synthesizers, they can be selected here. Otherwise the only setting is the eSpeak GNOME Speech Driver (the default, always-available option). 
+</para>
+<para>
+<emphasis>Voice Settings (Alt-V)</emphasis> - you can select among three options: Default, Uppercase or Hyperlink. [todo: differences]
+</para>
+<para>
+<emphasis>Person (Alt-P)</emphasis> - depending on the source language, a multitude of vocal personalities may exist, allowing for variation in regional accent and dialectal enunciation.
+</para>
+<para>
+<emphasis>Rate (Alt-R)</emphasis> - this setting effectively sets how fast words are spoken. After some familiarity and attunement, you may be able to increase this setting, achieving more feedback in less time. 
+</para>
+<para>
+<emphasis>Pitch (Alt-T)</emphasis> - this setting is used to raise or lower the vocal tonality of speech. Adjust pitch to complement your other settings for best tonal clarity.
+</para>
+<para>
+<emphasis>Volume (Alt-L)</emphasis> - this setting is used to raise or lower the speech volume relative to the main sound mixer, with 9.0 equalling current maximum system volume.
+</para>
+<para>
+<emphasis>Punctuation Level</emphasis> - this radio group determines the amount of punctuation spoken: None (Alt-N), Some (Alt-M), Most (Alt-O) or All (Alt-A).
+</para>
+<para>
+<emphasis>Verbosity</emphasis> - this radio group determines the amount of verbal feedback [todo: expand]: Brief (Alt-B) or Verbose (Alt-B).
+</para>
+<para>
+<emphasis>Table Row Speech</emphasis> - this radio group specifies whether an individual Cell (Alt-C) is spoken or the entire Row (Alt-R) when navigating cell/row table structures.
+</para>
+
+
+</section>
+</chapter>

Modified: trunk/gnome2-accessibility-guide/C/enable.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/enable.xml	(original)
+++ trunk/gnome2-accessibility-guide/C/enable.xml	Fri Jun 20 17:18:21 2008
@@ -170,90 +170,4 @@
 </listitem>
 </itemizedlist>
 </section>
-
-<section>
-<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>
-<para>
-To adjust <application>Orca</application> for your requirements, <keycap>Alt-Tab</keycap> to the <application>Orca</application> main window and press <keycap>Tab</keycap> by itself until <application>Orca</application> announces the <guilabel>Preferences</guilabel> button. Press <keycap>Enter</keycap> and you are presented with the GUI configuration dialog.
-</para>
-<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>
-<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.
-</para>
-<para>
-<emphasis>Show Orca main window</emphasis> - if enabled, the <application>Orca</application> application window will be shown in typical desktop Z-order and can be acessed with <keycap>Alt-Tab</keycap>. This provides access to the GUI configuration dialog and some other functionality, such as quitting <application>Orca</application>. If unchecked, no program window is displayed and all <application>Orca</application> functionality is achieved through keyboard or other means. Experienced users will likely prefer the window not shown, to avoid encountering it unnecessarily while using <keycap>Alt-Tab</keycap> or other window navigation methods.
-</para>
-<para>
-<emphasis>Quit Orca without confirmation</emphasis> - if checked, <application>Orca</application> will shut down without prompting to be sure the action was intended. If unchecked, <application>Orca</application> will always confirm any action that would quit <application>Orca</application> services.
-</para>
-<para>
-<emphasis>Disable gksu keyboard grab</emphasis> - checking this option will allow <application>Orca</application> to provide an accessible login. Disallowing the gksu keyboard grab also allows malicious software to observe everything you type, including login names and passwords, so be aware your security is somewhat reduced with this option enabled. 
-</para>
-<para>
-<emphasis>Present tooltips</emphasis> - if enabled, <application>Orca</application> will relay all application tooltips (balloon help messages), regardless of tooltip settings elsewhere. This is a global override option.
-</para>
-</section>
-
-<section>
-<title>Orca Preferences - Speech Section</title>
-<para>
-<emphasis>Enable Speech (Alt-E)</emphasis> - check this option to make use of speech functionality. If unchecked, the other controls in this section will be disabled, as their settings are not relevant without speech being enabled. 
-</para>
-<para>
-If speech is enabled, there are several additional settings which you can adjust:
-</para>
-<para>
-<emphasis>Speech System (Alt-S)</emphasis> - If you have additional hardware or software speech services, they can be selected here. Otherwise the only setting is GNOME Speech Services (the default, always-available option). 
-</para>
-<para>
-<emphasis>Speech Synthesizer (Alt-Z)</emphasis> - If you have additional hardware or software speech synthesizers, they can be selected here. Otherwise the only setting is the eSpeak GNOME Speech Driver (the default, always-available option). 
-</para>
-
-<para>
-<emphasis>Voice Settings (Alt-V)</emphasis> - you can select among three options: Default, Uppercase or Hyperlink. [todo: differences]
-</para>
-
-<para>
-<emphasis>Person (Alt-P)</emphasis> - depending on the source language, a multitude of vocal personalities may exist, allowing for variation in regional accent and dialectal enunciation.
-</para>
-
-<para>
-<emphasis>Rate (Alt-R)</emphasis> - this setting effectively sets how fast words are spoken. After some familiarity and attunement, you may be able to increase this setting, achieving more feedback in less time. 
-</para>
-
-<para>
-<emphasis>Pitch (Alt-T)</emphasis> - this setting is used to raise or lower the vocal tonality of speech. Adjust pitch to complement your other settings for best tonal clarity.
-</para>
-<para>
-<emphasis>Volume (Alt-L)</emphasis> - this setting is used to raise or lower the speech volume relative to the main sound mixer, with 9.0 equalling current maximum system volume.
-</para>
-<para>
-<emphasis>Punctuation Level</emphasis> - this radio group determines the amount of punctuation spoken: None (Alt-N), Some (Alt-M), Most (Alt-O) or All (Alt-A).
-</para>
-<para>
-<emphasis>Verbosity</emphasis> - this radio group determines the amount of verbal feedback [todo: expand]: Brief (Alt-B) or Verbose (Alt-B).
-</para>
-<para>
-<emphasis>Table Row Speech</emphasis> - this radio group specifies whether an individual Cell (Alt-C) is spoken or the entire Row (Alt-R) when navigating cell/row table structures.
-</para>
-
-
-</section>
 </chapter>

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	Fri Jun 20 17:18:21 2008
@@ -8,6 +8,7 @@
   <!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">
@@ -213,26 +214,21 @@
 </revhistory>
  
 <releaseinfo> 
-This manual describes version &gnomeversion; of the 
-GNOME Desktop.
+This manual describes version &gnomeversion; of the GNOME Desktop.
 </releaseinfo>
  
 <legalnotice> 
 <title>Feedback</title> 
 <para> 
-To report a bug or make a suggestion regarding the 
-GNOME Desktop or this manual, follow the directions in 
-the 
-<ulink type="help" 
-url="ghelp:user-guide?feedback">
-GNOME Feedback Page
-</ulink>.
+To report a bug or make a suggestion regarding the GNOME Desktop or this manual, follow the directions in the <ulink type="help" 
+url="ghelp:user-guide?feedback">GNOME Feedback Page</ulink>.
 </para>
 </legalnotice> 
 </bookinfo>
 
 &accessintro;
 &enable;
+&config;
 &general;
 &low-vision;
 &mobility;