M68KIDE Readme.txt
==================

M68000 Integrated Development Environment.
-----------------------------------------
The  M68000 Integrated Development Environment is a tool that 
integrates the entire process of editing, compiling and/or assembling
Assembly, C or Pascal programs written for the M68000 microcomputer
system and running either on a built-in simulator or on an external
microcomputer system connected to the PC through a serial port.

System requirements.
-------------------
IDE68K is a 32-bit application. It runs on Windows 95/98 and
is believed to run on Windows NT 4.0 and Windows 2000 although
it is not (yet) tested in these platforms.

IDE68K is best run with a monitor-resolution of 800x600 or
better, the 80x25 character fixed-size window of the simulator/
terminal emulator is slightly too wide for the screen at 640x480
resolution.

License agreement.
-----------------
USE OF THIS SOFTWARE IS SUBJECT TO THE SOFTWARE LICENSE TERMS
INDICATED BELOW. USING THE SOFTWARE PRODUCT INDICATES YOUR
ACCEPTANCE OF THESE TERMS. IF YOU DO NOT ACCEPT THESE TERMS,
YOU MUST RETURN OR DELETE THE SOFTWARE IMMEDIATELY.	

This software is distributed as shareware. You are entitled to
use this software for 30 days for evaluation purposes. If you
want to continue to use this software product after the evaluation
period, you are required to register the software. 

You may give copies of the unregistered shareware version of this
software to others as long as no file is changed or omitted.
You may not sell, or lease this software.

If you are a registered user, you are entitled to use this software
product for your own use. Do not give away your personal registration
code.

For registration see the information from within the program, or
send mail to pfondse@mail.HZeeland.nl for additional details.

Installation.
------------
To install this program on your system, run Setup.exe from the
installation diskette. This program performs the installation,
all program files are included on the diskette. To create another
setup disk, you can simply copy all files to the target diskette.
The program can be uninstalled by selecting "Add/Remove Programs"
from the "Control Panel" and selecting "M68K IDE" from the listbox.
If you have used IDE68K, and doint so, added new files to the examples
directory, uninstall will not be able to remove all files in this
directory. For a complete uninstall you have to remove the IDE68K
directory and its contents yourself.

INSTALLED FILES.
----------------
In addition to the files in \Program Files\M68K IDE or whatever
directory you have installed the program, 68000 application programs
are also installed in directory IDE68K.

This directory contains the following files:

\IDE68K\LIB
---------------
This directory contains library files for the assembler and includes
the start-up files for the C- and Pascal compiler (SIM68K version),
compiler-helper files and files for the standard C-library, both in
C- and Assembly version. Do not change these files unless you know
what you are doing!

\IDE68K\INCLUDE
----------------------
This directory contains the header files used by the C compiler.

\IDE68K\EXAMPLES
----------------
This directory contains example files written in M68000 Assembly,
C or Pascal and are intended tho demonstrate what IDE68K and
its support programs can do. These files are also used to test
the system.

The following files are in this directory:

Histogram.asm
-------------
This program lets the user enter a string and then prints a
histogram of the number of times a character appears in the string.

Bounce.asm
----------
This program shows a bouncing ball (actually the cursor) bouncing
across the screen. Pressing any key will terminated the program.
The main purpose of the program is to demonstrate cursor movement
functions by means of ANSI escape-codes.

Tbi68k.asm
----------
This is a Tiny Basic interpreter written for the M68000 and adapted
to run on SIM68K. You can run 1975 BASIC programs on a Windows 2000
computer.
(Bill would love it!)

Hello.c
-------
This program can be compiled by loading hello.prj in the
"Project|Open project" menu. It displays the well-know string
"Hello, world!".

Sieve.c
-------
This is a C language version of Eratosthenes' sieve to find prime
numbers. Its main purpose is to check the execution speed of the
simulator versus a real M68000 microcomputer board. As is turned
out, the simulator runs about 5 times faster than the real 68000
at 10 MHz.
(Well, that is, on a 450 MHz Pentium III PC).

Colors.c
--------
This is a C program to demonstrate ANSI Escape sequences for color
setting. The program runs forever and can only be terminated by
resetting the simulator (Ctrl+Break).

Bonjour.pas
-----------
This is a simple Pascal program, similar to Hello.c

WARRANTY.
--------
Don't forget that there are no warranties associated with this
software. While we believe this software product is reasonably
bug free and well-behaved, we are in no way responsible if this
program does not work you would expect to work.

BUGS AND COMMENTS.
-----------------
If you have problems with this program, discover any bugs or just
want to give comments, do not hesistate to mail to

   pfondse@mail.HZeeland.nl 

or look at

   www.HZeeland.nl/~pfondse
