README Welcome to this release of the Java (TM) Access Bridge for the Microsoft Windows operating system! This release includes the two Java Access Bridge DLLs, two example applications, and documentation of the Java Access Bridge API. NOTE: This release includes what is needed from the Java Accessibility Utilities, which are required in order to use the Java Access Bridge. If you are using JDK 1.1.x, you will also need to obtain the Java Foundation Classes version 1.1. You must use JDK 1.1.8 or later if you are using JDK 1.1.x. You must use Java 2 SDK 1.2.2 or SDK 1.3 if you are using the Java 2 platform. To obtain JDK 1.1.x, connect to the following URL: http://java.sun.com/products/jdk/1.1 To obtain the Java 2 SDK, connect to the following URL: http://java.sun.com/j2se/ To obtain the Java Foundation Classes, connect to the following URL: http://java.sun.com/products/jfc This file has three sections: - WHAT'S IN THIS RELEASE - WHAT MAY BE REDISTRIBUTED - QUICK START WHAT'S IN THIS RELEASE: ====================== This release contains the following: AccessBridge-1_0_2fcs\README.txt This file. AccessBridge-1_0_2fcs\binary-license.txt Software binary license. AccessBridge-1_0_2fcs\binary-license.html Software binary license in HTML. AccessBridge-1_0_2fcs\CHANGES.txt Changes since the last release. AccessBridge-1_0_2fcs\NOTES.txt Notes for reviewers (you). AccessBridge-1_0_2fcs\doc\index.html The main page for documentation. AccessBridge-1_0_2fcs\access-bridge.jar The Java language classfile for the AccessBridge DO NOT UNARCHIVE THIS FILE! AccessBridge-1_0_2fcs\JavaAccessBridge.dll The AccessBridge DLL invoked by the AccessBridge Java language classfile loaded into the Java Virtual Machine* AccessBridge-1_0_2fcs\WindowsAccessBridge.dll The AccessBridge DLL invoked by the AccessBridge Java language lassfile loaded into the Java VM AccessBridge-1_0_2fcs\src.zip Source to the examples NOTE: links from the docs. to various source files won't work until you unzip this file AccessBridge-1_0_2fcs\installer A directory containing a redistributable installer for the Java Access Bridge and the Java Accessibility Utilities, which are included in subdirectories. WHAT MAY BE REDISTRIBUTED: ========================= As per the license agreement for this release of the Java Access Bridge for the Microsoft Windows Operating System (see LICENSE.txt), the following six binary files may be redistributed in binary form: jaccess_1_3.jar - in AccessBridge-1_0_2fcs\installer\installerFiles\ jaccess_1_4.jar - in AccessBridge-1_0_2fcs\installer\installerFiles\ access-bridge.jar - in AccessBridge-1_0_2fcs\ JavaAccessBridge.dll - in AccessBridge-1_0_2fcs\ WindowsAccessBridge.dll - in AccessBridge-1_0_2fcs\ In addition, the following example properties file may be redistributed: accessibility.properties - in AccessBridge-1_0_2fcs\installer\installerFiles\ Finally, for purposes of making a custom installer or simply in order to localize the installer to different languages/locales, the source files listed below, contained in the AccessBridge-1_0_2fcs\src.zip file, which together create the Installer.exe and AccessBridgeTester.class files may be modified and custom binary installers may be built and redistributed from those files: AccessBridgeInstaller.cpp AccessBridgeInstaller.h AccessBridgeInstallerResource.h AccessBridgeInstallerResources.RC AccessBridgeTester.java QUICK START: =========== This section contains quick start directions on setting up the Java Access Bridge. The Java Access Bridge includes an Installer, in the AccessBridge-1_0_2fcs/installer directory. The fastest way to get up and running is imply to run that installer. Assuming you have unpacked the Java Access Bridge into the C:\AccessBridge-1_0_2fcs directory, you would simply run the command: C:\AccessBridge-1_0_2fcs\installer\Install This will scan your system for installed Java virtual machines, test them to see whether they support the Java Access Bridge, and then allow you to install the Java Access Bridge into each of those Java virtual machines. Alternately, you can modify each Java virtual machine by hand. Detailed instructions for how to perform those modifications can be found in C:\AccessBridge-1_0_2fcs\doc\setup.html To read the Java Access Bridge documentation, view the following file from the installed Java Access Bridge in a Web browser: C:\AccessBridge-1_0_2fcs\doc\index.html To run a sample application, named JavaFerret, that provides small sample set of the Java Access Bridge features, do the following: 1. Run the installer, C:\AccessBridge-1_0_2fcs\installer\Install 2. Run any Java application using the 'java' command provided with the JDK. For example, run the Simple example that ships with the Java Foundation Classes. When you run the Java application, the Java VM portion of the Java Access Bridge will automatically start. Then launch the JavaFerret application from the C:\AccessBridge-1_0_2fcs\examples directory. It will automatically start the Windows portion of the Java Access Bridge, the two "AccessBridge" DLLs will find each other, and JavaFerret will be attached to the Simple Java application. If you like you can launch these two applications in the reverse order. Have fun trying out the Java Access Bridge! 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 --The Java Accessibility Team Copyright (c) 2001 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Sun, Sun Microsystems, the Sun logo and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Federal Acquisitions: Commercial Software - Government Users Subject to Standard License Terms and Conditions. Copyright (c) 2001 Sun Microsystems, Inc. Tous droits reserves. Distribue par des licences qui en restreignent l'utilisation. Le logiciel detenu par des tiers, et qui comprend la technologie relative aux polices de caracteres, est protege par un copyright et licencie par des fournisseurs de Sun. Sun, Sun Microsystems, le logo Sun et Java sont des marques de fabrique ou des marques deposees de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays. *As used in this document, the terms "Java virtual machine" or "JVM" mean a virtual machine for the Java platform.