Robust/src/README

   1 I. Compiling a simple test program
   2
   3 1) Go to the Robust directory and type "cvs update"
   4
   5 2) Go into the src directory and build the compiler by typing:
   6 make clean
   7 make
   8
   9 3) To run the compiler on a source file (For example to compile
  10 Tests/Array.java):
  11 java -cp ../cup/:. Main.Main -mainclass Array Tests/Array.java
  12
  13 4) To compiler and link the output of the compiler do:
  14 gcc -IRuntime -I. -O0 -g methods.c Runtime/runtime.c
  15
  16 5) To run the binary type:
  17 ./a.out
  18
  19
  20
  21 II. Command line options
  22
  23 To see all the legal command line options for the compiler type:
  24 java -cp ../cup:. Main.Main -help
  25
  26
  27
  28 III. Using Garbage Collection
  29
  30 1) Download the Hans Boehm garbage collector
  31
  32 2) Make a directory called gc in the Runtime directory & untar the gc into this directory
  33
  34 3) ./configure --prefix={RUNTIME DIRECTORY}; make;make install to build
  35 (Modify the prefix to the appropriate path for the runtime directory.
  36
  37 4) Make sure the gc libraries are placed in Runtime/lib and the include files in Runtime/include
  38
  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
  41
  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