BEFORE USING, YOU MUST READ AND AGREE TO THE DOCUMENT LICENCE.TXT IN ITS
ENTIRETY OR REMOVE ALL OF THIS FROM YOUR COMPUTER NOW.

IT WOULD ALSO BE A GOOD IDEA FOR YOU TO REVIEW BUGS.TXT FOR KNOWN ISSUES WITH
WINDOWS XP AND TROUBLESHOOTING THESE ISSUES.

ReadMe for C:\AZCPM32d
March, 2008

Manx Aztec C86
Version 3.2d 
Developer System
for CP/M-86
Target: X86 Native Code

CP/M-86 development environment for 8086 and compatible computers 
Preconfigured for Windows XP

With samples.

This document is intended for expert developers and novices alike. 

Disclaimer and Conditions of Use

This compiler is Aztec C 8086 3.20d 7-18-85 (C) 1982,83,84,85 by Manx 
Software Systems, Inc. I cannot provide you with a legally licenced copy.

I herewith grant you a non-exclusive conditional licence to use any and all
of my work included with this compiler for whatever use you deem fit,
provided you do not take credit for my work, and that you leave my copyright
notices intact in all of it.

I believe everything I have written to be correct. Regardless, I, Bill
Buckels, do not guarantee, or warranty, in whole or in part, any of this,
and further do not offer support for any of this. All of this is provided
as-is. See licence.txt for further details.

BEFORE USING, YOU MUST READ AND AGREE TO THE DOCUMENT LICENCE.TXT IN ITS
ENTIRETY OR REMOVE ALL OF THIS FROM YOUR COMPUTER NOW.

Bill Buckels
bbuckels@mts.net

Introduction

This is a complete Aztec C build environment for Windows XP (MS-DOS) which
will enable you to produce X86 programs for use under CP/M-86. No support is 
provided for Windows programming and limited support is provided for
MS-DOS programming. 

The flavour of C that is used is not ANSI compliant. However I am pleased
to be able to provide the original documentation for this compiler.

This is very much a hybrid environment. 

I had problems using the original commands that came with the Aztec C CP/M-86
version 3.2d using the CPM86 emulator CPM.EXE by Jim Lopushinsky so I
replaced them with the equivalent commands from the Aztec C C-86 version 3.4b
to provide a Windows XP build environment for creating CP/M-86 .CMD programs.
In some of my MAKEFILEs for the sample programs that I have put in place I am
creating a DOS 2.0 .COM as well as a CPM .CMD I wanted to provide the option
of testing these programs under the XP cmd window with and without the
CPM.EXE emulator.

As I got further along I then discovered the AME86.EXE emulator by Jean-Marc
Lugrin, Digital Equipment Corporation. This emulator was originally written
for the DEC Rainbow and is reported not to work reliably under Windows XP but
it has worked almost flawlessly as far as I can see provided I use the
original commands to build my programs with.

It was Rüdiger Wilcken who also wrote the DOS version of AME86 that first
mentioned AME86 to me. Rüdiger's version works for him, and surprisingly did
not work reliably for me. So I went back to the DEC Rainbow version.

All 3 emulators are included for you to try. Obviously what works for some
will not work for others. In the interest of moving-on with my life I have
left this hybrid environment in place because I want it to work for you.

You can review the MAKEFILE's in the SAMPLES directories to see what it is I
am doing and run the demo.bat in each of the directories to see how these
emulators might work on your system.

Review the contents of each directory and their subdirectories for more
information. Always save a copy of your original directory if modifying or
building anything.

If you don't know what CP/M-86 was you didn't miss much because of the way
everything turned-out but should probably read the Wikipedia article for 
a synopsis:

http://en.wikipedia.org/wiki/CP/M-86

OTOH without the assisted suicide of CP/M Microsoft arguably may not have
been the power that it is today... a point for discussion that makes little
difference now.

Another link especially if you think you have missed something is the 
Unofficial CP/M Web Site:

http://www.cpm.z80.de/

Getting Started

Unzip the ZIP file(s) 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:\AZCPM32d folder in MyComputer and click-on the shortcut. A cmd
window will open, and you will be in the C:\AZCPM32d directory which is the
parent directory for this environment. The required environment variables to
build Aztec C 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 must CD (Chdir) to each programs build directory.

You can test the environment by building the programs in the SAMPLES
subdirectories. Each has its own MAKEFILE which will build the program simply
by typing "make" and pressing [ENTER] while in each's project directory under
SAMPLES.

You can even copy the XP shortcut that I have provided to your working
directory and set that as your startup directory to avoid much typing.

To recap, in any of the program build directories just type "Make" and press
enter to make any of the programs provided as samples. Provided you have
used the XP shortcut noted above, you should have no problems. Otherwise use
a DOS emulator like DOSBox in which case you will need to set-up your own
environment by modifying C:\AZCPM32d\AZTEC.BAT.

What You Will Need

All you need is the ability to write and compile programs in the C
programming language.

Review the various ReadMe files and source code in this environment for
additional notes. Or better yet, just build the sample programs and
experiment.

Have Fun!

Bill Buckels
bbuckels@mts.net
March 2008

(C) Copyright Bill Buckels 2008
All Rights Reserved.

End of Document