From 65a499a34c1c0945abedcbeb76bb4625bed7aced Mon Sep 17 00:00:00 2001 From: Irene Ryan Date: Fri, 29 Jul 2005 13:13:30 +0000 Subject: Latest source files for the Accessibility Guide. These files have not been updated yet for GNOME 2.12. --- gnome2-accessibility-guide/C/accessintro.xml | 6 +- gnome2-accessibility-guide/C/ats.xml | 43 +-- gnome2-accessibility-guide/C/dtconfig.xml | 187 +++++------ .../C/gnome-access-guide-C.omf | 6 +- .../C/gnome-access-guide.xml | 12 +- gnome2-accessibility-guide/C/keynav.xml | 98 ++---- gnome2-accessibility-guide/C/preface.xml | 71 +--- gnome2-accessibility-guide/C/sysadmin.xml | 358 +++++++++++++++++---- gnome2-accessibility-guide/C/themes.xml | 57 ++-- 9 files changed, 491 insertions(+), 347 deletions(-) (limited to 'gnome2-accessibility-guide') diff --git a/gnome2-accessibility-guide/C/accessintro.xml b/gnome2-accessibility-guide/C/accessintro.xml index cb5476e..30ceb8b 100644 --- a/gnome2-accessibility-guide/C/accessintro.xml +++ b/gnome2-accessibility-guide/C/accessintro.xml @@ -13,13 +13,13 @@ to use the software easily and efficiently. Recent legislation such as Section 508 of the U.S. Rehabilitation Act heightens awareness of the need to provide accessible software. The GNOME Desktop is easy to use and incorporates many accessibility features. Every -application and utility in the GNOME Desktop is designed with accessibility and usability in mind. Users +supported application and utility in the GNOME Desktop is designed with accessibility and usability in mind. Users with physical disabilities such as low vision or impaired motor skills can use all of the functionality of the GNOME Desktop thanks to the customization tools that are available. The customization tools enable you to customize the appearance and behavior of the desktop. The ability to easily customize the GNOME Desktop contributes greatly to the accessibility of the desktop. -This guide describes the various customization options that you -can use to tailor the desktop to suit your particular needs. +This guide describes the various customization options that you can use to +tailor the desktop to suit your particular needs. diff --git a/gnome2-accessibility-guide/C/ats.xml b/gnome2-accessibility-guide/C/ats.xml index 649e94d..8df0dcc 100644 --- a/gnome2-accessibility-guide/C/ats.xml +++ b/gnome2-accessibility-guide/C/ats.xml @@ -14,6 +14,12 @@ disability to use the desktop: + +Before you can use the On-Screen Keyboard +and Screen Reader and Magnifier on Solaris systems, +you must follow the steps outlined in of this +guide. + On-Screen Keyboard @@ -23,8 +29,8 @@ disability to use the desktop: GOK The On-Screen Keyboard -application displays virtual keyboards on your desktop that you can operate -using the standard mouse pointer or alternative pointing device. On-Screen Keyboard displays the following types of keyboards: +application displays virtual keyboards on your desktop. You can use the standard +mouse pointer or alternative pointing device to operate the virtual keyboards. On-Screen Keyboard displays the following types of keyboards: Compose keyboards that enable you to compose text. To type @@ -39,24 +45,22 @@ or the menus that are contained in an application. To start On-Screen Keyboard, choose ApplicationsAccessibilityOn-Screen -Keyboard. For more information about the application, -see the online Help for On-Screen Keyboard. +Keyboard. For more information about the On-Screen Keyboard application, see the online Help for On-Screen Keyboard. -Maximizing Terminal for On-Screen Keyboard Users +Maximizing Application Windows for On-Screen Keyboard Users maximizing Terminal for On-Screen Keyboard users -If you are a On-Screen Keyboard -user, you cannot use the Terminal application in -Full Screen mode because the Terminal window obscures -the On-Screen Keyboard display. -To resize the Terminal window for use with the On-Screen Keyboard application, perform the following steps: +If you are an On-Screen Keyboard +user, you cannot use any application in Full Screen mode because the application +window obscures the On-Screen Keyboard display. +To resize the window for use with the On-Screen Keyboard application, perform the following steps: -Do not enable the Full Screen mode in Terminal. +Do not enable the Full Screen mode in the application. -Give focus to the Terminal window. +Give focus to the application window. Press F10 to maximize the application. @@ -92,14 +96,18 @@ to aid low-vision users. To start Screen Reader and Magnifier, choose ApplicationsAccessibilityScreen Reader and Magnifier. For more information about the application, see the online Help for Screen Reader and Magnifier. - -Disabling the Screensaver for Screen Reader and Magnifier Users + + +Disabling the Screensaver Screen Reader and Magnifier -disabling screensaver +disabling +screensaver -To disable the screensaver, -perform the following steps: +Before you use On-Screen +Keyboard or Screen Reader and Magnifier, +you must disable the screensaver. To disable the screensaver, perform the +following steps: Choose ApplicationsDesktop PreferencesDisplayScreensaver. @@ -118,6 +126,5 @@ deselect the Lock Screen After check box. Choose FileQuit to close the Screensaver Preferences dialog. - diff --git a/gnome2-accessibility-guide/C/dtconfig.xml b/gnome2-accessibility-guide/C/dtconfig.xml index 6fd17ac..ea67544 100644 --- a/gnome2-accessibility-guide/C/dtconfig.xml +++ b/gnome2-accessibility-guide/C/dtconfig.xml @@ -193,6 +193,10 @@ information. Use the Keyboard Accessibility preference tool, also known as AccessX, to configure the keyboard accessibility options. To start AccessX, choose ApplicationsDesktop PreferencesAccessibilityKeyboard. + +Before you can use the Keyboard Accessibility +preference tool on Solaris systems, you must follow the steps outlined in of this guide. + The Keyboard Accessibility Preferences (AccessX) dialog enables you to customize your keyboard in the following ways: @@ -219,73 +223,6 @@ a toggle key. See . repeat rate of a keypress. See . - -Before You Can Use AccessX on Solaris Systems - -XKB - -If you are using the desktop -for the Solaris 8 or Solaris 9 operating system, you must enable XKB on your -system before you can use the AccessX preference -tool. - -XKB is not currently supported on Sun Ray systems. - -To enable XKB on a non-Sun Ray Solaris system, perform the following -steps: - - -Log in as root. - - -Check if the path and file /etc/dt/config/Xservers exists on your system. - - -If the /etc/dt/config directory does -not exist, enter the following command: - -mkdir -p /etc/dt/config - - - -If the Xservers file is not present, -enter the following command: - -cp /usr/dt/config/Xservers /etc/dt/config/Xservers - - - -Open the Xservers file in a text editor -and scroll to the end of the file. - - -Append the following to the command line at the end of the -file: - -+kb - - - -Save and close the file. - - -Enter the following command at a command line: - -pkill -HUP dtlogin - - - -Log out of your session and log in again. - - -To verify if XKB is running, execute the following command: - -xdpyinfo - -then search for XKEYBOARD in the extensions list. - - - To Activate the Keyboard Accessibility Options @@ -294,6 +231,9 @@ file: To activate the keyboard accessibility options, perform the following steps: +Choose ApplicationsDesktop PreferencesAccessibilityKeyboard. + + Select the Enable keyboard accessibility features option. @@ -324,8 +264,8 @@ the keyboard accessibility options. different users, some of whom require the keyboard accessibility options. -If you are a Linux user, you must log out and log in again -before the accessibility settings take effect. +If you are a Linux user, log out and log in again before the +accessibility settings take effect. @@ -341,6 +281,9 @@ device. To enable and configure the mouse keys feature, perform the following steps: +Choose ApplicationsDesktop PreferencesAccessibilityKeyboard. + + Click on the Mouse Keys tab. @@ -384,7 +327,7 @@ move. When you enable mouse keys, the keys on the numeric keypad have the following functions: -Numeric Keypad to Mouse Functions Mapping on Solaris Systems +Numeric Keypad to Mouse Function Mapping on Solaris Systems @@ -449,7 +392,7 @@ following functions: -- +− Mouse button 3 @@ -459,7 +402,7 @@ following functions:
-Numeric Keypad to Mouse Functions Mapping on Linux Systems +Numeric Keypad to Mouse Function Mapping on Linux Systems @@ -514,7 +457,7 @@ mouse pointer around the screen buttons. The common function key to mouse button mappings are described in the following table.
-Function Keys to Mouse Functions Mapping on Solaris Systems +Function Key to Mouse Function Mapping on Solaris Systems @@ -580,18 +523,20 @@ This aspect of the feature benefits users who cannot see the result of a keypres steps: +Choose ApplicationsDesktop PreferencesAccessibilityKeyboard. + + Click on the Filters tab. Select the Enable Slow Keys option. -To select or deselect this feature from the keyboard, press-and-hold Shift for eight seconds. This keyboard shortcut automatically selects -all of the slow keys options. If you selected the Beep when features -turned on or off from the keyboard option, after four seconds the -system beeps three times to indicate that the system is about to select or -deselect the feature. If you enable this feature from the keyboard, you must -press-and-hold Shift for eight seconds again to disable the -feature. +To select or deselect the slow keys feature from the keyboard, +press-and-hold Shift for eight seconds. The Shift keyboard shortcut automatically selects all of the slow keys options. +If you selected the Beep when features turned on or off from the +keyboard option, after four seconds the system beeps three times +to indicate that the system is about to select or deselect the feature. If +you enable this feature from the keyboard, you must press-and-hold Shift for eight seconds again to disable the feature. @@ -651,6 +596,9 @@ enables you to customize the keyboard to ignore repeated keypresses. steps: +Choose ApplicationsDesktop PreferencesAccessibilityKeyboard. + + Click on the Filters tab. @@ -658,10 +606,11 @@ steps: Use the Ignore duplicate keypresses within -slider or spin box to specify the duration in milliseconds after the first -keypress for which the system ignores repeated keypresses of the same key. -For example, if you select a duration of 500 ms, the system ignores all repeated -keypresses of the same key that occur within 500 ms of the first keypress. +slider or spin box to specify the duration in milliseconds (ms) after the +first keypress for which the system ignores repeated keypresses of the same +key. For example, if you select a duration of 500 ms, the system ignores all +repeated keypresses of the same key that occur within 500 ms of the first +keypress. Select the Beep if key is rejected option @@ -669,13 +618,11 @@ to hear an audible indication when the system ignores a key. -If you wish to enable the bounce keys feature, please ensure that -the Enable Slow Keys option is deselected. The slow keys -feature requires you to press a key for a specified duration before the system -accepts the keypress as a valid keypress. If you cannot press the key for -the duration that is specified by the slow keys setting, the system does not -accept your input unless you deselect the Enable Slow Keys -option. +If you want to enable the bounce keys feature, ensure that the Enable Slow Keys option is deselected. The slow keys feature requires +you to press a key for a specified duration before the system accepts the +keypress as a valid keypress. If you cannot press the key for the duration +that is specified by the slow keys setting, deselect the Enable +Slow Keys option to enable the system to accept your input. @@ -691,17 +638,20 @@ press two or more keys simultaneously. steps: +Choose ApplicationsDesktop PreferencesAccessibilityKeyboard. + + Click on the Basic tab. Select the Enable Sticky Keys option. -To enable the sticky keys feature from the keyboard, press Shift five times. This keyboard shortcut automatically selects all -of the sticky keys options. If you selected the Beep when features -turned on or off from the keyboard option, the system beeps to -indicate that the system is about to select or deselect the feature. If you -enable this feature from the keyboard, press Shift five times -again to disable the feature. +To enable the sticky keys feature from the keyboard, press Shift five times. The Shift keyboard shortcut automatically +selects all of the sticky keys options. If you selected the Beep +when features turned on or off from the keyboard option, the system +beeps to indicate that the system is about to select or deselect the feature. +If you enable this feature from the keyboard, press Shift +five times again to disable the feature. @@ -711,9 +661,9 @@ such as Ctrl, Alt, or Shift. This option is useful to remind you whether a modifier key is active or inactive. -To automatically disable the sticky keys feature when a user -presses two keys simultaneously, select the Disable if two keys -pressed together option. +To automatically disable the sticky keys feature when you +press two keys simultaneously, select the Disable if two keys pressed +together option. You can use the sticky keys feature in latch or lock mode. The following @@ -733,7 +683,7 @@ table describes how to choose a mode and the difference between the two modes.Press the modifier key... -The modifier key stays active +The modifier key remains active until... @@ -765,7 +715,8 @@ a non-modifier key.
-For example, if you want to press AltF1, do the following: +Example 1: If you want to press AltF1, +do the following: Press Alt to latch the modifier key. The Alt key remains active. @@ -776,7 +727,7 @@ After you press F1, the Alt modifier key is no longer active. -As another example, if you want to press CtrlAltTab, do the following: +Example 2: If you want to press CtrlAltTab, do the following: Press Ctrl twice to lock the modifier key. @@ -806,10 +757,21 @@ toggle keys have an associated light emitting diode (LED) on the keyboard that lights when the toggle key is active. To assist users with visual impairments, you can customize the keyboard to emit an audible notification when a user presses a toggle key. For example, when you press Num Lock, -you can determine whether the key is toggled or not toggled by the sound. -To enable accessible toggle keys, select the Enable Toggle -Keys option in the Filters tabbed section. -When you activate the Num Lock, Caps Lock, +you can determine whether the key is toggled or not toggled by the sound that +the keyboard emits. +To enable accessible toggle keys, perform the following steps: + + +Choose ApplicationsDesktop PreferencesAccessibilityKeyboard. + + +Click on the Filters tab. + + +Select the Enable Toggle Keys option. + + +When you activate the Num Lock, Caps Lock, or Scroll Lock keys, the system beeps once. When you deactivate a toggle key, the system beeps twice. @@ -828,6 +790,9 @@ the key starts to repeat. steps: +Choose ApplicationsDesktop PreferencesAccessibilityKeyboard. + + Click on the Basic tab. @@ -852,8 +817,8 @@ the speed at which the keyboard repeats the keypress as input. Keyboard Accessibility Status panel application The Keyboard Accessibility Status -panel application shows the status of the keyboard accessibility features. -The panel application displays icons to indicate which keyboard accessibility +panel application shows you the status of the keyboard accessibility features. +This panel application displays icons to indicate which keyboard accessibility features are enabled in the Keyboard Accessibility preference tool. To add the Keyboard Accessibility Status @@ -1088,7 +1053,9 @@ key is latched. -The sticky keys feature is enabled and the Super/Windows key is locked. +The sticky +keys feature is enabled and the Super/Windows +key is locked. diff --git a/gnome2-accessibility-guide/C/gnome-access-guide-C.omf b/gnome2-accessibility-guide/C/gnome-access-guide-C.omf index faa5956..c939aaa 100755 --- a/gnome2-accessibility-guide/C/gnome-access-guide-C.omf +++ b/gnome2-accessibility-guide/C/gnome-access-guide-C.omf @@ -9,16 +9,16 @@ Accessibility Guide - 2005-03-07 + 2005-07-29 - + Accessibility Guide for the GNOME 2.10 Desktop diff --git a/gnome2-accessibility-guide/C/gnome-access-guide.xml b/gnome2-accessibility-guide/C/gnome-access-guide.xml index 6b41b39..b8fc71b 100644 --- a/gnome2-accessibility-guide/C/gnome-access-guide.xml +++ b/gnome2-accessibility-guide/C/gnome-access-guide.xml @@ -2,8 +2,8 @@ - - + + @@ -55,6 +55,14 @@ GNOME Documentation Project + + GNOME 2.10 Desktop Accessibility Guide V2.10.0 + March 2005 + + Sun Java Desktop System Documentation Team + GNOME Documentation Project + + GNOME 2.8 Desktop Accessibility Guide V2.8.0 September 2004 diff --git a/gnome2-accessibility-guide/C/keynav.xml b/gnome2-accessibility-guide/C/keynav.xml index cd4fba4..a9f7b22 100644 --- a/gnome2-accessibility-guide/C/keynav.xml +++ b/gnome2-accessibility-guide/C/keynav.xml @@ -18,10 +18,13 @@ shortcuts. keyboard shortcuts essential -The following table lists the essential keyboard shortcuts -that you can use to navigate the desktop. The keyboard shortcuts that you -use to navigate specific elements and controls are described in the appropriate -sections of this chapter. + +caret navigation mode + +The following table lists the essential keyboard shortcuts that you +can use to navigate the desktop. The keyboard shortcuts that you use to navigate +specific elements and controls are described in the appropriate sections of +this chapter. @@ -62,12 +65,12 @@ direction. CtrlTab -If -the Tab key has a specific purpose in a control, press CtrlTab to give focus to the next element or -control. For example, if you press Tab in a text box, the -system inserts a tab space. -To give focus to the previous element -or control, press ShiftCtrlTab. +Give +focus to the next element or control, if the Tab key has +a specific purpose in a control. For example, if you press Tab +in a text box, the system inserts a tab space. +To give focus to +the previous element or control, press ShiftCtrlTab. @@ -101,6 +104,18 @@ is the equivalent of clicking on the button with a mouse. Close a window, menu, or drawer. + + + +F7 + + + +Switch to caret navigation mode. Caret navigation +mode enables you to use the keyboard to select text. For more information +about caret navigation mode, see . + + @@ -157,7 +172,6 @@ can use from any part of the GNOME Desktop. and take a screenshot of the entire screen. You can customize this keyboard shortcut. -This shortcut only works on Solaris systems. @@ -1664,23 +1678,18 @@ pane and the view pane. -Navigating Web Browser, Email and Calendar, and Help Content - -keyboard shortcuts -for web browser -content - +Navigating Help Content in Caret Navigation Mode keyboard shortcuts -for email and calendar content +for Help content -keyboard shortcuts -for help content +caret navigation mode -To navigate HTML-based content, you need to -first press F7 to switch to caret navigation mode. The following table describes -how navigate HTML-based content. +The following table describes how to navigate HTML-based +help content in caret navigation mode in the Yelp +help browser. Caret navigation is a mode of operation in an application which +enables you to use the keyboard to select text. @@ -1703,7 +1712,7 @@ how navigate HTML-based content. -Switch to caret navigation mode. +Switch to caret navigation mode. @@ -1781,7 +1790,7 @@ how navigate HTML-based content. -Move to the beginning of the current line. +Move to the beginning of the current frame. @@ -1791,23 +1800,6 @@ how navigate HTML-based content. -Move to the end of the current line. - - - - -CtrlHome - - -Move to the beginning -of the current frame. - - - - -CtrlEnd - - Move to the end of the current frame. @@ -1843,26 +1835,6 @@ previous focusable control. -F6 - - - -Move to the next frame in the current document if -the document is using frames and to the location bar. - - - - -ShiftF6 - - -Move to the previous frame in the current -document if the document is using frames and to the location bar. - - - - - Enter @@ -1873,8 +1845,6 @@ document if the document is using frames and to the location bar. -For more information about how to navigate the Web Browser and Email and Calendar applications, -see the online Help for the applications. Navigating Standard Elements and Controls diff --git a/gnome2-accessibility-guide/C/preface.xml b/gnome2-accessibility-guide/C/preface.xml index d06325c..b395286 100644 --- a/gnome2-accessibility-guide/C/preface.xml +++ b/gnome2-accessibility-guide/C/preface.xml @@ -1,61 +1,16 @@ - -Preface -The GNOME 2.10 Desktop Accessibility -Guide describes -how to configure, customize, and use the accessibility features of -the GNOME 2.10 Desktop. - -Who Should Read This Guide -This guide is for users, system administrators, and anyone who is interested -in how the GNOME 2.10 Desktop satisfies Section 508 of the U.S. Rehabilitation Act. - - -How This Guide Is Organized -This guide is structured in the following manner: - - - introduces you to accessibility -in the GNOME Desktop. - - - describes how to configure the -mouse and keyboard to make these devices accessible to more users. - - - describes how to navigate the GNOME -Desktop from the keyboard only. - - - describes the methods you can use +PrefaceThe GNOME 2.10 Desktop Accessibility +Guide describes how to configure, customize, +and use the accessibility features of the GNOME 2.10 +Desktop. +Who Should Read This GuideThis guide is for users, system administrators, and anyone who is interested +in how the GNOME 2.10 Desktop supports people with disabilities and addresses the requirements +of Section 508 of the U.S. Rehabilitation Act.How This Guide Is OrganizedThis guide is structured in the following manner: introduces you to accessibility +in the GNOME Desktop. describes how to configure the +mouse and keyboard to make these devices accessible to more users. describes how to navigate the GNOME +Desktop from the keyboard. describes the methods you can use to change the appearance of the GNOME Desktop to enhance the accessibility of the desktop for users with -visual impairments. - - - introduces you to the assistive technologies -that are available in the GNOME Desktop. - - - describes some system administrator +visual impairments. introduces you to the assistive technologies +that are available from the GNOME Desktop. describes the system administrator tasks that you need to perform before you can use the assistive technologies -for the GNOME Desktop. - - - - -Related Documentation -The following manuals are related to this guide: - - - -GNOME 2.10 Desktop System Administration Guide - - - - -GNOME 2.10 Desktop User Guide - - - - - +for the GNOME Desktop.Related DocumentationThe following manuals are related to this guide:GNOME 2.10 Desktop System Administration GuideGNOME 2.10 Desktop User Guide diff --git a/gnome2-accessibility-guide/C/sysadmin.xml b/gnome2-accessibility-guide/C/sysadmin.xml index c6a507f..23eab2b 100644 --- a/gnome2-accessibility-guide/C/sysadmin.xml +++ b/gnome2-accessibility-guide/C/sysadmin.xml @@ -1,8 +1,10 @@ System Administration -This appendix contains some tips for the system administrator about -how to use the assistive technologies of the GNOME Desktop. +This appendix +describes some tasks that a system administrator needs to perform to enable +accessible login and to facilitate the use of the assistive technologies that +are available in the GNOME Desktop. Configuring the Desktop for Accessible Login @@ -16,9 +18,11 @@ Login feature. The Accessible Login feature enables users to: screen, mouse, or keyboard in the usual way. -Launch assistive technologies at login time by using special -gestures from the standard keyboard, or from a keyboard, pointing device, -or switch device that is attached to the USB or PS/2 mouse port. +Launch assistive technologies at login time by associating +a user action with an assistive technology application. The user can perform +the user action from the standard keyboard, or from a keyboard, pointing device, +or switch device that is attached to the USB or PS/2 mouse port. These user +actions are called gestures. Change the visual appearance of the login dialog before the @@ -31,12 +35,11 @@ user logs in, for example, to use a high contrast theme for better visibility. < GDM To enable the Accessible -Login feature for the GNOME Desktop, -you must configure the desktop to use the GNOME Display Manager (GDM) as the -login manager. Since GDM is the default login manager on Linux systems but -not on Solaris systems, the instructions to enable Accessible Login differ -depending on the platform you are using. See the following sections for more -information. +Login feature for the GNOME +Desktop, you must configure the desktop to use the GNOME Display Manager +(GDM) as the login manager. GDM is the default login manager on Linux systems +but not on Solaris systems, therefore the instructions to enable Accessible +Login differ depending on the platform you are using. To Enable and Configure GDM on Solaris Systems To enable and configure GDM as the login manager on Solaris systems, @@ -46,7 +49,7 @@ perform the following steps: Log in as the root user. -Edit the file /etc/X11/gdm/gdm.conf. +Open the file /etc/X11/gdm/gdm.conf. Search the file for the following line: @@ -79,11 +82,11 @@ Reader and Magnifier. You can edit the line above further to load only the GtkModules that you require to support the user base. For example: -If you need to use the Screen Reader and Magnifier, include gail and atk-bridge. +If you need to use the Screen Reader and Magnifier, include gail and atk-bridge. If you need to use a pointing device without buttons or switches, -also include dwellmouselistener. +include gail, atk-bridge, anddwellmouselistener. If you use pointing devices with switches, alternative physical @@ -147,7 +150,7 @@ and assign ownership of the directory to the gdm user. Log in as the root user. -Edit the file /etc/X11/gdm/gdm.conf. +Open the file /etc/X11/gdm/gdm.conf. Search the file for the following line: @@ -184,7 +187,7 @@ load only the GtkModules that you require to support the user base. For example: If you need to use a pointing device without buttons or switches, -also include dwellmouselistener. +include gail, atk-bridge, and dwellmouselistener. If you use pointing devices with switches, alternative physical @@ -262,9 +265,19 @@ line enables you to press-and-hold CtrlSScreen Reader and Magnifier in speech and Braille mode: +Solaris: + + <Control>s 1 1000 10000 /usr/sfw/bin/srcore --login --disable-magnifier --enable-speech --enable-braille + +Linux: + + +<Control>s 1 1000 10000 srcore --login --disable-magnifier +--enable-speech --enable-braille + To Start Magnifier Using a Keyboard Shortcut @@ -274,8 +287,18 @@ line enables you to press-and-hold CtrlMScreen Reader and Magnifier in magnifier mode: +Solaris: + + <Control>m 1 1000 10000 /usr/sfw/bin/srcore --login --enable-magnifier ---magnification-horizontal-split --disable-speech +--disable-speech + + +Linux: + + +<Control>m 1 1000 10000 srcore --login --enable-magnifier +--disable-speech @@ -284,23 +307,43 @@ in magnifier mode: switch, key, or button gestures with assistive technologies. Since the primary input device for many On-Screen Keyboard users is a switch or button, this is a good way to enable users to start On-Screen Keyboard at login time. -To reduce the likelihood of starting an application unintentionally, +If there is a tendency for a user to start an application unintentionally, you can associate the gestures with multiple switch presses or minimum durations. For example, the following line starts On-Screen Keyboard in inverse scanning mode when the user presses the switch that is defined as Switch 2 three times within two seconds, for a minimum of 100 milliseconds for each press: +Solaris: + + <Switch2>3 100 2000 /usr/sfw/bin/gok --login --accessmethod=inversescanning --scan-action=switch1 --select-action=switch2 + +Linux: + + +<Switch2>3 100 2000 gok --login --accessmethod=inversescanning +--scan-action=switch1 --select-action=switch2 + Users who use single switches may prefer to start On-Screen Keyboard in automatic scanning mode. The following line starts On-Screen Keyboard in automatic scanning mode when the user presses the switch on an alternative access device for more than four seconds: +Solaris: + + <Switch>1 4000 5000 /usr/sfw/bin/gok --login --accessmethod=automaticscanning --scan-action=switch1 --select-action=switch1 + +Linux: + + +<Switch>1 4000 5000 gok --login --accessmethod=automaticscanning +--scan-action=switch1 --select-action=switch1 + For information about the On-Screen Keyboard operating modes, see the online Help for On-Screen Keyboard. @@ -320,11 +363,22 @@ the top edge, out of the dialog through the left edge, back into the dialog through the left edge, and similarly through the bottom and right edges of the dialog in a cross pattern: +Solaris: + + TTLLBBRR O 10000 /usr/sfw/bin/gok --login --access-method=dwellselection --input-device=MOUSE[3] + +Linux: + + +TTLLBBRR O 10000 gok --login --access-method=dwellselection +--input-device=MOUSE[3] + Note that the --input-device parameter specified -in the gesture must match the name of the user input device as specified in /etc/X11/XF86Config. +in the gesture must match the name of the extended user input device, such +as a head pointer or trackball, as specified in /etc/X11/XF86Config. @@ -339,7 +393,10 @@ including USB single switches and mouse-like pointing devices. You should not configure an alternative input device to control the primary onscreen pointer. This might result in undesirable behavior or cause situations from which the user of the alternate input device cannot -recover without using the primary keyboard or mouse. +recover without using the primary keyboard or mouse. To prevent this problem, +please remove any occurrences of the attributes SendCore +or AlwaysCore from any of InputDevice +lines in the X Server configuration file. @@ -348,15 +405,15 @@ recover without using the primary keyboard or mouse. Java environment, configuring -To configure the Java Environment for accessibility, perform the following -steps: +To configure the Java environment on Solaris systems for accessibility, perform +the following steps: Log in as the root user to the base directory of the Java SDK installation. -Enter the following command to change to the jre/lib directory: +Enter the following command: cd jre/lib @@ -368,31 +425,117 @@ of the Java SDK installation. -Enter the following command to change to the ext directory: +Enter the following command: cd ext -Execute the following command: +Enter the following command: ln -s /usr/share/jar/gnome-java-bridge.jar + +Enabling XKB on Solaris Systems + +XKB + +If you are using the desktop +for the Solaris operating system on a SPARC platform, you must enable XKB +on your system before you can use the AccessX preference +tool, Screen Reader and Magnifier, or On-Screen Keyboard. + +XKB is not currently supported on Sun Ray systems. + +To enable XKB on a non-Sun Ray Solaris system, perform the following +steps: + + +Log in as the root user. + + +Check if the path and file /etc/dt/config/Xservers exists on your system. + + +If the /etc/dt/config directory does +not exist, enter the following command: + +mkdir -p /etc/dt/config + + + +If the Xservers file is not present, +enter the following command: + +cp /usr/dt/config/Xservers /etc/dt/config/Xservers + + + +Open the Xservers file in a text editor +and scroll to the end of the file. + + +Append the following to the command line at the end of the +file: + ++kb + + + +Save and close the Xservers file. + + +Enter the following command at a command line: + +pkill -HUP dtlogin + + + +Open the /etc/X11/gdm/gdm.conf file in +a text editor. + + +Scroll towards the end of the file until you see the line [server - standard]. + + +Edit the command line in this section to +append the following to the end of the line: + ++accessx +kb + + + +Save and close the gdm.conf file. + + +Log out of your session and log in again. + + +To verify if XKB is running, execute the following command: + +xdpyinfo + +then search for XKEYBOARD in the extensions list. + + + Enabling Full Screen Magnification -The following sections describe two ways to enable full screen magnification. Screen Reader and Magnifier enabling full screen magnification +The following sections +describe the methods to enable full screen magnification. -To Enable Full Screen Magnification Using Two Framebuffers +To Enable Full Screen Magnification Using Two Video Cards To enable full screen magnification in Screen Reader and -Magnifier using two framebuffers, perform the following steps: +Magnifier using two physical video cards, perform the following +steps: Configure two video cards as :0.0 and :0.1. @@ -404,40 +547,41 @@ magnification factor. -Choose ApplicationsAccessibilityScreen Reader and Magnifier to start Gnopernicus. +Choose ApplicationsAccessibilityScreen Reader and Magnifier. -Click on Preferences. +Click on Preferences in the Gnopernicus menu window. -Click on Magnifier. +Click on Magnifier to open the Magnifier Preferences dialog. -Click on Add/Modify. +Click on the Add/Modify button to display +the Zoomer Options dialog. -Specify :0.0 as the Source for magnification. +In the Display Screen section, type :0.0 in the Source text box. -Specify :0.1 as the Target for magnification. +In the Display Screen section, type :0.1 in the Target text box. -Set the Zoomer Placement to be [0,0,1023,767]. +Set the Zoomer Placement values to be [0,0,1023,767]. These instructions assume a video resolution of 1024x768. -Restart Screen Reader and Magnifier. -The magnified view is displayed on the second display 0.1. +Click Apply and Close +to close the Zoomer Options dialog. +The magnified view is displayed on the second display 0.1. -To Enable Full Screen Magnification on Linux Systems Using a Dummy -Driver -To enable full screen magnification on Linux systems by configuring -a dummy driver, perform the following steps: +To Enable Full Screen Magnification Using One Video Card on Linux Systems +To enable full screen magnification on Linux systems using one physical +video card and one virtual video card, perform the following steps: Open the file /etc/X11/XF86Config. @@ -518,50 +662,125 @@ the Zoomer Options dialog. In the Display Screen section, type :0.1 in the Source text box. +In the Zoomer Placement section, set +the value of the Left spin box to 0. + + Click Apply. +The Screen Reader and Magnifier user interface +is no longer visible. -In the Zoomer Placement section, set -the value of the Left spin box to 0. +Log out of your session. + + +Log in to a new session. + + +Enter the following command to start Screen Reader +and Magnifier in full screen magnification mode: + +gnopernicus -display :0.1 + + + +When you log out of your session, select the Save +current setup option. + + + + + +Enabling Braille + +Braille, enabling + +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. The following +sections describe the steps that you need to perform depending on your operating +system. + +To Enable Braille on Solaris Systems +To configure the serial port to which the Braille device is connected +on Solaris systems, perform the following steps: + + +Log in as the root user. + + +Enter the following command: + +chmod 777 /dev/cua/a + + + +Enter the following command: + +chmod 777 /dev/cua/b + + + +Change the permissions to 777 on the devices +to which the symbolic links /dev/cua/a and /dev/cua/b point. + + +If your system uses /dev/cua/a for system log +messages, Braille will not work on that serial port. Use /dev/cua/b instead. + + + +To Enable Braille on Linux Systems +To configure the serial port to which the Braille device is connected +on Linux systems, perform the following steps: + -Click Close to close the Zoomer Options dialog. +Log in as the root user. -Click Close to close the Magnifier Preferences dialog. +Enter the following command: + +chmod 777 /dev/ttyS0 + + + +Enter the following command: + +chmod 777 /dev/ttyS1 + -Configuring Multiple Pointer Devices +Configuring Alternative Pointer Devices The following sections describe how to configure your system to use a standard physical mouse and another pointer device such as a single switch device or head tracker device, and how to configure On-Screen Keyboard to use the second pointer device. -To Configure Two Pointer Devices on Solaris Systems +To Configure Alternative Pointer Devices on Solaris Systems configuring two pointer devices on Solaris systems -Screen Reader and -MagnifierTo configure two pointer devices on a Solaris system, -perform the following steps: +To configure an alternative pointer +device on a Solaris system, perform the following steps: -This procedure does not work for all Solaris platforms. +This procedure does not work on all Solaris platforms. -Before you connect the auxiliary pointer device to your system, -enter the following command to list the existing devices: +Before you connect the alternative pointer device to your +system, enter the following command to list the existing devices: ls -l /dev/usb/hid* -Connect the auxiliary device to your system. +Connect the alternative pointer device to your system. Enter the following command again to list the new device: @@ -614,24 +833,24 @@ file. -To Configure Two Pointer Devices on Linux Systems +To Configure Alternative Pointer Devices on Linux Systems configuring two pointer devices on Linux systems -To configure two pointer devices -on a Linux system, perform the following steps: +To configure an alternative pointer +device on a Linux system, perform the following steps: -Before you connect the auxiliary pointer device to your system, -enter the following command to list the existing devices: +Before you connect the alternative pointer device to your +system, enter the following command to list the existing devices: ls -l /dev/usb/hid* -Connect the auxiliary device to your system. +Connect the alternative pointer device to your system. Enter the following command again to list the new device: @@ -646,7 +865,7 @@ enter the following command to list the existing devices: Edit the InputDevice section where the Driver value is set to mouse as follows: -Change the Option Device line as follows: +Change the Option Device line to the following: Option "Device" "/dev/input/mouse0" @@ -685,7 +904,7 @@ and other pointer device, you do not need to carry out this step. Change the InputDevice "Mouse[1]" line -as follows: +to the following: InputDevice "Mouse[1]" "CorePointer" @@ -702,9 +921,10 @@ as follows: -If you are not using USB connections for your primary mouse device -and other pointer device, ensure that only the device that you are using as -the primary mouse device has the "CorePointer" attribute. +Ensure that only the device that you are using as the primary +mouse device has the "CorePointer" attribute and ensure +that the alternate input devices do not have the SendCore +or AlwaysCore attributes. @@ -716,17 +936,17 @@ the primary mouse device has the "CorePointer" attr -To Configure On-Screen Keyboard to Use the Second Pointer Device +To Configure On-Screen Keyboard to Use an Alternative Pointer Device On-Screen Keyboard configuring for two pointer devices -To configure the On-Screen Keyboard application to use a second pointer device, -perform the following steps. +To configure the On-Screen Keyboard application to use an alternative pointer +device, perform the following steps. -Start the On-Screen Reader application. +Start the On-Screen Keyboard application. Click on GOK in the GOK - main window. diff --git a/gnome2-accessibility-guide/C/themes.xml b/gnome2-accessibility-guide/C/themes.xml index 4be5c16..4c25644 100644 --- a/gnome2-accessibility-guide/C/themes.xml +++ b/gnome2-accessibility-guide/C/themes.xml @@ -146,12 +146,18 @@ the appearance of icons on panels and on the desktop background. themes desktop -To open the Theme preference tool and view -the themes that are available, choose ApplicationsDesktop PreferencesTheme. The Theme Preferences dialog is displayed. -The themes are listed on the left side of the Theme Preferences dialog. To choose a new theme, click on a theme in the list box. -The system automatically applies the theme to the desktop. There are several -themes available that suit different accessibility needs. These themes are -described in the following table: +To choose a theme, perform the following steps: + + +Choose ApplicationsDesktop PreferencesTheme. The themes +are listed on the left side of the Theme Preferences +dialog. + + +Click on a theme in the list box to choose a new theme. The +system automatically applies the theme to the desktop. +There are several themes available that suit different accessibility +needs, as described in the following table: Themes Designed for Accessibility Requirements @@ -197,13 +203,17 @@ light text on a dark background using high contrast colors. -Increases the font size to 18pt. -The background and foreground colors are the same as those specified by the Default desktop theme. +This theme suggests an increased +font size of 18pt. The background and foreground colors are the same as those +specified by the Default desktop theme. To apply the +suggested font, click on the Apply Font button.
+ + To view the controls, window frame, and icon settings that are associated with a theme, select a theme in the Theme Preferences dialog, then click on the Theme Details button. The Theme Details dialog contains a tabbed section for each setting @@ -290,8 +300,9 @@ the background and foreground text. -Increases the font size to 18pt. -The background and foreground colors are the same as those specified by the Default desktop theme. +Increases the size of controls +to accommodate larger fonts. To increase the font size, you must use the Font preference tool. The background and foreground colors are +the same as those specified by the Default desktop theme. @@ -302,7 +313,9 @@ The background and foreground colors are the same as those specified by the Provides dark text on a light background using high -contrast colors and increases the font size to 18pt. +contrast colors. Increases the size of controls to accommodate larger fonts. +To increase the font size, you must use the Font +preference tool. @@ -313,7 +326,9 @@ contrast colors and increases the font size to 18pt. Provides light text on a dark background using high -contrast colors and increases the font size to 18pt. +contrast colors. Increases the size of controls to accommodate larger fonts. +To increase the font size, you must use the Font +preference tool. @@ -324,8 +339,9 @@ contrast colors and increases the font size to 18pt. Uses -low contrast colors for the background and foreground text and increases the -font size to 18pt. +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 Font preference tool. @@ -443,8 +459,9 @@ the background and foreground text. -Increases the font size to 18pt. -The background and foreground colors are the same as those specified by the Default desktop theme. +The background and foreground +colors are the same as those specified by the Default +desktop theme. To increase the font size, you must use the Font preference tool. @@ -455,7 +472,7 @@ The background and foreground colors are the same as those specified by the Provides dark text on a light background using high -contrast colors and increases the font size to 18pt. +contrast colors. To increase the font size, you must use the Font preference tool. @@ -466,7 +483,7 @@ contrast colors and increases the font size to 18pt. Provides light text on a dark background using high -contrast colors and increases the font size to 18pt. +contrast colors. To increase the font size, you must use the Font preference tool. @@ -477,8 +494,8 @@ contrast colors and increases the font size to 18pt. Uses -low contrast colors for the background and foreground text and increases the -font size to 18pt. +low contrast colors for the background and foreground text. To increase the +font size, you must use the Font preference tool. -- cgit