Java 1.0 compatible version supporting Pizza 1.0: 0.31 from 11 Mar 97.

Pizza is implemented on top of the Java development kit (other Java-compatible virtual machines will also work). The Pizza compiler pc is a straight replacement for Sun's Java compiler javac. When compiling .java files, pc works just like javac, except that it's up to 2 times faster for large sources.

This page describes the procedure for downloading and installing Pizza for UNIX and Windows '95 systems in six easy steps. If you know something about Java, you can also install Pizza on any other conforming Java system by proceeding analogously to what's described here.

We recommend that you also subscribe to the Pizza mailing lists, which notify you of updates to this distribution and provide answers to questions relating to Pizza.

1. Get the Java development kit, in case you don't have it already. You need to have the JDK 1.1 or higher if you want to run the current Pizza version. If you prefer JDK 1.0, use Pizza 0.31 instead.

2. Get the Pizza distribution, either as a zip archive or as a gzipped tar file.

3. Pick a directory for unpacking and unpack the distribution into it. This will create a pizza directory with two subdirectories classes and src .

4. Include the pizza/classes subdirectory in your CLASSPATH. Alternatively, move the pizza/classes directory into some other directory on your CLASSPATH. In case the CLASSPATH environment variable is not yet defined you need to set it now.

   You should now have a directory, say `X', in your CLASSPATH such that

   `X'/pizza/compiler/Main.class

   exists. Make sure that this is the case.

5. On UNIX systems, set an alias (csh syntax used here).

   alias pc java -ms8m pizza.compiler.Main

   To set up an alias for Pizzadoc use

   alias pizzadoc java -ms8m pizza.compiler.Main -pizzadoc -d /home/doc

   What redirects the generated documentation files to your directory /home/doc.

   On Windows systems, you can use the files pc.BAT and pizzadoc.BAT, which are part of the distrution. Be sure to put these file into a directory which is in your executable path. Note that the file pc.BAT contains the single line:

   java -ms8m pizza.compiler.Main %1 %2 %3 %4 %5 %6 %7 %8 %9

   The option -ms8m sets the initial heapsize of the Java interpreter to 8MB, the recommended size for Pizza. Depending on your system, you might want to choose a different size.
   The file pizzadoc.BAT contains:

   java -ms8m pizza.compiler.Main -pizzadoc %1 %2 %3 %4 %5 %6 %7 %8 %9

   You should add a destination directory to it using -d directoryname.

6. You can now invoke the Pizza compiler with the command

   pc options sourcefiles

   Simply typing pc will give you a list of all available options. Source files should have extensions .java or .pizza. For source files ending in .java, only the Java subset of Pizza will be accepted unless the option -pizza is set.

7. Options you plan to use all the time may be included in the alias or .BAT file. It is usual to specify a fixed output directory for compiled classes with

   -d directoryname

   The output directory should be listed in your CLASSPATH. Frequently the output directory will be the one that also contains the pizza directory.