gnome-user-docs r926 - trunk/gnome2-accessibility-guide/C
- From: vpalexander svn gnome org
- To: svn-commits-list gnome org
- Subject: gnome-user-docs r926 - trunk/gnome2-accessibility-guide/C
- Date: Tue, 29 Jul 2008 19:27:33 +0000 (UTC)
Author: vpalexander
Date: Tue Jul 29 19:27:33 2008
New Revision: 926
URL: http://svn.gnome.org/viewvc/gnome-user-docs?rev=926&view=rev
Log:
corrections per willie walker sun com
Modified:
trunk/gnome2-accessibility-guide/C/general.xml
trunk/gnome2-accessibility-guide/C/low-vision.xml
trunk/gnome2-accessibility-guide/C/mobility.xml
trunk/gnome2-accessibility-guide/C/sysadmin.xml
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 19:27:33 2008
@@ -88,7 +88,7 @@
</itemizedlist>
<note>
<para>
-Ceessible login features are presently 100% functioning for Solaris only.
+Accessible login features are presently 100% functioning for Solaris only.
</para>
</note>
@@ -183,8 +183,7 @@
</itemizedlist>
<para>
For optimum accessibility, include
-<literal>gail</literal> and
-<literal>atk-bridge</literal>.
+<literal>gail</literal> and <literal>atk-bridge</literal>.
</para>
</listitem>
<listitem>
@@ -228,9 +227,7 @@
<primary>gestures</primary>
</indexterm>
<para>
-If you load the <literal>keymouselistener</literal> and
-<literal>dwellmouselistener</literal> GtkModules in the GDM configuration file, you can assign user actions to launch specific assistive technologies at login time. These user actions are called gestures. The gesture associations are contained in the following
-GDM configuration files:
+If you load the <literal>keymouselistener</literal> and <literal>dwellmouselistener</literal> GtkModules in the GDM configuration file, you can assign user actions to launch specific assistive technologies at login time. These user actions are called gestures. The gesture associations are contained in the following GDM configuration files:
</para>
<itemizedlist>
<listitem>
@@ -264,17 +261,18 @@
</note>
<section id="sysadmin-30">
-<title>Starting the Screen Reader Using a Keyboard
-Shortcut</title>
+<title>Starting the Screen Reader Using a Keyboard Shortcut</title>
<para>
-Edit the <filename>AccessKeyMouseEvents</filename> file to associate keyboard shortcuts with assistive technologies. For example, the following line enables
-you to press and hold <keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
-for one second to start <application>Screen Reader and Magnifier</application> in speech and Braille mode:
+Edit the <filename>AccessKeyMouseEvents</filename> file to associate keyboard shortcuts with assistive technologies. For example, the following lines enable you to press and hold <keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo> or <keycombo><keycap>Ctrl</keycap><keycap>M</keycap></keycombo> for one second to either start speech or magnification:
</para>
<para>
<literal>
-<Control>s 1 1000 10000 srcore --login
---disable-magnifier --enable-speech --enable-braille
+<Control>s 1 1000 10000 /usr/bin/orca -n -d main-window
+</literal>
+</para>
+<para>
+<literal>
+<Control>m 1 1000 10000 /usr/bin/orca -n -d main-window -e magnifier
</literal>
</para>
</section>
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 19:27:33 2008
@@ -17,7 +17,7 @@
<listitem>
<para>
<emphasis>Screen Reader</emphasis> - this makes on-screen information available as
-synthesized speech and/or a refreshable Braille display. They generally only translate text-based information. Graphics and other non-textual objects can be
+synthesized speech and/or a refreshable braille display. They generally only translate text-based information. Graphics and other non-textual objects can be
translated if there is alternative text
describing the item. They are also known as
blind access utilities or screen reviewers.
@@ -47,7 +47,7 @@
Screen Reader
</para>
<para>
-The screen reader enables non-visual access to standard applications in the GNOME Desktop by using speech and Braille output.
+The screen reader enables non-visual access to standard applications in the GNOME Desktop by using speech and braille output.
</para>
</listitem>
<listitem>
@@ -68,7 +68,7 @@
<section>
<title>What is Orca?</title>
<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
+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>
</section>
@@ -113,18 +113,18 @@
</section>
<section>
-<title>Is Braille supported?</title>
+<title>Is braille supported?</title>
<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
+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.
</para>
</section>
<section>
-<title>Are Grade 2 Braille contractions supported?</title>
+<title>Are Grade 2 braille contractions supported?</title>
<para>
-Yes, <application>Orca</application> fully supports contracted Braille output.
+Yes, <application>Orca</application> fully supports contracted braille output.
</para>
</section>
@@ -190,10 +190,10 @@
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>.
+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>.
+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.
@@ -266,7 +266,7 @@
</section>
<section>
-<title>Use a keyboard command to make Orca speak or Braille-output the current date and time</title>
+<title>Use a keyboard command to make Orca speak or braille-output the current date and time</title>
<para>
Place the following lines in <userinput>~/.orca/orca-customizations.py</userinput>. If this file doesn't exist yet, go ahead and create it.
</para>
@@ -326,8 +326,8 @@
<title>Orca Configuration</title>
<para>
The <application>Orca</application> configuration dialog 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 between Laptop/Desktop keyboard
+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 between Laptop/Desktop keyboard
layouts and you can also examine and modify the existing keyboard layout with granular
control. To bring up the <application>Orca</application> configuration dialog, press
<keycombo><keycap><ORCA MODIFIER></keycap><keycap>Space</keycap></keycombo>, where <userinput><ORCA MODIFIER></userinput> is <keycap>Insert</keycap>
@@ -411,7 +411,7 @@
<section>
<title>Enable Speech</title>
<para>
-The first control of note on the speech page is the <guilabel>Enable Speech</guilabel> 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 magnifier support, allows <application>Orca</application> to be tailored to meet the specific needs of a wide variety of users.
+The first control of note on the speech page is the <guilabel>Enable Speech</guilabel> 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 magnifier support, allows <application>Orca</application> to be tailored to meet the specific needs of a wide variety of users.
</para>
</section>
@@ -501,32 +501,32 @@
</section>
<section>
-<title>Braille Page</title>
+<title>braille Page</title>
<para>
-The Braille page allows you to customize various aspects of Braille output.
+The braille page allows you to customize various aspects of braille output.
</para>
<section>
-<title>Enable Braille Support</title>
+<title>Enable braille Support</title>
<para>
-The first control on the Braille page is the
-<guilabel>Enable Braille Support</guilabel> check box. This toggles whether or not <application>Orca</application> will make use of a Braille display. This option, along with the ability to enable Braille and magnifier support, allows <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 first control on the braille page is the
+<guilabel>Enable braille Support</guilabel> check box. This toggles whether or not <application>Orca</application> will make use of a braille display. This option, along with the ability to enable braille and magnifier support, allows <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>
</section>
<section>
-<title>Enable Braille Monitor</title>
+<title>Enable braille Monitor</title>
<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.
+<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>
</section>
<section>
<title>Abbreviated Role Names</title>
<para>
-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:
+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".
@@ -536,7 +536,7 @@
<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>
@@ -604,7 +604,7 @@
<section>
<title>Enable Magnifier</title>
<para>
-The first control on the magnifier page is the <guilabel>Enable Magnifier</guilabel> check box. This toggles whether or not <application>Orca</application> will provide magnification. This option, along with the ability to enable speech and Braille support, allow <application>Orca</application> to be tailored to meet the needs of a wide variety of users.
+The first control on the magnifier page is the <guilabel>Enable Magnifier</guilabel> check box. This toggles whether or not <application>Orca</application> will provide magnification. This option, along with the ability to enable speech and braille support, allow <application>Orca</application> to be tailored to meet the needs of a wide variety of users.
</para>
</section>
@@ -766,7 +766,7 @@
<keycap>R</keycap></keycombo>) that will set the list values back to their initial state when the dialog was first displayed.
</para>
<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 output to Braille.
+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 output to braille.
</para>
<para>
If you decide to check others or wish to adjust the order, there are four buttons to help you do this:
@@ -984,10 +984,10 @@
</section>
<section>
-<title>Braille</title>
+<title>braille</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.
+<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>
<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.
@@ -1044,7 +1044,7 @@
<section>
<title>Keyboard Commands</title>
<para>
-This is the list of common <application>Orca</application> keyboard commands. Note that you can always enter <application>Orca</application>'s Learn mode while running <application>Orca</application> by pressing <keycombo><keycap>Insert</keycap><keycap>F1</keycap></keycombo>. When in Learn mode, <application>Orca</application> will intercept all keyboard and Braille input events and will tell you what the effect of them would be. To exit Learn mode, press the <keycombo><keycap>Escape</keycap></keycombo> key. If you are using a laptop computer, you will want to see the <ulink url="http://live.gnome.org/Orca/LaptopKeyboardCommands";>laptop keyboard commands</ulink> page at live.gnome.org.
+This is the list of common <application>Orca</application> keyboard commands. Note that you can always enter <application>Orca</application>'s Learn mode while running <application>Orca</application> by pressing <keycombo><keycap>Insert</keycap><keycap>F1</keycap></keycombo>. When in Learn mode, <application>Orca</application> will intercept all keyboard and braille input events and will tell you what the effect of them would be. To exit Learn mode, press the <keycombo><keycap>Escape</keycap></keycombo> key. If you are using a laptop computer, you will want to see the <ulink url="http://live.gnome.org/Orca/LaptopKeyboardCommands";>laptop keyboard commands</ulink> page at live.gnome.org.
</para>
<section>
@@ -1239,7 +1239,7 @@
</para>
<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 <application>gnome-terminal</application>. Output is sent only to the console (i.e., it is not sent to speech or Braille).
+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 only to the console (i.e., it is not sent to speech or braille).
</para>
</note>
<para>
@@ -1643,18 +1643,6 @@
<row>
<entry colname="colspec0" valign="top">
<para>
-<guilabel>LowContrast</guilabel>
-</para>
-</entry>
-<entry colname="colspec1" valign="top">
-<para>
-Uses low-contrast colors for the background and foreground text.
-</para>
-</entry>
-</row>
-<row>
-<entry colname="colspec0" valign="top">
-<para>
<guilabel>LargePrint</guilabel>
</para>
</entry>
@@ -1689,18 +1677,6 @@
</para>
</entry>
</row>
-<row>
-<entry colname="colspec0" valign="top">
-<para>
-<guilabel>LowContrastLargePrint</guilabel>
-</para>
-</entry>
-<entry colname="colspec1" valign="top">
-<para>
-Uses low-contrast colors for the background and foreground text. Increases the size of controls to accommodate larger fonts. To increase the font size, you must use the <guilabel>Font</guilabel> section.
-</para>
-</entry>
-</row>
</tbody>
</tgroup>
</table>
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 19:27:33 2008
@@ -44,7 +44,6 @@
</listitem>
</itemizedlist>
-
<para>
You must enable the assistive technology services before you are able to use many of the accessibility tools available.
</para>
@@ -68,7 +67,7 @@
</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.).
+The next steps enable <application>gok</application> (GNOME Onscreen Keyboard). These steps are not necessary for Solaris (which ships with <application>gok</application> already loaded) and target Debian platforms (Ubuntu, etc.). See further down for rpm-based distributions (RedHat, Fedora, etc.).
</para>
<procedure>
<step>
Modified: trunk/gnome2-accessibility-guide/C/sysadmin.xml
==============================================================================
--- trunk/gnome2-accessibility-guide/C/sysadmin.xml (original)
+++ trunk/gnome2-accessibility-guide/C/sysadmin.xml Tue Jul 29 19:27:33 2008
@@ -241,12 +241,12 @@
</sect1>
<sect1 id="sysadmin-52">
-<title>Enabling Braille</title>
+<title>Enabling braille</title>
<indexterm>
-<primary>Braille, enabling</primary>
+<primary>braille, enabling</primary>
</indexterm>
<para>
-To enable your system to support Braille output, you must configure the access rights to the serial port to which the Braille device is connected:
+To enable your system to support braille output, you must configure the access rights to the serial port to which the braille device is connected:
</para>
<orderedlist>
<listitem>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
