                                   README

                            Blackdown Java-Linux

                      Java(TM) 2 SDK, Standard Edition
                             Version 1.3.1  FCS
                      (Based on Sun's Version 1.3.1-FCS)

     For a more extensive HTML version of this file, see README.html.

Contents

   * Introduction
   * System Requirements 
   * Installation
   * Release Notes
   * Bug Reports and Feedback
   * Java 2 SDK Documentation
   * Blackdown Java-Linux Web Pages
   * Sun Java Web Pages


Introduction

     Thank you for downloading this release of the Java(TM) 2 SDK,
     Standard Edition. The Java 2 SDK is a development environment for
     building applications, applets, and components that can be
     deployed on the Java platform.

     The Java 2 SDK software includes tools useful for developing and
     testing programs written in the Java programming language and
     running on the Java platform. These tools are designed to be used
     from the command line. Except for appletviewer, these tools do not
     provide a graphical user interface.

     The release comes with the Java Plug-in product as part of the 
     Java 2 Runtime Environment. You can use the Java Plug-in product 
     to enable browsers to run applets based on the Java 2 Platform. 
     For more information about the Java Plug-in product, see the 
     section titled "Java 2 Runtime Environment and Java Plug-in" in 
     the README.html file.

     This release includes both the HotSpot Server and Client VMs.
     The HotSpot Client VM is used by default.
     The Java2 SDK also contains the native threads and green threads
     Classic VMs.  Unlike in Java2 v1.2.2 the JIT compiler for the classic
     VM is not enabled by default, you have to set JAVA_COMPILER=sunwjit or
     use -Djava.compiler=sunwjit if you want to use the bundled JIT
     compiler with the classic VM.

System Requirements

     This version of the Java 2 SDK is supported on Linux systems
     running the Linux kernel v 2.2.16 or newer and glibc v 2.1.3 or
     newer.
     Blackdown does support running the Java 2 SDK on SMP kernels. 

     You should have about 80 megabytes of free disk space before
     attempting to install the Java 2 SDK software. If you also
     install the separate documentation download bundle, you need an
     additional 130 megabytes of free disk space. 

     NOTE: This version does not work with glibc-2.1.92 (a broken
     glibc-2.2 test release) which is shipped with RedHat 7.0. Please
     get the necessary updates/fixes from the RedHat site. 

Installation

     The complete Java 2 SDK is composed of the SDK Software plus the 
     SDK Documentation, each of which is separately downloadable.
     Installation instructions are maintained on the web site:

     Installation instructions are in the local INSTALL file and at
     http://www.blackdown.org/

     Refer to the copyright and license for legal terms of use.

Release Notes

      See the Release Notes on the Java Software web site for additional 
      information pertaining to this release. 
 
      http://java.sun.com/j2se/1.3/relnotes.html

      The on-line release notes will be updated as needed, so you should 
      check it occasionally for the latest information. 


Bug Reports and Feedback

      If you think you have found a Blackdown specific bug please take
      a look at our known bugs page
      (http://www.blackdown.org/java-linux/java2-status/known-bugs.html)
      before submitting a bug at our
      bug reporting page (http://www.blackdown.org/cgi-bin/jdk).

Java 2 SDK Documentation

     The on-line Java 2 SDK Documentation contains API specifications,
     feature descriptions, developer guides, tool reference pages, demos, 
     and links to related information. It is located at

     http://java.sun.com/j2se/1.3/docs/

     The Java 2 SDK documentation is also available in a download bundle 
     which you can install locally on your machine. See the 
     Java 2 SDK download page: 
     
     http://java.sun.com/jdc/earlyAccess/j2sdk131/docs.html

Blackdown Java-Linux Web Pages

     For additional information, refer to these Blackdown Java-Linux
     pages on the World Wide Web:

       http://www.blackdown.org/ 
              The Blackdown Java-Linux web site, with the latest
              information on product information, news, and features.
       http://www.blackdown.org/java-linux/java2-status/ 
              Blackdown Java-Linux Status and Information page. 
       http://www.blackdown.org/java-linux/mirrors.html 
              Blackdown Java-Linux FTP mirrors. 

Sun Java Web Pages

     For additional information, refer to these Sun Microsystems pages
     on the World Wide Web:

     http://java.sun.com/
          The Java Software web site, with the latest information on
          Java technology, product information, news, and features.
     http://java.sun.com/j2se/1.3/
          Java 2 SDK Web Site
     http://java.sun.com/docs
          Java Platform Documentation provides access to white papers,
          the Java Tutorial and other documents.
     http://java.sun.com/jdc
          The Java Developer Connection(SM) web site. (Free registration
          required.) Additional technical information, news, and
          features; user forums; support information, and much more.
     http://java.sun.com/products/
          Java Technology Products & API

Credits

     The following people have helped with the porting of Java 2 to Linux: 

        Juergen Kreileder 
        Kevin B. Hendricks 
        Johan Vos 
        Eddie C. Dost 
        Scott Hutinger 
        Karl Asha 
        Kars de Jong 
        Calvin Austin 
        Matt Peterson 
        Steve Byrne 
        Anand Palaniswamy 
        Tod Matola 
        Greg Wolodkin 


------------------------------------------------------------------------
The Java 2 SDK, Standard Edition, is a product of Sun Microsystems(TM), 
Inc.  This product includes code licensed from RSA Data Security.

Copyright  1997-2001, Sun Microsystems, Inc.
901 San Antonio Road, Palo Alto, California 94303-4900 USA.
All rights reserved.
