		Modifications to Doug Kwan's yae-0.5
		         $Revision: 1.2 $

Here are some modifications to the Apple ][ emulator for Unix/X11 by
Doug Kwan. Please see http://quark.netfront.net:6502/ for details of
the original version.

This version provides:
	+ support for FreeBSD 2.2.x, including sound
	+ a simple printer: PR#1 redirects output to stdout or a file
	+ a configuration file
	+ support for multiple floppy disk images

You can pick up a full copy of yae 0.5 with modifications at
ftp://minnie.cs.adfa.oz.au/incoming/yae-0.5wkt.tar.gz.

	Warren	wkt@cs.adfa.oz.au

FreeBSD Patches
---------------

Firstly, you will find the small changes to make yae run on FreeBSD 2.2.6
and 2.2.7: these are the CFLAGS, LIBS and LDFLAGS in the Makefile. The
#ifdefs in the file sound.c have been altered to allow the use of
/dev/audio on FreeBSD.

Printer
-------

I've added support for a simplistic printer in slot 1, by changing iou.c
and iou.h. At the BASIC prompt, PR#1 will redirect output to a file, the
default being stdout. CR characters are translated to NL characters.

Config File
-----------

I've also added a new file confile.c to support a configuration file for
yae called .yaerc. It can be either in the current directory, or the user's
home directory. Most of the command-line options, and some other internal
values, can be set in the configuration file.

yae's internal values are set as follows:

	+ default values are set inside the program
	+ any config file is read, and values there overwrite the defaults
	+ finally, any command-line arguments are read and used

The following source files have been modified: disk2.c, main.c, memory.c,
speed.c and yae.h.

I've supplied a sample .yaerc file which documents what values can be set
in the file. I'd like to add a `WriteBack' option to get yae to rewrite the
config file with the final values, just before yae shuts down. This would
capture, for example, the boot disk image specified on the command line.

I'm not very keen on the way I'm setting the default speed of the emulator
in confile.c and speed.c, so this needs to be improved.

Multiple Floppies
-----------------

Yae now supports two floppy disk images in slot 6 and two in slot 5. These
can be set either in the .yaerc config file, or on the command line. You can
have up to 4 disk images named on the command line, and these are processed
as S6D1, S6D2, S5D1, S5D2.

The F1 key only allows you to switch the boot disk, i.e S6D1. You can
manually switch a disk image using the Unix mv command, as long as you
are not currently `on' that disk, i.e the last DOS command was for
another disk.

Bug: if you try to access SXDY, but didn't name that disk in .yaerc or
on the command line, you get S6D1. I don't know how to fix this yet.
