PIZZA Current compiler version: 0.39e
A substantial companion to Java
Installation Guide

Contents
Home
Mirrors
FAQ

Distribution
Support
Documents

Applications
Users

People
Links

Current compiler version supporting Pizza 1.1: 0.39e from 22 May 1998 (this needs JDK 1.1 or higher).

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.


Installation notes by Martin Odersky.
Java is a trademark of Sun Microsystems.
Comments and bug reports to the Pizza Group, pizza@cis.unisa.edu.au.
All software and documents on the Pizza site are © Copyright 1996-1998 by the respective authors (as attributed on each; terms for redistribution are available).