With this README file you should also have found these:

Makefile :  A makefile for the COMP90045 project 2014

ast.c :     Defines Iz Abstract Syntax Trees in C; actually
            the bulk of definitions are in ast.h

ast.h :     Many possible design choices - this is just one
            possible way of defining the data structures that
            make up the ast

liz.l :     A lex specification for Iz

missing.h : A header file that makes up for bison shortcomings

piz.y :     A bison specification for Iz

pretty.c :  A pretty-printer - actually not really; for now
            this is just a stub

pretty.h :  A header file for pretty.c

std.h :     A header file with some standard C macros

wiz.c :     The driver program

To get started, study these files, in particular liz.l, ast.h, and piz.y. On a Unix machine you should be able to just type

make

and that should generate some files for you, including liz.c, piz.c, piz.h, and the executable wiz. (There will also be a file piz.output that may be useful for piz.y debugging later on.)

Write a small Iz test program, like this:

int k; read k;

Say this program is in file test.iz; now you should be able to run

wiz -p test.iz

and something will happen (actually nothing very interesting, because there is no real pretty-printer yet). But at least you should not get error messages.

If your Unix system doesn't seem to recognise `wiz', that could be because your PATH variable hasn't been set correctly. For now, just try instead

./wiz -p test.iz