README file for CCS64 1.09.1

This is the X11 port of the CCS64 Commodore 64 emulator.

CHANGES:

 From CCS64 1.09.0 to 1.09.1:
    User interface:
	Bug fixes:
	- Keyboard handler: complicated keyboard events involving modifier
	  keys now work properly

	New features:
	- User-selectable visuals and color depths

 From CCS64 1.08.0 to 1.09.0:
    User interface:
	Bug fixes:
	- Joystick emulation: port 1 was mapped to port 2 and port 2 to nowhere
	- Fixed some bugs in the default application resources

	New features:
	- PopupMenu action procedure

    Emulator engine:
	New features:
	- A function for freezing the 1541 state

 From CCS64 1.07.0 to 1.08.0:

    User interface:
	Bug fixes:
	- cached graphics output without MITSHM did not work properly
	  when the window was made smaller
	- save file did not close the files

	Improvements:
	- speed limit
	- pasting more text while pasting is in progress
	- FileChooser now preserves the path

	New features:
	- Mapped the 1541 drive LED to the keyboard (resource driveLed)
	- Added actions Toggle(), Enable(), Disable()
	  for modifying Boolean resources (removed resource keyPause)
	- Detects and automatically uncompresses compressed or gzipped
	  files (.prg.gz and .d64.gz) with the zlib library by Jean-loup
	  Gailly and Mark Adler

    Emulator engine:
	Improvements
	- Memory refresh should now be performed properly,
	  so the test programs "de00-de07" and "dadb" work now.

TO DO:
	Freezing the emulation state.  The current code in the emulator
	engine does not do this in a host-independent way, and it does not
	perform any consistency checks on the file.  Also, the file format
	has not been publicly described.

RELEASE NOTES:

CCS64 1.07.0 was my first attempt at writing an X Window System
application.  It took only two weeks of learning and coding, and
although the result could be even better, it is in my opinion much
better than the X versions of other Commodore 64 emulators.
Everything is configurable via resources.

For a true ugly Athena Widget feeling, use something like

	xrdb -load /dev/null

Other people than purists should load the supplied resources with e.g.

	xrdb -merge CCS64

You may want to append the file to your .Xresources or .Xdefaults file,
so that it will be loaded automatically.

As everything can be configured with resources, you can also make your
own translations of the user interface texts.  English and Finnish
versions of the texts are supplied as examples.	 You can find them in
the files CCS64-en and CCS64-fi, respectively.

If you install the CCS64* files to your app-defaults directory, you
can use the *customization resource to select the language, e.g. by
defining

	*customization: -fi

in your .Xresources file.

For more information about the X11 version of ccs64, see the manual page.

CCS64 and other Commodore emulators for the X Window System are available from

	<URL:http://www.funet.fi/pub/cbm/crossplatform/emulators/unix/>.


CREDITS:

The user interface of CCS64 was written from scratch by Marko Mkel.
The idea of nested Athena SimpleMenu widgets was taken from VICE, the
Versatile Commodore Emulator.

The file chooser widget is from the Free Widget Foundation library.

The zlib general purpose compression library is  1995-1996 by
Jean-loup Gailly and Mark Adler.

The CCS64 emulator engine was programmed by Per Hkan Sundell.	He has
chosen not to publish the source code, but the binary code may be
freely used in Unix versions of CCS64.
