**************************************************************************
*                                                                        *
*            em6502 - An X Based 6502 Emulator & Teaching Aid            *
*            ------------------------------------------------            *
*              (c) Neil Pollard, University of Bristol 1994              *
*                                                                        *
**************************************************************************

This is a final year project submitted in part fulfillment of the
requirements for the degree of BSc in Computer Science. The project is
protected by copyright. Do not copy this program for any purpose other than
personal academic study without seeking permission from the from Dr.Holyer in 
the Computer Science Department. (Mail the author, Neil Pollard, 
pollard@cs.bris.ac.uk for details).

OVERVIEW
--------

This program provides (near complete) emulation of an 8 bit 6502 processor
along with a monitor window for examining the internal state of the emulated
processor. It will run on a Unix workstation under X windows. Full user 
instructions will be made available in a separate file.

COMPILING THE PROGRAM
---------------------

If there is a specific Makefile for your machine (e.g. Makefile.linux), 
rename it to "Makefile". If not make any necessary adjustments to 
Makefile.generic and rename that instead.

Type "make depend" and then "make" (This may take some time).

Currently, the program expects an operating system and a small file called 
"dump" to be in the Images/ directory. The operating system "OS" is a 
file which is loaded into the top 16K of memory before startup.

The dump file may be needed by some operating systems. It is loaded into 
the bottom section of RAM. Even if you do not need the file, create an 
empty one by typing "touch Images/dump". See below for details on how to 
change the locations of these files.

The file ".6502rc" in the current directory specifies any paged 
ROM images to load on startup (typically languages). Each line should be a 
filename (The first entries will be loaded into 0xf, 0xe and so on).

Run the program by typing "em6502". No command line options for things 
such as the display are currently supported. The DISPLAY environment 
variable can be used, however.

Adjustments can be made to the source file em6502.h to vary the emulator 
screen update rate, the events rate (typically the keyboard) and other options.
The best settings will depend on your machine. Recompile using "make" for 
the changes to take effect.

If you wish to move the program executable (for example into /usr/local/bin),
you may also wish to change the file load.c and recompile using "make".
This file contains the locations of the "OS" and "dump" files.

Also see the file README.too for further info.
