==============================================
Notes on evaluating the Java (TM) Access Bridge 
for the Microsoft Windows Operating System
==============================================

This file aims to help you give us meaningful feedback. It has these
sections:

Known Problems
        Lists problems we are working on.

Tips on usage
        Tips on how to best use the AccessBridge

How to Give Feedback
        The e-mail address to use, and what to put in bug reports.

--------------
KNOWN PROBLEMS
--------------

Registering, unregistering, then registering again for various of the
menus events will cause you to receive duplicate copies of the event.

You will not receive MenuCanceled (or PopupMenuCanceled) events.  To
determine that a menu has closed, look for MenuDeselected events.

GetAccessibleAt() may fail if you are querying for a coordinate other
than the mouse coordinate.  This bug in the Java Development Kit is 
fixed in Java 2 SDK 1.3.

If you are using a version of JAWS for Windows up to and including 
version 3.70.47 with Java2 SDK 1.3, you must not configure JFW to load 
as a service under Windows NT.  That combination will cause crashes.

Java Access Bridge v2.0 does not run with Java applications written 
with JDK 1.1.8.  To enable access to these applications, use the Java 
Access Bridge v1.0.2.

When updating from Java Access Bridge 2.0 beta 1 to beta 3, two files will 
not be updated due to their being installed in the wrong location with 
beta 1. The accessibility.properties may remain with the beta 1 date. This
is not an issue and the files will be installed with their correct locations
with beta 3. 

-------------
TIPS ON USAGE
-------------

To make the links to the source files in the documentation work, unzip 
the src.zip file.

Use State PropertyChange events to determine changes in menu item selection
(e.g. when the user arrows up/down within a menu).

Use ActiveDescendent PropertyChange events to determine changes in the
selected cell of a table.

Use the AccessibleValue support and Value PropertyChange events to track
the values of things like sliders, scroll bars, etc.

Use the AccessibleSelection support to determine which items are selected
in a List, Table, etc.  This is more efficient than enumerating all of the 
children and examining their StateSet to see if 'Selected' is among them.

--------------------
HOW TO GIVE FEEDBACK
--------------------

Please send your feedback to this e-mail address:

        access@sun.com

If you've found a bug, you can help us greatly by including the
following information in your e-mail:

- A program or code snippet that shows the problem.

- The platform you're using.

- The setting of your CLASSPATH environment variable (if you are using
  JDK 1.1)

- A JavaVM backtrace, if appropriate.  This will tell us what the portion
  of the Access Bridge that is running inside the JavaVM is doing when the
  bug occurs. To generate a backtrace, do this:
  
  1. Go to the shell window in which you entered the 'java' command.

  2. Make sure it has the keyboard focus and that the interpreter
     ('java' command) isn't a background process.

  3. Enter the appropriate character:

         Control-\              (Solaris)
         Control-Break          (Win 95/NT)

  4. Text will be displayed in the window.  Please put a copy of it into 
     your e-mail.


*As used in this document, the terms "Java virtual machine" or "JVM" mean 
a virtual machine for the Java platform.