Java Desktop System Release 3 Accessibility Release Notes

Chapter 3 Known Issues With Workarounds

This chapter describes workarounds for known accessibility issues in the Java Desktop System Release 3.

3.1 Application Crash Affects Accessibility Applications

Platform 

Solaris 

Problem  

If an application crashes, the application can continue to run but CORBA traffic to and from the application stops. This situation might prevent accessibility information from passing between other applications and the accessibility applications. 

Solution  

To resolve the situation, set the following environment variable value to 1: GNOME_DISABLE_CRASH_DIALOG 

3.2 Configuring a Switch Device on a Laptop System

Platform 

Linux 

Problem  

Change Request Number: 6285741 

The instructions to describe how to configure an alternative pointer device in the Java Desktop System Release 3 Accessibility Guide are incomplete for systems that already have two pointer devices configured, such as a laptop with a track pad and an external mouse.

Solution  

In addition to the instructions in the section entitled "Configuring Alternative Pointer Devices on Linux Systems" in the Java Desktop System Release 3 Accessibility Guide, you might need to perform the following steps:

  • Modify the first two InputDevice sections in /etc/X11/XF86Config.

  • Insert a third InputDevice section with the Identifier set to, for example, Mouse[5].

  • Edit the ServerLayout section to include the third InputDevice line. Ensure that this line does not have any associated SendCore or AlwaysCore attributes.

If you are using multiple USB pointer devices, please ensure that the Identifier sections refer to /dev/input/mouse0, /dev/input/mouse1, and so on, instead of /dev/input/mice. If you use /dev/input/mice, the system associates all USB input devices with the primary pointer device, which can cause conflicts when you are using USB devices with On-Screen Keyboard.

3.3 Configuring GDM

Platform 

Linux 

Problem  

Change Request Number: 6291788 

The Java Desktop System Release 3 Accessibility Guide contains an incorrect instruction in the section entitled "To Configure GDM on Linux Systems".

Solution  

In the section entitled "To Configure GDM on Linux Systems", step 4 should read as follows: 

Search the file for the following line: 

#GtkModulesList=gail:atk-bridge:/usr/lib/gtk-2.0 /modules/libdwellmouselistener:/usr/lib/gtk-2.0 /modules/libkeymouselistener

and delete the # from the start of the line so that the line reads: 

GtkModulesList=gail:atk-bridge:/usr/lib/gtk-2.0 /modules/libdwellmouselistener:/usr/lib/gtk-2.0 /modules/libkeymouselistener

3.4 Gestures for Starting Accessibility Applications Do Not Work

Platform 

Solaris 

Problem  

Change Request Number: 6214222 

The GNOME Display Manager (GDM) gestures for starting the assistive technologies such as On-Screen Keyboard and Screen Reader and Magnifier do not work.

Solution  

Use the full path to the applications in the GDM configuration files. 

Perform the following steps: 

  1. Edit the following two files:

    • /etc/X11/gdm/modules/AccessKeyMouseEvents

    • /etc/X11/gdm/modules/AccessDwellMouseEvents

  2. Replace all occurrences of gok with /usr/sfw/bin/gok.

  3. Replace all occurrences of srcore with /usr/sfw/bin/srcore.

  4. Save the files.

3.5 Magnifier and Keyboard Accessibility Features Do Not Work

Platform 

Solaris 

Problem  

Change Request Number: 6273030 

The magnifier and the keyboard accessibility features are not working. 

Solution  

Perform the following steps: 

  1. Open the /etc/X11/gdm/gdm.conf file in a text editor.

  2. Search the file for the following line:

    command=/usr/openwin/bin/Xsun ...

  3. Insert the following at the end of the above line:

    +xb -accessx

    -dev <framebuffer1> -dev <framebuffer2>, for example, -dev /dev/fbs/pfb1 -dev /dev/fbs/pfb0

3.6 Magnifier Crashes When Using a Second Framebuffer

Platform 

Solaris 

Problem  

Change Request Number: 6205225 

On a system with two framebuffers configured, full screen magnification does not work. 

Solution  

Please contact the Customer Resolution Center to obtain a patch for this issue. 

3.7 Magnifier Does Not Display Desktop Icons

Platform 

Solaris and Linux 

Problem  

Change Request Number: 6284593 

If the value of the /apps/nautilus/desktop/primary_screen GConf preference key is not set correctly, the user cannot see the desktop icons in the magnification area.

Solution  

Perform the following steps: 

  1. Click Launch, then choose Applications -> Utilities -> Configuration Editor

  2. In GConf, choose Apps -> Nautilus -> Desktop.

  3. Select the primary_screen key and set the value to the value of the magnified screen. For example, if the target screen for magnification is 1, set the value to 1.

Alternatively, you can enter the following command from a terminal window:  

gconftool-2 --type integer --set /apps/nautilus/desktop/primary_screen 1

3.8 Magnifier Does Not Display Java Applications Correctly

Platform 

Solaris 

Problem  

Change Request Number: 6202413 

Java applications are not displayed correctly in the magnifier. The entire Java window might initially be blank in the magnified area. 

Solution  

Set the following environment variable: NO_J2D_DGA=true

3.9 Magnifier Does Not Show Window Movement

Platform 

Solaris 

Problem  

Change Request Number: 6199904 

When you move windows, the movement is not visible in the Screen Reader and Magnifier magnification area.

Solution  

Disable wire frame mode in Window Manager. 

Perform the following steps: 

  1. Click Launch, then choose Applications -> Utilities -> Configuration Editor.

  2. In GConf editor, choose Apps -> Metacity -> General.

  3. Ensure that the reduced_resources key is not selected.

Alternatively, you can enter the following command from a terminal window:  

gconftool-2 -t bool -s /apps/metacity/general/reduced_resources false

3.10 On-Screen Keyboard Does Not Display Web Browser Submenus

Platform 

Solaris and Linux 

Problem  

Change Request Number: 5070427 

The On-Screen Keyboard application cannot display Web Browser submenus if the submenus were not previously displayed.

Solution  

Perform the following steps: 

  1. Activate Compose in the GOK — main window.

  2. Activate the keyboard shortcut for the menu that contains the submenus that you want to view.

    For example, activate Alt+B to display the Bookmarks menu. The Bookmarks submenus are now displayed in the On-Screen Keyboard.

3.11 Pointer Highlighting Feature Freezes the Desktop

Platform 

Solaris 

Problem  

Change Request Number: 6291127 

If you enable the Highlight the pointer when you press Ctrl option in the Mouse preference tool and you use the Ctrl key to copy and paste files, the desktop freezes.

Solution  

Perform the following steps: 

  1. Click Launch, then choose Preferences -> Desktop Preferences -> Mouse.

  2. Click on the Cursors tab in the Mouse Preferences dialog.

  3. Deselect the Highlight the pointer when you press Ctrl option.

3.12 Setting Dual-Head Magnification

Platform 

Solaris 

Problem  

Change Request Number: 5083128 

You have difficulty setting dual-head magnification.  

Solution  

To set either virtual or real dual-head magnification in the Screen Reader and Magnifier application, you must perform the following steps:

  1. Open the Zoomer Options dialog.

  2. Type the value you require in the Source field, then press Return.

  3. Type the value you require in the Target field, then press Return.


Note –

The changes to the Source and Target fields do not take effect until you press Return.


3.13 Screen Reader Does Not Read Hyperlinks

Platform 

Solaris and Linux 

Problem  

Change Request Number: 5085440 

When you use the Screen Reader and Magnifier application to read mail messages in the Email and Calendar application in caret navigation mode, the speech output is interrupted when there is a hyperlink in the message.

Solution  

Move the cursor into the hyperlink. On Linux systems, use flat review mode instead of caret navigation mode to navigate the message. 

3.14 Speech and Navigation Does Not Work

Platform 

Solaris and Linux 

Problem  

Change Request Number: 6216962 

You are unable to navigate or receive speech output for HTML containers such as web pages, email messages, or Help content. 

Solution  

Press F7 to enable caret navigation mode. Refer to the Java Desktop System Release 3 Accessibility Guide for more information about how to use the caret navigation mode. You can also refer to the online Help for the Web Browser or Email and Calendar applications.

3.15 StarOffice and Java Applications Are Not Accessible

Platform 

Solaris 

Problem  

Change Request Number: 4768049 

StarOffice and Java applications cannot detect an accessible Java runtime environment.

Solution  

Perform the following steps: 

  1. Follow the instructions in the section entitled “Configuring the Java Environment for Accessibility” in the Java Desktop System Release 3 Accessibility Guide.

  2. Enter the following command from a terminal window:

    /usr/staroffice7/program/jvmsetup

  3. Log in as the root user.

  4. Enter the following commands to create two symbolic links:

    ln -s /usr/share/jar/accessibility.properties /usr/java/j2redefault/lib/accessibility.properties

    ln -s /usr/share/jar/gnome-java-bridge.jar /usr/java/j2redefault/lib/ext/gnome-java-bridge.jar