| 1 | 
   | 
 i-scream Server README | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 2 | 
   | 
 ====================== | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 3 | 
   | 
  | 
 
 
 
 
 
 
 
 
 | 4 | 
 + | 
 ANT build vs Make build | 
 
 
 
 
 
 
 
 
 | 5 | 
 + | 
 ----------------------- | 
 
 
 
 
 
 
 
 
 | 6 | 
 + | 
  | 
 
 
 
 
 
 
 
 
 | 7 | 
 + | 
 ** We have revamped the Makefile, but not the ANT build ** | 
 
 
 
 
 
 
 
 
 | 8 | 
 + | 
 ** So please use the Makefile for now ** | 
 
 
 
 
 
 
 
 
 | 9 | 
 + | 
  | 
 
 
 
 
 
 
 
 
 | 10 | 
 + | 
 There are now two methods of compiling the server distribution. The existing | 
 
 
 
 
 
 
 
 
 | 11 | 
 + | 
 Makefile method is still supported, but is of course limited in the OS's on | 
 
 
 
 
 
 
 
 
 | 12 | 
 + | 
 which it can be run. The preffered method will be an XML based build script | 
 
 
 
 
 
 
 
 
 | 13 | 
 + | 
 using ANT (http://jakarta.apache.org/ant) which will run on any platform. | 
 
 
 
 
 
 
 
 
 | 14 | 
 + | 
 However, at this stage the ANT scripts are not completely finished and may | 
 
 
 
 
 
 
 
 
 | 15 | 
 + | 
 have some odd behaviour. | 
 
 
 
 
 
 
 
 
 | 16 | 
 + | 
  | 
 
 
 
 
 
 
 
 
 | 17 | 
 + | 
 We envisage both the Makefile and ANT setups being maintained for some time, | 
 
 
 
 
 
 
 
 
 | 18 | 
 + | 
 giving the developer a choice. This document still outlines the Makefile | 
 
 
 
 
 
 
 
 
 | 19 | 
 + | 
 method of compiling, and will do so until such a point as the ANT scripts | 
 
 
 
 
 
 
 
 
 | 20 | 
 + | 
 are deemed reliable. If, however, you wish to give the ant script a whirl, | 
 
 
 
 
 
 
 
 
 | 21 | 
 + | 
 try the following after setting up ANT (see the ANT website for details); | 
 
 
 
 
 
 
 
 
 | 22 | 
 + | 
  | 
 
 
 
 
 
 
 
 
 | 23 | 
 + | 
 ant help | 
 
 
 
 
 
 
 
 
 | 24 | 
 + | 
  | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 25 | 
   | 
 Compiling | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 26 | 
   | 
 --------- | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 27 | 
   | 
  | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 97 | 
   | 
   Installs the server to a given directory. Also takes a prefix; | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 98 | 
   | 
     make install prefix = /usr/i-scream | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 99 | 
   | 
  | 
 
 
 
 
 
 
 
 
 
 
 
 | 100 | 
 < | 
 cvsbuild | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 100 | 
 > | 
 dist | 
 
 
 
 
 
 | 101 | 
 > | 
   Builds a full distribution of the server. | 
 
 
 
 
 
 | 102 | 
 > | 
     make dist ver = 1.0 | 
 
 
 
 
 
 | 103 | 
 > | 
   Default ver is HEAD. | 
 
 
 
 
 
 
 
 
 
 
 
 | 104 | 
   | 
  | 
 
 
 
 
 
 
 
 
 
 
 
 | 105 | 
 < | 
   Builds any tagged version of the server from CVS. This saves the need to | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 106 | 
 < | 
   checkout a version to build it, as it's all done automatically; | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 107 | 
 < | 
     make install rev = RELEASE_1 | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 108 | 
 < | 
   Default tag is HEAD. | 
 
 
 
 
 
 
 
 
 
 | 105 | 
 > | 
 dist-bin | 
 
 
 
 
 
 | 106 | 
 > | 
   Builds a binary distribution of the server. | 
 
 
 
 
 
 | 107 | 
 > | 
     make dist ver = 1.0 | 
 
 
 
 
 
 | 108 | 
 > | 
   Default ver is HEAD. | 
 
 
 
 
 
 
 
 
 
 
 
 | 109 | 
   | 
  | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 110 | 
   | 
 javadoc | 
 
 
 
 
 
 
 
 
 
 
 
 
 
 | 111 | 
   | 
  |