HACKING


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
51
52
53
54
55
56
57

If you want to hack on GNU Classpath it will make things easier if you
have the following installed:

        - GNU autoconf 2.13
        - GNU automake 1.4
        - GNU libtool 1.3.3
        - GTK+ 1.2.x
        - IBM jikes 1.0.9+
	- libart_lgpl 2.1.0
	- gdk-pixbuf (latest out of gnome.org's CVS)

If you start from the current CVS version, you will have to run the
following from the toplevel directory.

        aclocal; autoheader; automake; autoconf

Next you run configure.  Options you'll probably want to specify
include --with-jikes, --with-javah={path to jdk}/javah,
--with-classlib={path to classes.jar}/classes.jar and --with-japhar or
--with-kaffe, neither of which take an argument.  

You can also now specify --with-includedir=DIR multiple times to
indicate more include directories.  For native compilation you need
jni.h from the JDK, Japhar, or Kaffe in your include path.  This is
done automatically for you if you specify --with-japhar or
--with-kaffe.  Otherwise you could probably copy it to
classpath/include and it will work.  Kaffeh appears to have a small
bug which keeps us from using it to generate valid header files.  The
file kaffe-config is needed to support Kaffe and so far that has not
been incorporated into Kaffe (any version) but you can find the
message in the archives of the Classpath list and add it to your own
installation of Kaffe (reconfigure and install needed).

If you have a new VM you would like to compile Classpath for then
you'll probably want to modify acinclude.m4 and configure.in to add
whatever is relevant but most importantly defining JVM_REFERENCE and
then giving us the necessary files to add to the vm/$JVM_REFERENCE
directory.  The vm integration document describes what those files
should minimally include.  Otherwise you'll have to have one of Japhar
or Kaffe installed and the programs japhar-config or kaffe-config
available respectively.

Jikes 1.11 should contain a code for placing .u (dependency files)
where -d would also place class files.  This will be used in the
distributions of classpath to make compilation with javac, etc.
easier/possible.

Gnome cvs can be obtained with 
:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome and a blank password.  
The module name for gdk-pixbuf is gdk-pixbuf.

There should be no compiling errors within Java source code which is
checked in.  Code should be compiled in the build process before
checking it in.

If you have any questions, suggestions, etc., send them to
classpath@gnu.org.