So you want to use joeq? This guide gives step-by-step instructions on how to set up the joeq development environment. The instructions given here are by no means the only way to set up joeq; advanced users can, for example, use their own Java IDE or CVS client.
First, make sure that your system meets the minimum specs for joeq. To successfully compile and use joeq, you'll need the following:
In addition, if you want to bootstrap joeq, you will need the following:
Also, these are not strictly necessary, but highly recommended:
joeq supports two modes of operation: "hosted" and "native". In hosted mode, joeq runs on top of another virtual machine. Because joeq is written in Java, almost all of the code is VM-independent; it can run on any Java virtual machine that obeys the JVM specification. If you are just interested in using joeq as a compiler infrastructure, then you will only need to use hosted mode. Hosted mode relies on the resources of the underlying virtual machine for garbage collection, synchronization, thread scheduling, etc.
In native mode, joeq runs on its own, without another virtual machine below it. In native mode, joeq uses its own runtime routines for allocation/garbage collection, thread scheduler, etc. Thus, if you are interested in using or experimenting with the joeq runtime system, you will need to use native mode.
Native mode requires a bootstrapping phase, whereby joeq is first run in hosted mode and an object file is dumped out, which is then linked to create a standalone executable. The bootstrapping phase relies on the specifics of the internal implementation of the virtual machine used for bootstrapping. Thus, only certain virtual machine versions are supported.
I have tested joeq bootstrapping with the following versions:
To set up the Eclipse IDE for use with joeq, follow the tutorial here.
First, if you don't have the Sun JDK installed yet, download version 1.4.2 from here and install it into the default directory. joeq uses Sun's JVM to bootstrap itself, and it also uses the Sun class libraries.
If your machine is low on physical memory, you can also use version 1.3.1, available here.
Note: other JVM's that do not use the Sun class libraries, like gcj, will probably not bootstrap correctly. They should run fine in hosted mode, however.
First, download the Eclipse IDE from here. The one I recommend downloading is listed as "Stable Build". Install it by extracting the archive to the root directory of your drive and double-clicking on the eclipse.exe program in the extracted eclipse/ directory. It will say "Please wait, completing the install..." and then drop you into the Eclipse IDE.