ReadMe for C:\Apple33

Revised May 27,2008

This is a "scaled-down" version of the Manx Aztec C65 Version 3.2b MS-DOS
cross-development environment for an Apple II running DOS 3.3.

It is targetted specifically at writing DOS 3.3 programs. It does not
provide support for Apple II's running ProDOS and it does not provide support
for Aztec C Pcode. Other than that, none of the run-time library functions
have been removed that were in the original distribution.

Programs are written and compiled on the IBM-PC and then moved to an Apple II
or to an emulator disk image to be run. (Emulator Diskimages of all the 
sample programs are provided for you as well.)

A modified Graphics link library is also provided which has been extended to
support the use of bit-mapped graphics images and sound routines, etc.

The build environment has been configured to run under Windows XP and a
pre-configured shortcut has been provided for this purpose as well as a make
utility program and some additional programs to be used in conjunction with
make.

Several sample programs are provided, each with its own MAKEFILE and each can
be reviewed for information on how to write your own DOS 3.3 C programs. I
have set-up each of these diskimages with a HELLO program. In DOS 3.3 Aztec
C programs are binary files which have a base address of 0800 and are loaded
and run using the BRUN command. You can review the HELLO program to see how
that is done.

Getting Started

Unzip the ZIP file with directories intact onto the root of your C: Drive. The
Windows XP shortcut has been pre-configured to use this directory structure.

Open the C:\Apple33 folder in MyComputer and click-on the shortcut. A cmd
window will open, and you will be in the C:\Apple33 directory which is the
parent directory for this environment. The required environment variables to
build Aztec C DOS 3.3 programs are set for you, and you can build these
anywhere on your computer from this cmd window.

You must be somewhat familiar with DOS commands to use this build environment.

You can test the environment by building the programs in the SAMPLES
and PROJECTS subdirectory.

Each has its own MAKEFILE which will build a DOS 3.3 program simply by
typing "make" and pressing [ENTER] while in each's project directory under
SAMPLES (or PROJECTS).

What You Will Need

You can write your own programs in notepad or your favorite programmer's
editor. This environment doesn't provide an editor.

You should get a copy of the Aztec C Manual which is available online at 

http://www.clipshop.ca/Aztec/cat1.htm and http://www.clipshop.ca/Aztec/cat2.htm

This will provide you with the original text of the printed manual for the C65
compiler and considerably more information than the SAMPLES that are included
in this environment.

You will also need an Apple II emulator like Apple II Oasis that provides a
Disk Manager unless you have a real Apple II.

If you wish to create full-screen bitmapped graphics for the Apple II you may
wish to download the ClipShop program from the following link:

http://www.clipshop.ca

Other than that, all you need is the ability to write and compile programs in
the C programming language. Aztec predates ANSI and ISO C. You will need to
use Kernighan and Ritchie prototypes and syntax which is no hardship and 
good experience as well. The point is that your programs will be properly
organized and run quite well. The downside is that they will take longer to
load than BASIC programs.

Provided as is!

Bill Buckels
May 2008

End of Document