In the top level directory of the source distribution James includes two helper scripts for running
the build. The script build.bat should be used on Windows systems, while build.sh is appropriate for
Unix systems. Each script takes an optional set of arguments that tell the script exactly what to build.
To use these scripts, simple set the environment variable JAVA_HOME to the base directory of the
JDK. Then run the build script, optionally with any of the following command line arguments:
- clean - deletes the build directory, making the system ready for a clean build.
- compile - compiles the source code.
- dist - generates all the James distributions, packed.
- dist-lite - generates all the James distributions, unpacked. This is the default argument.
- javadocs - builds the James javadocs.
- usage - prints out the usage instructions for the script.
- website - builds the entirety of the James website.
- xdocs - creates the documentaion for James.
All build products are output in the dist subdirectory of the James source distribution directory. There
is also a build subdirectory of the James source distribution directory that is created during the build process. Both
of these directories will be deleted if you run build with the clean argument.
Warning! Any changes you've made in the 'dist' directory
will be lost after a recompilation. If you are making changes to the config.xml
or other files, we recommend you backup and then change the copies in src to
avoid losing work.