README

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

NOTE:  These utilities will not work with the JDK1.2 Beta Releases.
       We are working on updating them so they will at some time in
       the future.

This file has two sections:

- WHAT'S IN THIS RELEASE
- QUICK START


    NOTE:  To run the examples in this release of Java Accessibility
    Utilities, you need to obtain AND INSTALL both the JDK 1.1.5 or 
    better and the 1.1 release of the Java(TM) Foundation Classes.

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

        http://www.javasoft.com/products/jdk/1.1/index.html

    To obtain the 1.1 release of the Java Foundation Classes, connect
    to the following URL:

        http://www.javasoft.com/products/jfc/index.html



WHAT'S IN THIS RELEASE:

This release contains the following:

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


QUICK START:

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

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

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

	jaccess-1.0/doc/index.html

To run a sample application, named JavaMonitor, 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-1.0/jaccess.jar:/home/me/jaccess-1.0/examples/JavaMonitor;/home/me/jaccess-1.0/examples/AccessibilityPanels

   Or, on Win95:

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

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

        AWT.EventQueueClass=com.sun.java.accessibility.util.EventQueueMonitor
        AWT.assistive_technologies=JavaMonitor

   The file, jaccess-1.0/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
   the JDK.  For example, run the SwingSet example that ships with the
   Java Foundation Classes.  When you run the Java application, 
   the JavaMonitor will automatically start.  For more information on the 
   JavaMonitor, view the following file from the installed jaccess-1.0 
   package in a Web browser:

       jaccess-1.0/doc/examples.html

Have fun trying out the Java Accessibility Utilities!  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/access/index.html

--The Java Accessibility Team