README.txt

   1 MJC2WSL - convert MicroJava Compiled Bytecode to WSL/FermaT
   2 ===========================================================
   3
   4 mjc2wsl is distributed under the GPL licence, for more details check the src
   5 folder.
   6
   7
   8 Quick build and test
   9 --------------------
  10
  11 Running ant in the folder should compile the tool as well as the MJ compiler
  12 and then do a test - compile all of the sample MicroJava codes into MJ
  13 bytecode, translate them to WSL and then apply the given transformations in
  14 MetaWSL to the programs.
  15
  16
  17 Requirements
  18 ------------
  19
  20 - java JDK for compiling and running the mjc2wsl tool and the MJ compiler
  21
  22 - ant for building and testing
  23 -- ant-contrib tasks are needed for some of the tasks
  24
  25 - FermaT for running the translated examples and applying the transformations
  26 (FermaT Maintanance Environment can be used)
  27 Downloads available at http://www.cse.dmu.ac.uk/~mward/fermat.html
  28
  29
  30 Setting the FermaT dir
  31 ----------------------
  32
  33 The ant build script assumes that Fermat is in "C:/fermat3" under Windows
  34 and "~/fermat3" for everything else (Linux/Mac...).
  35
  36 If you need to change this you can rename (or copy) the given file
  37 "custom.properties.default" to "custom.properties" and specify a correct
  38 path for your system.
  39
  40
  41 About MicroJava
  42 ---------------
  43
  44 This is a simple language made by H. Mössenböck for a Compiler Construction
  45 course.  It is NOT the same as Java Micro Edition (JavaME) used on mobile
  46 phones.
  47
  48 For details about the language and the version used in this project check
  49 out the "docs" folder.
  50
  51 More about the course, the language and its VM:
  52 http://www.ssw.uni-linz.ac.at/Misc/CC/
  53
  54 A functional compiler is distributed in the lib folder for ease of testing
  55 and evaluating.  Check the folder for further details.
  56
  57
  58 Contact
  59 -------
  60
  61 Project home:
  62 http://perun.dmi.rs/pracner/transformations
  63
  64 Feel free to contact Doni Pracner if you have any problems, ideas
  65 or suggestions.