Welcome to the Apple II Simulator!

In this file, i will discuss typical problems with the simulator.
Please read it carefully, if you can't get it to run.

Problem 1:
	The simulator says "can't find 'f800.rom" and exits.
Solution:
	You need a file named f800.rom in the current directory.
	It should contain the image of the F8-rom of your Apple.
	This rom holds the autostart monitor.
	Please look at the file DOWNLOADING.

Problem 2:
	The simulator says "can't find 'character.rom" and exits.
Solution:
	uudecode character.rom.uue

Problem 3:
	The simulator shows a window, but it is very small.
Solution:
	The simulator uses a 280x256 pixel window. If you want to have
	double size (and lower speed), look into screen.c, locate the line
		#define PIXSIZE 1
	and change it to
		#define PIXSIZE 2
	Type make install and try again.

Problem 4:
	The simulator says "can't find 'controller.rom" and exits.
Solution:
	You need a file named controller.rom in the current directory.
	It should contain the image of the controller-prom of your
	disk controller card.
	Please look at the file DOWNLOADING.

Problem 5:
	The simulator shows a window, it fills with inverse @, goes 
	blank (and leaves some @ in the lower right corner) but nothing
	else happens.
Solution:
	Start the simulator with the option -flush. Now you should see
	the usual APPLE ][ at the top of the screen.
	Send a 'kill -HUP' to the simulator process. If nothing happens,
	you need the files d000.rom, d800.rom, e000.rom, e800.rom
	and f000.rom. They should contain the images of the D0-rom,
	D8-rom, E0-rom, E8-rom and F0-rom of your Apple.
	This is the Applesoft Basic.
	Please look at the file DOWNLOADING.

Problem 6:
	Like Problem 5, but you are damn sure, that the roms are ok.
Solution:
	You probably have no disk or a wrong sort of disk image. Make sure,
	that the file named s6d1 contains (or is a link to a file with)
	a bootalble disk image. The simulator uses disk images of 143360
	byte size and with DOS 3.3 interleave.
	Send a 'kill -HUP' to the simulator process. If it shows the
	Applesoft prompt (a ']'), all else is ok.

	If you can't get a disk image but want to run the simulator anyway,
	edit the makefile to generate no controller in any slot.

Peter Koch (e-mail: koch@informatik.uni-kl.de)
