--- projects/cms/source/server/README 2001/05/20 00:57:47 1.10 +++ projects/cms/source/server/README 2003/02/05 22:27:24 1.13 @@ -4,6 +4,9 @@ i-scream Server README ANT build vs Make build ----------------------- +** We have revamped the Makefile, but not the ANT build ** +** So please use the Makefile for now ** + There are now two methods of compiling the server distribution. The existing Makefile method is still supported, but is of course limited in the OS's on which it can be run. The preffered method will be an XML based build script @@ -32,6 +35,10 @@ make build make install prefix=/some/path make clean +Alternatively there is a "make dist" target which will build a +distribution archive containing the built code, the javadoc, and +the source code. + In more detail, the first line ensures that the required libraries are available, and sets the Makefiles up so they know where everything is. The second line compiles all of the code and creates a JAR file in the @@ -94,23 +101,23 @@ install Installs the server to a given directory. Also takes a prefix; make install prefix = /usr/i-scream -cvsbuild +dist - Builds any tagged version of the server from CVS. This saves the need to - checkout a version to build it, as it's all done automatically; - make install rev = RELEASE_1 - Default tag is HEAD. + Builds a full distribution of the server. + make dist dest=/tmp +dist-bin + + Builds a binary distribution of the server. + make dist dest=/tmp + javadoc Builds all the javadoc pages in the `doc' directory. -buildutil +src - (it is recommended you run a "make clean" first) - Builds a seperate JAR file, in `build' called `iscream-util.jar'. - This file contains just the uk.ac.ukc.iscream.util package for - use in other parts of the system, such as the clients. + Copies the whole src tree in to the `build/src' directory. createtable