documentation changes
[cacao.git] / INSTALL
1 CACAO specific installation instructions
2 ========================================
3
4 * CLASSPATH, classfiles & other Java weirdness
5 ----------------------------------------------
6
7 Make sure, you have classfiles, which work with cacao. A version of
8 these can be found at
9 ftp://www.complang.tuwien.ac.at/pub/java/cacao/classes.zip.gz
10
11 After the installation of these set the environment variable CLASSPATH
12 to the directories where your class libraries are stored. The
13 environment variable JAVA_HOME (due to a bug this variable is called
14 JAVAHOME in versions less than 0.4) to the java home
15 directory. E. g. if you unzipped classes.zip in the directory
16 /usr/local/lib/java/classes set the environment variable to
17 /usr/local/lib/java/classes and JAVA_HOME to /usr/local/lib/java.
18
19 * configuring & compiling CACAO
20 -------------------------------
21
22   1. Unpack the tar archive (apparently you have done this, otherwise
23      you wouldn't read this file.
24
25   2. `cd' to the directory containing the package's source code and type
26      `./configure' to configure the package for your system.  If you're
27      using `csh' on an old version of System V, you might need to type
28      `sh ./configure' instead to prevent `csh' from trying to execute
29      `configure' itself.
30
31      Running `configure' takes awhile.  While running, it prints some
32      messages telling which features it is checking for.
33
34   3. Type make.
35
36 After this you should have a working version of cacao and cacaoh. How to
37 invoke cacao and which class library has to be used is described at the
38 CACAO home page (http://www.complang.tuwien.ac.at/java/cacao/index.html).