-------------------------------------------------------------------------------
$Id: readme,v 1.1.1.1 1998/01/11 00:00:37 tp Exp $
-------------------------------------------------------------------------------
		       _  ______                     
		      | |/ / ___|___ _ __ ___  _   _ 
		      | ' / |   / _ \ '_ ` _ \| | | |
		      | . \ |__|  __/ | | | | | |_| |
		      |_|\_\____\___|_| |_| |_|\__,_|
                    ===================================

                          KC 85/4 Emulator V0.01

                      Copyright (c) 1997 Torsten Paul
			   Lommatzscher Str. 26
			      01139 Dresden
                        paul@os.inf.tu-dresden.de
			   All Rights Reserved

-------------------------------------------------------------------------------
				  README
-------------------------------------------------------------------------------
0. Contents

   1. COPYRIGHT
   2. What does this emulator emulate?
   3. Running the emulator
   4. Thanks

-------------------------------------------------------------------------------
1. COPYRIGHT

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

-------------------------------------------------------------------------------
2. What does this emulator emulate?

   This program is intended to emulate a KC85/4 Home Computer.

   Although there is much of the KC85/4 emulated it is more like a
   KC - Boulder Dash emulator because most other programs fail to
   work due to inaccurate emulation (especially of the keyboard).
   I hope I can fix this in the following releases...

-------------------------------------------------------------------------------
3. Running the emulator

   To run the emulator simply type kc85 at the command line. There are
   no command line options.
   Leaving the emulator is done by pressing the <PRINT SCREEN> or the
   <PAUSE> key.

   The emulator tries to load 5 files from the current directory:

	basic_c0.rom  (8192 byte) the basic rom starting at c000h
	caos__c0.rom  (4096 byte) the caos rom starting at c000h
	caos__e0.rom  (8192 byte) the caos rom starting at e000h

	I don't know what the copyright situation for those roms
	is. Anyway, you can safely use them if you own an original
	KC 85/4.

	bd_0400.prg  (12800 byte) the Boulder Dash program starting
				  at 0400h
	bd_4000.scr  (15808 byte) the Boulder Dash level descriptions
				  starting at 4000h

   The three *.rom files are obviously needed to run the emulator
   whereas the other ones are not really necessary. But the emulator
   is quite unusable without them because in this version there is
   no way to load any other files.
   Of cause you could write some BASIC programs, but you have to type
   them in every time you start the emulator ;-)

   When the emulator is running you can do a reset by pressing F10.
   F11 does a power on reset (but does not clear the memory for now).

-------------------------------------------------------------------------------
4. Thanks go to

    Marat Fayzullin for the portable Z80 processor emulation that is
    used in this emulator.

    DOS:
        Shawn Hargreaves for Allegro, the game programming library.

        Tran (a.k.a. Thomas Pytel) for writing the DPMI-server PMODE 3.07 and
	Matthias Grimrath for enhancing it for use with DJGPP (PMODE/DJ)

        DJ Delorie for the DJGPP 2.01 compiler and programming environment

-------------------------------------------------------------------------------
Have fun!

--
Torsten Paul
paul@os.inf.tu-dresden.de
