RELEASE NOTES FOR MACHSUIF
		      --------------------------

This is version 1.3.0 of the machsuif package from the HUBE research
group at Harvard University.  It is based on basesuif-1.3.0.5 from the
Stanford SUIF group.  This package should compile under gcc/g++ version
2.8.1.  We regularly compile this package on Digital Unix 4.0 and 5.0 on
Alphas and on Linux/Intel platforms.

This release contains code generators for alpha-dec-osf and
i386-*-<unix> targets.  (The latter has only been lightly exercised,
however.)  It also contains machine library placeholders for
mips-dec-ultrix and ppc-*-<unix> machines.  We plan to maintain and
upgrade the Alpha and x86 code generators, but not those for MIPS or
PowerPC.

-----

*** COMMON BENCHMARKS

The following results are for an Alpha compilation under Digital Unix
versions 3.2 and 4.0 (used agen/aexp/raga/afin/aexp backend).  The
resulting assembly language file was compiled by the native cc
compiler.  No optimization was done under scc or under cc (e.g. no
oynk passes).

Benchmarks that compile and run successfully:

  Silly-little-ones:	hello_world.c, wc.c

  multiflow-c/cfe:	<all but those listed below>

  Others:		gzip, mpeg_play, sort

  SPECint92:		008.espresso, 022.li, 023.eqntott, 026.compress

  SPECfp92:		015.doduc, 034.mdljdp2, 039.wave5, 047.tomcatv,
			048.ora, 052.alvinn, 056.ear, 077.mdljsp2,
			078.swm256, 089.su2cor, 090.hydro2d, 093.nasa7,
			094.fpppp

  SPECint95:		099.go, 124.m88ksim, 126.gcc, 129.compress, 130.li,
			132.ijpeg, 134.perl, 147.vortex

Benchmarks known to fail:

  multiflow-c/cfe:
	cfe_019.c, cfe_025.c	-- uninitialized variables in program
	cfe_029.c		-- snoot problem with early increment
	cfe_048.c		-- snoot problem with multiple definitions
				   for a single program variable
	cfe_077.c		-- snoot problem with overly big
				   initializer value
	cfe_081.c		-- machine library problem--some assemblers
				   have trouble with large positive decimal
				   immediates whose 2's complement
				   representation sets the most-significant
				   bit.  The machine library should print
				   these values in hex, but it's not easy
				   given that the values are strings in
				   SUIF.

  SPECfp92:
	013.spice2g6		-- program casts a pointer to an int
				   and then back to a pointer.  This does
				   not work under SUIF on a 64-bit machine.

				   
Benchmarks that have not been tested yet:

  SPECint92:
	072.sc
	085.gcc

  SPECfp95:
	all of them