Read Me

---------------------------------------------------------------------
CoCoBoot - A Modern way to boot your Tandy Color Computer
Copyright(C) 2011 Brett M. Gordon beretta42@gmail.com

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
----------------------------------------------------------------------


CoCoBoot is an effort to modernize, and unify booting strategies for
the Tandy Color Computer.

Although this project in in the preliminary planning stage, there
several goals being developed:

1. Provide scripting to the end user to allow maximum flexability
   in creating new way to boot their CoCo.  This scripting ability
   will be provided by a token threaded FORTH compiler.

2. Allow one boot loader to impliment the various different ways a
   CoCo can boot: via the DOS, CLOADM, LOADM commands in BASIC, as
   well as BASIC's cartridge interrupt, and DECB's external ROM paths
   too.

3. Provide a new way of booting NitrOS-9 by replacing it's BOOT and
   REL modules.

4. Provide routines for accessing different disk-based hardware: FDC,
   SCSI, IDE, DriveWire, SD.


REQUIREMENTS to build this project:

ASxxxx - A cross-platform cross-assembler for various cpu's including
       m6809. See http://shop-pdp.kent.edu/ashtml/asxxxx.htm

ToolShed - Cross platform utilities for manipulating DECB and OS-9
	 disk images.  ToolShed also makes .wav files suitable for
	 CLOADM'ing binaries to your CoCo. See 
	 sourceforge.net/projects/toolshed/ 

make - Most likely any "make" will do

dd and cat - Standard unix utilities for blobbing files together.

objcopy - another unix "standard" for converting one binary file
	format to another - namely Motorola's S19 files to flat binary
	images


Thanks

Special thanks to William Astle for the re-write of the slz
decompression code.  Also thanks for Aaron for adding named object
support to DriveWire4.