# Java API for XML Parsing
Installation

Version: 1.0.1

## System Requirements

This version of the Java API for XML Parsing requires:

- JDK 1.1.8 or later (including the Java 2 SDK)
- Approximately 3.5M of disk space

In addition, the PATH and JAVA_HOME environment variables must reference the JDK or Java 2 SDK. If you have not already done this, use the following instructions:

On Solaris, if you've installed the JDK in /java:

        % set PATH=(/java/bin $PATH)
        % setenv JAVA_HOME /java

On Win32 systems, if you have installed the JDK or Java 2 SDK in D:\java:

        C:\> set PATH=D:\java\bin;%PATH%
        C:\> set JAVA_HOME=D:\java

## Installation

1. Download the ZIP/Install file.

   Log on to the Java Developer Connection site and select the download file for the platform you are using (Windows or Unix).

   On Unix, download or copy the file to the location where you want to install the software.

2. Install/UnZip the file.

   On Unix systems, uncompress the downloaded jaxp-1_0_1.zip ZIP file.

   You may use the JAR command from the JDK or Java 2 SDK to unzip the distribution:

   > `jar xvf jaxp-1_0_1.zip`

   Alternatively, you may use an UnZip utility. Info-ZIP is one such utility, available on a variety of operating systems.

   Unzipping the file creates a directory called jaxp1.0.1 within the current directory.

   On Windows systems, simply run the downloaded jaxp-1_0_1-win.exe file. By default, this program uses the following directory:
   c:\Program Files\javasoft\jaxp1.0.1

   You may change the destination directory at setup time.

3. Check the contents of the distribution.

   After the software is unzipped or installed, the new directory should contain the following files:

   LICENSE | The license applying to this software
   docs/api/* | Javadoc generated files presenting library APIs
   examples/* | Example files, in subdirectories
   examples/index.html | Index to the example files
   readme.html | README for this release
   install.html | This file
   relnotes.html | Release notes
   jaxp.jar | Java Archive file containing the javax classes
   parser.jar | Java Archive file containing the implementation classes

4. Update the CLASSPATH.

   You can either update the CLASSPATH variable to include the jaxp.jar and parser.jar files, or you can install the JAR file as an extension to Java 2 SDK.

   To update the CLASSPATH or java-classpath variables, add the following entry to the variable (where $XML is the base directory in which the XML library is installed):

   - `$XML/jaxp.jar:$XML/parser.jar` (Solaris)
   - `$XML\jaxp.jar;$XML\parser.jar` (Win32)

   To install these JAR files as an extension of Java 2 SDK, copy it to the jre/lib/ext directory. This eliminates the need to modify class paths. (This technique may also be used with the Java Plug-in.)

5. Run the sample programs.

   To run the sample programs, first compile them, then run them following the invocation instructions in the Makefile (for Solaris) or batch file (for Win32).

   The Makefiles and batch files should work with minimal changes, if any. The files will build the classes as necessary, assuming that the JDK is set up correctly. For example:

           % cd $XML/examples/simple
           % make
           ... output
           %

   or in Windows:

            C:\Program Files\javasoft\jaxp1.0.1> cd examples\simple
            C:\Program Files\javasoft\jaxp1.0.1\examples\simple> build
            ... output
            C:\Program Files\javasoft\jaxp1.0.1\examples\simple>

Note that due to code generation problems in the 1.1 "javac" and JDK 1.3 beta compiler, you should only recompile the source code to this library with a Java 2 SDK compiler.