These files are used for constructing your MIPS pipeline simulator.
They are initially distributed as a .tar file called files.tar.
You should create a "sim" directory and "untar" them as follows:

mkdir sim
cd sim
cp /afs/cs.cmu.edu/academic/class/15740-f97/public/asst/asst2/files.tar .
tar xvf files.tar

You can compare your program to a (hopefully!) correct version installed
as:
   /afs/cs.cmu.edu/academic/class/15740-f97/public/sim/solve_tk

If you can't find this program, then it means it hasn't been
installed for your CPU type.  Contact Randy to get it installed.
[Standard Andrew CPU types only].  When you do so, provide the result of
executing the command "sys" on your chosen machine.

The files are as follows:

demos/*.O: Files used during the class demonstrations on pipelining
    Check them out!

tests/*.O: A set of (nonexhaustive) tests.  They are a good start,
    but you'll need to develop a more extensive test procedure.

exc/*.O: Files used during class demonstration on exception handling

mips.h: Defines the MIPS instruction format

pipe.h, sim.h, pipe.c sim.c: Implementation of simulation kernel and support

stages.c: This is the only file you will modify to fix the simulator

tkAppInit*.c, mips_tty.c, tk_support.c, mips_tk.tcl:
    Provide support for GUI and batch mode interface

mips_tk: A TCL/TK script that fires up the simulator.

Makefile: Used to compile the simulator.  Be sure to use it!  You should
    be able to compile your program by saying "make mips_tk".  See the
    notes below for machine-specific information.  You may want to edit
    your Makefile to automatically deal with the idiosyncracies of your
    machine.

README: This file

tk_version:
    A TCL/TK script used to determine which version of TK you have installed
    on your machine.  If you get compiler errors when compiling the
    default version of tkAppInit*.c, you should run this script
    and set the parameter TKVER in the Makefile accordingly.

MACHINE-SPECIFIC NOTES:

   Determine which version of TK you have with the script "tk_version."
   Use this to set the parameter TKVER in the Makefile.
	
   If you want to do your programming on a Wean Hall SGI,
   you'll need to either edit the Makefile or give command line arguments
   to make as follows:
	make mips_tk CC=cc XLIB=

   The x86 Linux machines require the parameters:
	make mips_tk XLIB=/usr/X11R6/lib/libX11.a TKVER=4.2


