
NOTES ON EVALUATING JAVA ACCESSIBILITY

While you evaluate this release of Java Accessibility, please keep a 
few things in mind:

- Not everything works yet.
- Even if you can't use the API, we still want your feedback on it.
- The API *will* change (primarily because of your feedback).

One thing that we appear to have not made clear in past releases
is that this is EARLY ACCESS CODE we are releasing to you for 
review.  Please do not set your expectations too high because this
really is EARLY ACCESS CODE and IT CONTAINS BUGS.  You should not
be basing any shipping products on this code at this time because
we may make changes to the API before the final release.

This file aims to help you give us meaningful feedback and avoid
wasting your time on stuff that we already know is broken.  It has these
sections:

Please Don't Tell Us    
	Lists stuff that might or might not work properly, but that we 
	aren't currently seeking feedback on.
Known Problems
	Lists problems we are working on.
How to Give Feedback
	The e-mail address to use, and what to put in bug reports.

-------------
PLEASE DON'T TELL US
-------------
EXAMPLES
Because we're concentrating on improving the Java Accessibility API,
we don't have time to worry about getting the examples exactly right.
If something in the examples shows a problem with Java Accessibility,
however, we want to hear about it.

BAD LINKS IN THE HTML DOCUMENTATION
In future releases, we'll catch bad links with a link checker.

THINGS WE ALREADY KNOW ABOUT
Please read the KNOWN PROBLEMS section in this file for information
about bugs and problems we already know about.  Since we already know
about them, there's no need to remind us they are there.

-------------
KNOWN PROBLEMS
-------------
JAVA MONITOR UNDER NT
Sometimes when launching a Java application in NT that is being
monitored by Java Monitor, the JavaVM fails to come up.  Also,
sometimes when using JavaMonitor to monitor a complex app, monitoring
lots of classes of events and then rapidly manipulating the components
of that app (e.g.  the SwingSet demo app that is part of the Early
Access swing-0.5 package) will cause the JavaVM to freeze.

NOT ALL THE SWING COMPONENTS IMPLEMENT INTERFACE ACCESSIBLE  
We have begun a FIRST PASS at implementing interface Accessible
directly on about half of the Swing components.  This first pass is
just a start and does not reflect what will be in the final release.
For those components we have implemented interface Accessible on,
however, we *do* want to hear about bugs in the implementation.

THERE ARE OCCASIONAL HANGS
Occasionally, running the sample accessibility tools will cause
the virtual machine to enter a deadlock.  For example, when running 
the ProgressBar demo in SwingSet with JavaMonitor, the VM will get 
into a deadlock.  We know what's causing the problem and we're 
working on fixing it.

NOT EVERYTHING WORKS
We're still working on this code.  This is an EARLY ACCESS RELEASE
intended to give you an early peek at what we're doing.  As a result,
NOT EVERYTHING WORKS.  Of course we want to hear about the things you
have found that don't work, but please remember this is an EARLY
ACCESS RELEASE so don't set your expectations for quality or
completeness too high.

--------------------
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.

- A backtrace, if appropriate.  This will tell us what the program 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. A bunch of text should be displayed in the window.  Please
     put a copy of it into your e-mail.
	
