This file explains how to build the jaxm/saaj sources.


Required software to build JAXM/SAAJ 1.1
----------------------------------------

To be able to build JAXM/SAAJ 1.1 you need to have the following software -

1. Apache Ant 1.4.1 or higher can be downloaded from 
http://jakarta.apache.org/ant

2. Servlet 2.2 or higher APIs can be downloaded from 
http://jakarta.apache.org/tomcat

3. DOM4J 1.1 or higher can be downloaded from
http://www.dom4j.org

4.Java Beans Activation Framework can be downloaded from
http://java.sun.com/products/javabeans/glasgow/jaf.html

5. Jakarta Commons logging component can be downloaded from
http://jakarta.apache.org/commons/logging.html

6. JAXP 1.2 can be downloaded from
http://java.sun.com/xml/jaxp

7. Java Mail can be downloaded from 
http://java.sun.com/products/javamail

Once you have all the above required components building JAXM 1.0 is
pretty straight forward and trivial. The following steps need to be
carried to successfully build JAXM/SAAJ 1.1 -

1. Modify the build.xml to point to the appropriate location for all the above 
   required jar files.

2. Go into the directory where you have downloaded the JAXM 1.0 sources and 
   run the following command:

    ant[.bat] dist

This should create a "build" and a "dist" directory. After the command
has completed JAXM/SAAJ 1.1 should be built in the dist directory.

The jar files that are built from the sources are as follows:

      dist ---+
              |
              |
              |
	      / ---jaxm
		      saaj-ri.jar
		      jaxm-runtime.jar
		      jaxm-provider.war

saaj-ri.jar is the runtime for SAAJ 1.1. jaxm-runtime.jar has the
support for profiles in JAXM.  jaxm-provider.war a web application
that is needed to run the provider.

In the "lib" directory under dist there is:


      dist ---+	---lib
	      |       commons-logging.jar
	      |       dom.jar
	      |       mail.jar
	      |       xalan.jar
	      |       jaxm-api.jar
	      |       activation.jar
	      |       saaj-api.jar
	      |       xsltc.jar
	      |       jaxp-api.jar
	      |       xercesImpl.jar
	      |       sax.jar
	      |       dom4j.jar


jaxm-api.jar and all the jars for the software listed out above that are needed
for jaxm.

In the "samples" directory under dists there are 

a few war files that are sample web applications and a couple of standalone 
applications.

In the docs directory resides all the documentation including the javadocs for
the JAXM API.

