                                             Readme
                                 The Java Runtime Environment,
[COMPAQ]                        Standard Edition (JRE), V1.1.8-10
                                    for Compaq Tru64 UNIX

  ------------------------------------------------------------------------

Contents

   * Introduction
   * Installation
   * Using the Java 1.1 Runtime Environment
   * Redistribution of the JRE
   * Bundling the Java 1.1 Runtime Environment

Introduction

Thank you for downloading the Java Runtime Environment, Standard Edition
(also known as the Java Runtime or JRE) V1.1.8-10 for Compaq Tru64 UNIX
(formerly DIGITAL UNIX). The JRE is the minimum standard Java Platform for
running Java programs. It contains the Virtual Machine for Java, Java core
classes, and supporting files. The JRE does not contain any of the
development tools (such as appletviewer or javac) or classes that pertain
only to a development environment.

This Readme provides installation instructions for the JRE and information
that may be useful for developers who want to redistribute the JRE with
their software.

IMPORTANT: Please make sure you understand the Copyright (copyright.txt,
installed file) and License (license.txt, installed file) information
before using this release.

Installation

Presently, this JRE V1.1.8-10 release does not require any operating system
patches. However, the need for patches may be discovered after this release
becomes available. Therefore, we recommend that you check our patch
installation page for Compaq Tru64 UNIX (formerly DIGITAL UNIX) for the
latest information.

The following steps must be done as superuser. Untar the binary kit in a
scratch directory, then use the setld command to load from that directory.
This example uses /tmp/java as the scratch directory, and assumes the tar
file is in /tmp:

   cd /tmp/java
   tar xf /tmp/javajre118-10.tar
   setld -l /tmp/java

There are two subsets in this kit:

   * JAVJRE118 -- The mandatory subset, which provides support for running
     Java programs

   * JAVJREOPT118 -- The optional components, mostly font files for
     internationalization support

     Installation of the JAVJRE118 subset creates /usr/opt/jre118 and
     installs the Java Runtime Environment in /usr/opt/jre118/bin and
     /usr/opt/jre118/lib. You can see the files installed by the mandatory
     subset by means of the following command:

     setld -i JAVJRE118

   * The optional JAVJREOPT118 subset installs the following files in
     /usr/opt/jre118/lib:


                       JAVJREOPT118 Installed Files

                  File                          Contents

      il8n.jar                       I18N character conversion
                                     classes from sun.io

      font.properties.cs             AWT font properties for Czech
                                     locale

      font.properties.el             AWT font properties for Greek
                                     locale

      font.properties.hu             AWT font properties for
                                     Hungarian locale

      font.properties.ja             AWT font properties for
                                     Japanese locale

      font.properties.ko             AWT font properties for Korean
                                     locale

      font.properties.lt             AWT font properties for
                                     Lithuanian locale

      font.properties.lv             AWT font properties for Latvian
                                     locale

      font.properties.pl             AWT font properties for Polish
                                     locale

      font.properties.ru             AWT font properties for Russian
                                     locale

      font.properties.tr             AWT font properties for Turkish
                                     locale

      font.properties.zh_EUC_CN      AWT font properties for
                                     Simplified Chinese

      font.properties.zh_HK_Big5     AWT font properties for
                                     Traditional Chinese

      font.properties.zh_HK_EUC_TW   AWT font properties for
                                     Traditional Chinese

      font.properties.zh_TW_Big5     AWT font properties for
                                     Traditional Chinese

      font.properties.zh_TW_EUC_TW   AWT font properties for
                                     Traditional Chinese

      psfont.properties.ja           AWT font properties for
                                     Japanese Postscript

Using the Java 1.1 Runtime Environment

The JRE can be invoked by the command-line tool jre, the Java Runtime
command, which is included in both the JRE download and the JDK download.

In many respects, the jre tool is similar to the JDK's java tool. The -cp
option of the jre tool is recommended for explicitly specifying an
application's class path.

Documentation for the Java Runtime Command.

Redistribution of the JRE

If you redistribute the JRE, you must follow the terms of the JRE Binary
Code License agreement, which includes these terms:

   * Do not arbitrarily subset the JRE. You may omit only the files in the
     JAVJREOPT118 optional subset.

   * Include in your product's license the provisions called out in the JRE
     Binary Code License.

Bundling the Java 1.1 Runtime Environment

This release of the JRE for Compaq Tru64 UNIX (formerly DIGITAL UNIX) is
packaged as two setld subsets, which makes it suitable for downloading by
end users. Java application developers have the option of not bundling the
JRE with their software. Instead, they can direct end users to download and
install the JRE themselves.

When bundling the JRE with application software on Tru64 UNIX, the
following points should be considered:

  1. It is suggested that you include the Java Runtime Environment files
     under a common directory (<runtime-dir>). Include all the required
     files from /usr/opt/jre118/bin and /usr/opt/jre118/lib in the bin and
     lib subdirectories of <runtime-dir>, following the same directory
     hierarchy and relative placement of files. The internationalization
     files installed by the optional subset can be included for language
     localization support.

  2. It is suggested that all application-specific classes be placed in a
     directory other than <runtime-dir>. Application-specific classes can
     be individual .class files, .jar files, or .zip files.

  3. If native code support is required, then the native library must be
     located in LD_LIBRARY_PATH. The best way to do this is to install the
     native libraries in <app-dir>/lib/<sys>. LD_LIBRARY_PATH should then
     be set to include these directories.

  4. The application can be invoked by using the jre command-line tool with
     the -cp option to specify the application's class path. In the
     standard installation, for example, the command might look like this:

        /usr/opt/jre118/bin/jre -cp <app-dir>/lib/app.jar <classname>

See the example, which demonstrates how to create a simple Java application
that runs on, and is bundled with, the Java Runtime Environment. The
example shows how to make a simple, seamless transition from developing an
application with the Java 1.1 Development Kit (JDK), to deploying it with
the more lightweight JRE.

  ------------------------------------------------------------------------
Copyright 2000 Compaq Computer Corporation.
Compaq Registered in U.S. Patent and Trademark Office.
Java and all Java-based marks are trademarks or registered trademarks of
Sun Microsystems, Inc.
All other product names mentioned herein may be trademarks or registered
trademarks of their respective companies.
Compaq shall not be liable for technical or editorial errors or omissions
contained herein. The information in this document is subject to change
without notice.
