
				README

Welcome to this preliminary release of Java Accessibility!  This
release includes the Java Accessibility libraries, some examples, and
documentation of the Java Accessibility design and API.

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 has two sections:

- WHAT'S IN THIS RELEASE
- QUICK START


    NOTE:  To run the examples in this release of Java Accessibility, 
    you need to obtain AND INSTALL both the JDK 1.1.2 or better and 
    the JFC Early Access Release. 

    To obtain the JDK 1.1.2 or better, connect to the following URL:

        http://java.sun.com/products/jdk/1.1/index.html

    To obtain the JFC Early Access Release (also known as swing-0.5), 
    go to the Java Developer Connection at the following URL:

        http://developer.javasoft.com/developer/index.html

    Once you log in (it's free), choose the JFC Early Access link to 
    go to the download page. For more information on JFC, please refer
    to the following URL:

        http://java.sun.com/products/jfc/index.html



WHAT'S IN THIS RELEASE:

This release contains the following:

jaccess-0.5/README.txt			This file.
jaccess-0.5/LICENSE.txt			Software license.
jaccess-0.5/CHANGES.txt			Changes since the last release.
jaccess-0.5/NOTES.txt			Notes for reviewers (you).
jaccess-0.5/jaccess.jar    		The Java Accessibility classes.
					DO NOT UNARCHIVE THIS FILE!
jaccess-0.5/doc/index.html		The main page for documentation.
jaccess-0.5/src.zip			The source code for this release.
jaccess-0.5/examples			Example uses of Java Accessibility.


QUICK START:

This section contains quick start directions on setting up the 
Java Accessibility package, once you have downloaded and installed 
jaccess-0.5 onto your system.

Please read the License (LICENSE.txt) before using this release.

To read the Java Accessibility documentation, view the following file
from the installed jaccess-0.5 package in a Web browser:

	jaccess-0.5/doc/index.html

To run a sample application, named Java Monitor, that provides small 
sample set of Java Accessibility features, do the following:

1. Add the Java Accessibility jar file and the Java Monitor class
   to your CLASSPATH environment variable.  For example, on Solaris:

	setenv CLASSPATH $CLASSPATH:/home/me/jaccess-0.5/jaccess.jar:/home/me/jaccess-0.5/examples/JavaMonitor

   Or, on Win95:

	set CLASSPATH=%CLASSPATH%;C:\jaccess-0.5\jaccess.jar;\jaccess-0.5\examples\JavaMonitor

2. Modify the lib/awt.properties file under your JDKHOME directory (e.g., 
   /home/me/jdk1.1.2/lib/awt.properties) to include the following lines:

        AWT.EventQueueClass=com.sun.java.accessibility.EventQueueMonitor
        AWT.AutoLoadClasses=JavaMonitor

   The file, jaccess-0.5/doc/awt.properties.sample, provides an example 
   of what the final edited version might look like.  

3. Run any Java application using the 'java' command provided with
   JDK 1.1.2.  For example, run the SwingSet example that shipped with 
   the preliminary release of Swing (swing-0.5).  When you run the java 
   application, the Java Monitor will automatically start.  For more
   information on the Java Monitor, view the following file from
   the installed jaccess-0.5 package in a Web browser:

       jaccess-0.5/doc/examples.html




Have fun trying out Java Accessibility!  We look forward to the
feedback you will be sending to access@sun.com.  For more general 
information on Java Accessibility, please refer to the following 
URL:

	http://www.sun.com/tech/access/index.html

--The Java Accessibility Team
