                                   README

                            Blackdown Java-Linux

                      Java(TM) 2 SDK, Standard Edition
                 Version 1.3.0 Release Candidate 1 for Linux

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

Contents

   * Introduction
   * Installation
   * Features
   * Demos
   * Java 2 SDK Documentation
   * System Requirements
   * Sun Java Web Pages
   * Credits


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.

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
     Java Developer Connection 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.


Features

     The version 1.3 of the Java 2 SDK offers significant improvements in 
     functionality and performance over previous versions. See:

        * Summary of New Features - Features added since version 1.2 
          of the Java 2 SDK.
          http://java.sun.com/j2se/1.3/docs/relnotes/features.html

        * Guide to Features - Complete list of all features.
          http://java.sun.com/j2se/1.3/docs/index.html#guide

Demos

     A demo directory is included in this software bundle with a
     variety of applets, Swing applications, and other examples for 
     you to try out. The demos come with complete source code.


Java 2 SDK Documentation

     The on-line Java 2 SDK Documentation contains API specifications,
     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 with your Java 2 SDK software. See the 
     Java 2 SDK download page: 
     
     http://java.sun.com/jdc/earlyAccess/j2sdk13/docs.html


System Requirements

     This version of the Java 2 SDK is supported on Intel Pentium 
     platform running the Linux kernel v 2.2.14 and glibc v 2.1.3.

     This version does not work with glibc-2.1.92 (a broken glibc-2.2
     test release) which is shipped with RedHat 7.0.  Initial tests
     show that this release works with glibc-2.1.94 but we don't
     support this combination yet.

     Check your version of glibc using the following command: 

         ls /lib/libc-*

     The output of this command should show libc-2.1.3.so or higher. 

     Blackdown does support running the Java 2 SDK on SMP kernels. 

     You should have about 75 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 
     125 megabytes of free disk space.


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/
          Java 2 SDK Product and Download Page
     http://java.sun.com/docs
          Java Platform Documentation provides access to white papers,
          the Java Tutorial and other documents.
     http://developer.java.sun.com/
          The Java Developer Connection 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 Java 2 Platform, Standard Edition port to Linux was made 
     possible by the efforts of several volunteers of the Blackdown 
     porting team. Sun is grateful to the Blackdown porting team 
     members and their support of the Java-on-Linux community. 

------------------------------------------------------------------------
The Java 2 SDK, Standard Edition, is a product of Sun Microsystems(TM), 
Inc.

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