1 April 1995
	X64 V0.3 PL 0 -- CBM Emulator/Simulator For XWindows
	    With 6510/8500/8502 Simulator/Debugger


INTRODUCTION

  X64 is a Commodore 64/128 emulator for XWindow system.

 It provides a 6510/8500/8502 Simulator/Debugger

 If started with -asm option, x64 doesn't need the C64 ROMs, but having them
 helps a lot. See README (inside the archive) for more details.

 NOTE: Any ROM images are not included!
       The ROM images are NOT interchangeable.


PORTABLITY

  X64 successfully runs under X11 R5 and Openwindows 3.0 as well as
  Linux with XFree 2.1.


CONTENTS

  The x64 archive consists of C-sources for the following programs:
 
 x64    C64 emulator for X windows.
	Successfully runs under X11 R5 and Openwindows 3.0 as well as
	Linux with XFree 2.1.

 x128	C128 emulator for X windows.
	Basically it's just the 64 emulator with MMU bank switching and
	hard-coded shared RAM. No 80-col support yet.

 sun64  Another 64 emulator for Sparcstations.  (Not supported on 0.3.0)
	See the instructions in the beginning of sun64.c for more information.
	*** Be very careful with this. ***
 
 c1541  Disk drive emulator. In addition to operating in x64 the
	1541 emulator runs as separate program, by which disk images can be
	created and maintained. Supports PRG and SEQ file types and
	disk image <-> Un*x copying.
 
 petcat  converts text files and expands tokenized basic programs into
	readable 7-bit ascii, and tokenizes programs from program listings.
	For Unix and Atari ST.

  In addition to these programs the archive contains:

 64doc		   Full documentation of the 65xx/85xx instruction set.
 cbm_basic_tokens  List of all CBM Basic Keywords supported.


DISTRIBUTION

    Files:
	x64-0.3.0.tar.gz

	petcat-1.9.tar.gz
	 The Basic conversion utility only.

 The files should be soon available on the following FTP sites:

    wilbur.stanford.edu	   /pub/emulators/c64
    ftp.funet.fi	   /pub/cbm/c64/emulation


 The updated CPU documentation file "64doc" is also available via FTP on
 ftp.funet.fi in /pub/cbm/documents directory.


 Whenever you decide to release patches yourself, please change the
 PATCHLEVEL in patchlevel.h.


CHANGES FROM 0.2 PL 2

  If you've used X64 earlier, here are a few things to expect:
	C64 ROM and RAM images moved to C64 subdirectory
	C128 emulation
	Rechains BASIC programs after loading
	All command line options renamed
	New Xdebugger with X resource parser (using MIT Athena widgets)
	New and more portable readline
	Optional Emulator ID
	Joystick on Linux
	2 printers and 4 disk drives
	C1541 standalone is interactive
	Disk hexdump moved from monitor to c1541 standalone
	Code is now ANSI C; duplicate K&R declarations have been removed.
	Drastic changes in the internals


COPYRIGHT
     Copyright (c) 1993-1995  Jarkko Sonninen, Teemu Rantanen and
     Jouko Valta.

     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 of the License, or (at your option) any later ver-
     sion.


AUTHORS
  The original X64 code by:
      Jarkko Sonninen  (sonninen@lut.fi)
      Jouko Valta      (jopi@stekt.oulu.fi)
      Teemu Rantanen   (tvr@cs.hut.fi)

  Development and bug fixes by:
      Vesa-Matti Puro  (vmp@lut.fi)
      Hannu Helminen   (dm@stekt.oulu.fi)
      Richard Hable    (Richard.Hable@jk.uni-linz.ac.at)
      Frank Prindle    (Frank.Prindle@lambada.oit.unc.edu)
      Peter Weighill   (stuce@csv.warwick.ac.uk)
      Marko Makela     (msmakela@nic.funet.fi)
      Dan Miner        (dminer@nyx.cs.du.edu)
      Germano Caronni  (caronni@tik.ethz.ch)
      Dominique STRIGL (strigl@sxb.bsf.alcatel.fr)
      Craig Jackson    (Craig.Jackson@lambada.oit.unc.edu)
      Ulmer Lionel     (ulmer@poly.polytechnique.fr)
      Lasse Jyrkinen   (ljj@stekt.oulu.fi, Lasse.Jyrkinen@uz.kuleuven.ac.be)


 In case of problems you may write to me
	jopi@stekt.oulu.fi or jopi@zombie.oulu.fi