README

JavaTM 2 SDK, Standard Edition, v 1.2.2, Release Candidate, Linux Port

Introduction

Thank you for downloading this release of the Java 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.

Features

The Java 2 SDK offers significant improvements in functionality, performance, security and global support over previous versions of the Java platform.

See:

Installation

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

Java 2 SDK Documentation

The Java 2 SDK Documentation contains API specifications, developer guides, tool reference pages, demos, and links to related information. This documentation is also available in a download bundle which you can install locally with your Java 2 SDK software. See the Java 2 SDK documentation download page

System Requirements

This version of the Java 2 SDK is supported on Intel Pentium platform running the Linux kernel v 2.2.5 and GLibC v 2.1, 32 megabytes RAM minimum. Recommended 48 megabytes of RAM, 16-bit color mode, KDE and KWM window managers.

You should have 65 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 90 megabytes of free disk space.

Compatibility

See Compatibility with Previous Releases on the Java Software website for the list of known compatibility issues. Every effort has been made to support programs written for the 1.0 or 1.1 platform. Although some incompatible changes were necessary, most software should migrate to current version with no reprogramming. Any failure to do so is considered a bug, except for a small number of cases where compatibility was deliberately broken, as described on our compatibility page. Some compatibility-breaking changes were required to close potential security holes or to fix implementation or design bugs.

Demos

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

Bug Reports and Feedback

The Bug Parade Web Page on the Java Developer Connection web site lets you search for and examine existing bug reports, submit your own bug reports, and tell us which bug fixes matter most to you. To directly submit a bug or request a feature, fill out this form

You can also send comments directly to j2se-linux-comments@sun.com

Contents of the Java 2 SDK

This section contains a general summary of the files and directories in the Java 2 SDK.
Development Tools

(In the bin subdirectory.) Programs that will help you develop, execute, debug, and document programs written in the Java programming language. For further information, see the tool documentation.

Java Runtime Environment

(In the jre subdirectory.) An implementation of the Java runtime environment for use by the SDK. The runtime environment includes a Java virtual machine*, class libraries, and other files that support the execution of programs written in the Java programming language.

Additional Libraries

(In the lib subdirectory.) Additional class libraries and support files required by the development tools.

Demo Applets and Applications

(In the demo subdirectory.) Examples, with source code, of programming for the Java platform. These include examples that use Swing and other Java Foundation Classes.

C Header Files

(In the include subdirectory.) Header files that support native-code programming using the Java Native Interface and the Java Virtual Machine Debugger Interface.

Old Native Interface Headers

(In the include-old subdirectory.) Header files that support native-code programming using older interfaces. The header files in include-old are provided only for backward-compatibility. These interfaces are deprecated, unsupported and not available on all Java virtual machines.

Source Code

(In src.jar archive file.) Java programming language source files for all classes that make up the Java 2 core API (that is, sources files for the java.*, javax.* and org.omg.* packages, but not for com.sun.* packages). This source code is provided for informational purposes only, to help developers learn and use the Java programming language. These files do not include platform-specific implementation code and cannot be used to rebuild the class libraries. To extract these file, use this command:

          jar xvf src.jar
Do not modify core API source files. To extend the behavior of the core API, write subclasses of the core API classes.

For API documentation, refer to the following sources:

Documentation

(In the docs subdirectory.) This directory is created when the Java 2 SDK documentation is installed. It contains release documentation, Java API specifications, developer guides, tool documentation, demos, and links to related documentation.

Java 2 Runtime Environment and Java Plug-in

The Java 2 Runtime Environment allows you to run applications written in the Java programming language. It consists of the Java virtual machine, classes comprising the Java API, and supporting files, but contains no development tools such as compilers and debuggers. You may freely redistribute the Java 2 Runtime Environment with your application, according to the terms of the Runtime Environment's license. Once you've developed your application using the Java 2 SDK, you can ship it with the Runtime Environment so your end-users will have a Java platform on which to run your software.

Note that the Java 2 SDK has an internal implementation of a Java runtime environment for its own use. This internal runtime environment is contained in the SDK software's jre directory. Don't confuse the SDK's internal runtime environment with the Java 2 Runtime Environment, which is a separately installable product.

This release of the Java 2 Platform, Standard Edition, v 1.2.2 for Linux does not include JavaTM Plug-in. Java Plug-in provides connectivity between widely-distributed web browsers and the Java 2 Runtime Environment, Standard Edition (JRE). Typically, Java Plug-in is bundled with, and included as part of, the JRE. Future plans call for a Linux port of Java Plug-in and inclusion of it as part of the Linux JRE.

In the future, it is also Sun's intent to support a fully localized Japanese release. However, native Japanese fonts are currently not supported.

Sun Java Web Pages

For additional information, refer to these Sun Microsystems pages on the World Wide Web:
*The terms "Java virtual machine" or "JVM" mean a virtual machine for the Java platform.

The Java 2 SDK, Standard Edition, is a product of Sun MicrosystemsTM, Inc.

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