The Blackdown Java(TM) 2 SDK, Standard Edition, v1.3.0 RC1 is
available in three installation formats.

* A bzipped tarball which can be used to install the Java2 SDK in a
  location chosen by the user
        - Change to the directory you want to install into, e.g /usr/local
                % cd /usr/local
        - Extract the contents of the Java 2 SDK
                % tar xvfI j2sdk-1.3.0-RC1-linux-<ARCH>.tar.bz2
          (Replace <ARCH> with the architecture of your system, e.g. 
          replace <ARCH> with i386 if your on an Intel system.)
        - Continue with the Java Plug-In instructions below
        - Add j2sdk1.3/bin to PATH, e.g. if you installed into /usr/local
                % export PATH=/usr/local/j2sdk1.3/bin:$PATH

* A .deb file containing packages comprising the Java 2 SDK
  Installation:
        - Choose one of our mirrors
        - Become root
                % su
        - Add the following line to /etc/apt/sources.list
          deb ftp://<mirror>/<path-to-java-directory>/Debian binary-$(ARCH)
        - The standard Debian package management tools
          (apt-get/dselect) should now be able to find and install
          Blackdown Java-Linux packages
        - The Debian packages automatically enable the Java Plug-In
          for Netscape/Mozilla if these have been installed from Debian
          packages.  If you want to enable the Java Plug-In for manually
          installed versions of Netscape/Mozilla please read the Java
          Plug-In instructions below

* A .rpm file containing packages comprising the Java 2 SDK.
  Installation:
        - Become root
                % su
        - Run the rpm command to install the packages
                % rpm -iv j2sdk1.3-RC1-linux.rpm
        - Continue with the Java Plug-In instructions below


Java Plug-In install instructions:
==================================

Please remove older plug-in versions before installing the 1.3 plug-in.
E.g. remove ~/.netscape/plugins/javaplugin.so and ~/.netscape/java/.

There are two ways to enable the plug-in: (Replace <ARCH> with the
architecture of your system, e.g. replace <ARCH> with i386 if your on
an Intel system.)

* [Recommended] Create a symbolic link from 
  <Java2 SDK installation>/jre/plugin/<ARCH>/javaplugin.so to one
  of the directories Netscape/Mozilla searches for plug-ins.
  E.g. 
        - Netscape
            % ln -s /usr/local/j2sdk1.3/jre/plugin/i386/javaplugin.so \
                    ~/.netscape/plugins/javaplugin.so
          or
            % su # become root
            % ln -s /usr/local/j2sdk1.3/jre/plugin/i386/javaplugin.so \
                    /usr/lib/plugins/javaplugin.so
        - Mozilla
          % ln -s /usr/local/j2sdk1.3/jre/plugin/i386/javaplugin.so \
                  /usr/local/mozilla-M17/bin/plugins/javaplugin.so

  Note: It has to be a symbolic link, copying javaplugin.so will NOT work

* Add <Java2 SDK installation>/jre/plugin/<ARCH> to NPX_PLUGIN_PATH.  Netscape
  (not Mozilla) will look through directories specified in this
  environment variable for plug-ins. 

Please note that the Mozilla plugin isn't complete and stable yet.  If
you experience problems with Mozilla and Java, remove the
javaplugin.so link from Mozilla's plug-in directory.
