INSTALL


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

Before installing, note that only Japhar 0.07 or later is supported.
Currently only Japhar 0.06 is in distribution which means you will need
the latest and greatest Japhar from CVS in order for Classpath to
work.  (This will only be needed until the next Japhar development
release).  If you don't have the current Japhar from CVS, Classpath
won't work.  See http://www.japhar.org/ for details on anonymous CVS
access to the Japhar sources.

This package was designed to use the GNU standard for configuration
and makefiles.  To build and install do the following:

1).  Run the "configure" script to configure the package.  There are
various options you might want to pass to configure to control how the
package is built.  "configure --help" will give a complete list.  Of
relevance, a target JVM must be specified.  Currently only Japhar is
supported, and the option for that is --with-japhar.  (This option is
turned on by default).  The target JVM will be used to compile the
class library by default, but this can be overridden by specifying a
java executable to use (the --with-java=<path-to-java> option) and the
class library archive to use (the --with-classlib=<path-to-classlib>
option).  It is a good idea to use these last two options to specify
the JDK for compiling, since Japhar current doesn't work. :-)

2).  Type "make' to build the package

3).  Type "make install" to install everything.  This may require
being the superuser.

The compiled classes are stored in a file called glibj.zip, which is
installed in the architecture independent data directory of your
target JVM.  For Japhar, this is the "share" directory under the
Japhar root.  The native libraries are stored where the target JVM
stores its own native libraries.  This is the "lib" directory under
the Japhar root directory.

Once installed, GNU Classpath is ready to be used.  Simply ensure that
the glibj.zip file is in your $CLASSPATH environment variable.

Ok, here is a configuration, build, install, and test example.  This
may or may not be appropriate for your system.

./configure --with-japhar --with-java=/usr/local/jdk1.1.5/bin/javav \
    --with-classlib=/usr/local/jdk1.1.5/lib/classes.zip
make
make install
japhar --classpath /usr/local/japhar/share/glibj.zip:. FooClass

Report bugs to classpath@gnu.org.

Happy Hacking!