Alex Prengel                                alexp@mit.edu 8/11/97

SEE ADDENDUM AT BOTTOM FOR MORE RECENT INFORMATION

The java locker has recently been reconfigured to allow for a new Java
locker containing the 1.1.3 JDK (which is now the default), and to bring the
locker within the format currently used in most Athena Third Party software
lockers maintained by the Academic Computing Support Team. This format
allows for multiple software releases to co-exist and gives users several
options for selecting the one they prefer.

What has been done is this:
 
1. The former java locker is now the java_v1.0.2 locker. All paths in
startup scripts in the former java locker were changed by changing
"java" in a path component to "java_v1.0.2". Otherwise the new
java_v1.0.2 locker is identical to the former java locker, and can
be used directly by doing "add java_v1.0.2" instead of "add java" as
before.
 
2. There is a new java_v1.1.3 locker, with JDK 1.1.3 versions of the JDK
utilities. It can be used directly by doing "add java_v1.1.3".
 
3. The java locker now has a Perl startup script that attaches the
appropriate version locker (java_v1.0.2 or java_v1.1.3) and runs the
appropriate binary, with the default version being 1.1.3 with an
optional command-line argument in the first position which allows the
user to specify a desired version. i.e:
 
add java; javac myfile.java
 
compiles myfile.java using the 1.1.3 javac- an optional "-ver" switch 
allows selection of the 1.0.2 JDK javac:
 
add java; javac -ver 1.0.2 myfile.java
 
the other JDK binaries work in the same way. 

If you only want the 1.0.2 versions, you can attach the version locker
directly as in 1. above, i.e. "add java_v1.0.2; javac myfile.java"
does the same as "add java; javac -ver 1.0.2 myfile.java".

In summary- if you have scripts or makefiles that attach the Java
locker and run various binaries within it, they will now be using the
tools from the 1.1.3 JDK (located on the java_v1.1.3 locker).

If you want your scripts or makefiles to keep using the 1.0.2 JDK tools,
you can do this by adding or attaching the java_v1.0.2 locker instead of the
java locker, and changing any path components containing "java" to 
"java_v1.0.2", or else by keeping the locker the same (java) but adding
a command line parameter "-ver 1.0.2" in each invocation of a JDK binary. 

If anything doesn't seem to work properly after you have allowed for these
changes please send mail to 3partysw@mit.edu with a detailed description
of what is wrong. We apologize for any inconvenience.

ADDENDUM 8/17/98

Releases 1.1.5 and 1.1.6 have subsequently been installed. 1.1.6 is now
the default for all platforms. Comments above about 1.1.3 now apply
to 1.1.3, 1.1.5 and 1.1.6, with 1.1.6 the current default.

Sun note- as of Athena 8.2, there is a built-in JDK distribution (1.1.3) 
that will be found earlier in your path if you access the java lockers
bu doing "add java"; if you want the java locker versions with releases
newer than 1.1.3, you will need to do "add -f java" instead.

ADDENDUM 12/8/98

Release 1.2ref for Sun/Solaris has been added for Sun/Solaris. It comes with
extensive html documentation which has been installed in the java_v1.2rel 
locker along with the software.

ADDENDUM 9/1/99

Release 1.2.2 (production) for Sun and 1.2.1 (prerelease) for Linux and SGI
have been installed and made the defaults.