README for xml-xalan project at apache.org

See docs_production for detailed doc on the project, or 
see docs_production/apidocs for Javadoc (both must be built first).


Basic Build Instructions for xml-xalan:

- Use GNU Make or an equivalent. On win32 you might try http://sourceware.cygnus.com/cygwin
  Note that you will need the full Cygwin toolkit, since the make relies on a number
  of other unix-like utilities like cp, rm, etc.  Also, the toolkit must be on your PATH
  *before* most other Win32 utilities, notably the NT Resource Kit. Set MAKE_MODE as follows:
       set MAKE_MODE=UNIX 

- The makefiles use:
    ifeq (,$(findstring usr,$(PATH)))
  to determine if we're on Win32 (usr not in PATH) or a unix flavor (usr probably
  in PATH).  Please let shane_curcuru@lotus.com know if you have a better way.

- As long as xml-xalan is built in the sibling directory to xml-xerces, you shouldn't 
  have to set any environment variables. See Makefile for other environment notes.

- Common make targets from xml-xalan directory:
    'make all'      to build everything.
    'make build'    to compile and build the jar.
    'make jars'     to build jar files.
    'make docs'     to build the docs (they will be put into the docs_production directory).
    'make samples'  to build the samples and create samples.jar.
    'make clean'    as you'd expect.

- Special note for JDK 1.1.7B users: Some dependencies seem to cause a problem
  with JDK 1.1.7B - you may have to do a 'make all' several times to get everything
  built.  It compiles fine the first time with JDK 1.1.8 or later.  We'll look into it.