1 I. Compiling a simple test program
3 1) Go to the Robust directory and type "cvs update"
5 2) Go into the src directory and build the compiler by typing:
9 3) To run the compiler on a source file (For example to compile
11 java -cp ../cup/:. Main.Main -mainclass Array Tests/Array.java
13 4) To compiler and link the output of the compiler do:
14 gcc -IRuntime -I. -O0 -g methods.c Runtime/runtime.c
16 5) To run the binary type:
21 II. Command line options
23 To see all the legal command line options for the compiler type:
24 java -cp ../cup:. Main.Main -help
28 III. Using Garbage Collection
30 1) Download the Hans Boehm garbage collector
32 2) Make a directory called gc in the Runtime directory & untar the gc into this directory
34 3) ./configure --prefix={RUNTIME DIRECTORY}; make;make install to build
35 (Modify the prefix to the appropriate path for the runtime directory.
37 4) Make sure the gc libraries are placed in Runtime/lib and the include files in Runtime/include
39 5) Change step 4 in the build procedure to:
40 gcc -IRuntime -I. -IRuntime/include -DBOEHM_GC -LRuntime/lib/ -lgc -O9 -g methods.c Runtime/runtime.c
42 IV. High level organization of the compiler:
43 1. Lexer is in src/Lex
44 2. Parser is built from the grammar in Parse/java14.cup
45 3. Internal Representations are in the the IR subdirectory
46 3a. Tree representation is in IR/Tree (constructed by IR/Tree/BuildTree)
47 3b. Flattened representation in is IR/Flat (constructed by IR/Flat/BuildFlat)
48 4. Code is generated from the flattened representation by IR/Flat/BuildCode
49 5. Main/Main.java is the top level
50 6. ClassLibrary contains the class library
51 7. Runtime contains the runtime