iburg is available for anonymous ftp from ftp.cs.princeton.edu
(128.112.152.13) in pub/iburg.tar.Z or pub/iburg.zip. Both archives
contain the following files.

README		this file
COPYRIGHT	copyright notice
makefile	Make specification
iburg.c		source code for most of iburg
gram.y		YACC input for burg grammars
iburg.h		header file for iburg.c and gram.y
iburg.1		iburg man page
burg.ps		PostScript for
		C. W. Fraser, R. R. Henry and T. A. Proebsting,
		`BURG -- Fast optimal instruction selection and tree parsing,'
		SIGPLAN Notices 27, 4 (Apr. 1992), 68-76. 9 pages.
iburg.ps	PostScript for
		C. W. Fraser, D. R. Hanson and T. A. Proebsting,
		`Engineering a simple, efficient code generator generator,'
		ACM Letters on Programming Languages and Systems, 1993,
		to appear. 14 pages.
*.brg		test files


iburg is written in and generates ANSI C and thus must be compiled with
an ANSI C compiler and preprocessor, e.g., gcc or lcc.  To compile
iburg, type `make'.  There should be no warnings or errors.

sample.brg is from the paper in burg.ps, sample4.brg is from the paper
in iburg.ps, and sample5.brg is an example from a compilers course.
`make test' runs iburg on sample[45].brg and executes the resulting
programs. The output should be

% make test
iburg -I sample4.brg sample4.c; cc sample4.c; a.out
i = c + 4;
stmt: ASGNI(disp,reg)
 disp: ADDRLP
 reg: disp
  disp: ADDI(reg,con)
   reg: CVCI(INDIRC(disp))
    disp: ADDRLP
   con: CNSTI
iburg -I sample5.brg sample5.c; cc sample5.c; a.out
stm: MOVE(MEM(loc),reg)
 loc: NAME
 reg: PLUS(MEM(loc),reg)
  loc: PLUS(NAME,reg)
   reg: MEM(loc)
    loc: NAME
  reg: con
   con: CONST
%

To install iburg, copy it and its man page to the appropriate local
directories, e.g.,

	cp iburg /usr/local
	cp iburg.1 /usr/local/man/man1

`make clobber' removes all derived files, including iburg; `make clean'
removes just .o, core, and sample*.c files.

To be added to the iburg mailing list, which announces new versions,
etc., send your preferred email address to drh@cs.princeton.edu.

Mail bug reports along with the shortest input that exposes them to
drh@cs.princeton.edu.

1/30/93
