COCO OS-9 SOURCE PROJECT

This project was started some years ago by Boisy Pitre, and Alan DeKok.
The idea was to create a well documented repository of OS-9 Level One and
Level Two source code for the Color Computer.

That goal has largely been reached, though there are still modules that have
yet to be disassembled and properly commented.  Also, other source files
need additional commenting.

FILE ORGANIZATION
All source files contain the file extension '.asm'  The source files are
organized into their respective directories, with the topmost being:

	docs/         ..... OS-9 Documentation
	level1/       ..... OS-9 Level One V2 source
	level2/       ..... OS-9 Level Two V2 source
	level2v3/     ..... OS-9 Level Two V3 source
	nitros/       ..... NitrOS-9 source
	defs/         ..... OS-9 definition files
	3rdparty/     ..... Third party drivers, applications, etc.
	hosttools/    ..... Host (Linux) tools

The level1/, level2/, level2v3/ and nitros/ directories contain makefiles and
subdirectories for commands, modules and bootfiles.

DEFINITION FILES
The defs/ directory has definition files for the OS-9 packages.  Note that
these defs/ files are not intended for distribution disks, only for building
on the host.

	os9defs       ..... Defs files for all OS-9 packages
	systype       ..... System definitions for all OS-9 packages
	scfdefs       ..... SCF file manager defs
	rbfdefs       ..... RBF file manager defs
	vdgdefs       ..... VDGInt driver defs
	pipedefs      ..... PipeMan defs for level1/ and level2/
	pipedefs.l2v3 ..... PipeMan defs for level2v3/
	l51.defs      ..... Used by level2v3/
	l52.defs      ..... Used by level2v3/

BUILDING
The provided makefiles use the os9tools package, which can be found at
www.sourceforge.net, in order to assemble source files into binary modules.
Simply type 'make' at the project's root directory to assemble.