
        Miracle C Compiler version 2.2
        Copyright 1989-99 bts

PLEASE READ THIS FILE CAREFULLY. MOST OF THE QUESTIONS I RECEIVE ARE
ANSWERED IN THIS SHORT TEXT FILE. AND... PLEASE REGISTER! THANK YOU.


REGISTRATION

The compiler is shareware, and is supplied  on a trial use basis. The
compiler package (including executables, function library and any other
object code) is copyright material and must not be modified or disassembled.
Programs written using the compiler may be freely distributed.

If you find it useful you should register. Registration costs US $25
(or equivalent in your local currency) and entitles you to receive the
SOURCE CODE to the compiler itself and free upgrades for one year, as well
as removing the reminder screens.

You may register online using your credit card at webpage;

	http://www.reg.net/product.asp?ID=3376

Registered users can obtain support and help by email;   bg283@ncf.ca
Thank you for registering Miracle C release 2.2!


INSTALLATION INSTRUCTIONS

Miracle C Workbench requires Microsoft Windows 3.1 or later (Win95/98/NT).
Please note that you must be a registered user to ask me for help in
setting up and using this compiler - see the section on Registration.

Create a new directory for the compiler on your hard drive (eg C:\MCW);

        C:\> md mcw
        C:\> cd mcw
        C:\MCW>

Extract the archive MIRACLE.ZIP into this directory using PKUNZIP or
a compatible unzip utility, recreating the directory structure;

        C:\MCW> pkunzip -d miracle.zip

This unpacks the compiler, library and example programs, and helpfiles.
It also creates a subdirectory INCLUDE containing header files, and
EXAMPLES containing sample programs. You should study the helpfiles and
sample programs to learn about the language and library features supported.

By default the compiler expects to be installed in directory C:\MCW but
should you wish to install it in another directory, you should choose
Options/Compiler and Options/Linker and change the specified directories.

Please Note that Run/Compile merely creates a .OBJ file; to create a .EXE
executable, you must issue Run/Build.


IMPORTANT: CHANGING THE DEFAULT COMMAND PIF FILE

If you run compiled programs from MCW, you should update your Windows
default program information file to uncheck "Close Window on Exit".
This PIF is called _DEFAULT.PIF (win3.1/winNT) or COMMAND.PIF (win95),
and is located in the windows main directory (usually C:\WINDOWS).
In win3.1 run PIFEDIT.EXE to update this file. In win95/NT, using Windows
Explorer select the PIF file, issue File/Properties, choose the Program
tab and unselect "Close Window on Exit". If you do not do this, then the
DOS box will close immediately when the program finishes.


IMPORTANT: MCW USES OLD-STYLE MSDOS 8.3 FILENAMES UNDER WIN95/98/NT

MCW is a 16-bit Windows application and as such uses the old-style MSDOS
8.3 filenames and directory names under Win95/Win98/WinNT. The corresponding
MSDOS name to your 32-bit Long Filename can be found in Windows Explorer
by right-mouse-button clicking on the file or directory, then choosing
Properties from the popup-menu.

For example, if you have installed MCW in directory  C:\Program Files\mcw
then in Options/Compiler and Opt/Linker you would specify  c:\progra~1\mcw\

If you do not set these directories correctly then MCW will be unable to
find header files, library files, etc. A safe bet is to put the compiler
in directory c:\mcw as described above.


DESCRIPTION

The Miracle C Compiler runs on a 386 PC (or better) and compiles traditional C
(Kernighan & Ritchie) with some ANSI language extensions. It generates object
code suitable for Microsoft or compatible linker (such a linker is builtin
to the Workbench, and automatically invoked during program build).

It is completely compatible with traditional C syntax and implements record
(struct/union) and enumerated data types, int, long and floating point types,
user type definition, bit fields in structs, and initializers for all types.
Both traditional and new (ANSI) function declaration is supported. There is a
comprehensive library of functions; some example programs and documentation
in Windows Helpfiles is supplied with the package.
