IDE68K Readme.txt
==================

68000 Integrated Development Environment version 1.1.
-----------------------------------------------------
Thank you for your interest in "68000 Integrated Development
Environment", a program that integrates the entire process of
editing, compiling and/or assembling Assembly, C or Pascal
programs written for the 68000 microcomputer system and
running either on a built-in simulator or on an external 68000
microcomputer system connected to the PC through a serial port.

License agreement.
-----------------
This software is distributed as shareware. You are entitled to
use this software 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.

What has changed in version 1.1.
-------------------------------
Added menu-item "Project|New" (IDE).

Improved KEYHIT-handling (simulator).

Improved RS232 interface (terminal emulator).

Added setjmp() and longjmp() functions and ANSI variable argument
passing macros (standard C library).

Improved handling of syntax errors (C compiler).
Certain syntax errors introduced a NULL pointer in the parse tree.
Subsequent reads from this pointer (e.g. to determine the type of the
expression) caused an access violation which terminated not only the
compiler but the IDE itself. Most (hopefully all) syntax errors are
now properly handled.

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.

Installation.
------------
If you have installed a previous version of IDE68K, please remove
the program from the system before running Setup.exe to make 
certain that the old version is indeed overwritten with the new
version.

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 doing 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 68000 Assembly,
C or Pascal and are intended to 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:

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.

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.

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

Encrypt.asm
-----------
This program encrypts a string by means of a 2nd string, the "key".
It demonstrates the use of macros with ASM68K.

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

Limits.c
--------
This program can be compiled by loading limits.prj in the
"Project|Open project" menu. It main purpose is to test limits.h
and displays the maximimum values of char's, short's, int's and
long's both signed and unsigned.

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 68000 microcomputer board. As is turned
out, the simulator runs about two times faster than the real 68000
at 10 MHz.
(Well, that is, on a 450 MHz Pentium III PC).

Dhry.h, dhry_1.c and dhry_2.c
-----------------------------
These programs are the well-known dhrystone benchmark for compiler
and processor testing. They can be compiled by loading dhry.prj in
the "Project|Open project" menu. The program does nothing special,
it is just a mix of various C-language statements and expressions
with a distribution which represents an average C program. See also
dhry.h.
(The simulator runs at 1250 Dhrystones per second on a 450 MHz
Pentium III PC).

Vararg.c
--------
This is a C program to test passing of a variable number of 
arguments to a function using the ANSI-defined macros va_start,
va_list and va_end.

Testjmp.c
---------
This is a C program to test setjmp() and longjmp() functions.

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

Palindrome.pas
--------------
This is a Pascal program to find numbers whose squares are
palindromes, viz. numbers whose digits are identical from left to
right and vice versa. It is copied from an example in Jensen & Wirth,
PASCAL User manual and report. (3rd ed.).

DISCLAIMER.
----------
There are no warranties associated with this software. While I
believe this software product is reasonably bug free and well-behaved,
I am 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, please send E-mail to

   pfondse@mail.HZeeland.nl 

