Commodore 64 Emulator Version 0.3 Readme
(C) 1993-4 Earle F. Philhower III (st916w9r@dunx1.ocs.drexel.edu)

"It's beginning to look a whole lot slicker!" - Me
"Worth every penny I paid for it!  I'd buy a hundred copies!" - Bob

  (Also glance over the version 0.2, 0.1 readmes for more information)

************************************************************************
                     st916w9r@dunx1.ocs.drexel.edu

Please use my DREXEL.EDU email address, not my ge.com one.  I am back at
school now(co-op job's over) and any mail sent to the ge.com address
will be thrown down the bit bucket by the sysadmins.

                     st916w9r@dunx1.ocs.drexel.edu
************************************************************************

There is now only *one* executable for the emulator.  I have added a
preferences option to allow you to DYNAMICALLY change between color and
black-and-white, as well as other neat options.  It now needs 900K free,
but if you're only running in black-and-white you can safely run it from
a 768K memory partition.  (Of course you also need System 7.0+ to run it 
at all)

     Thanks to George T. Talbot, <ugtalbot@mcs.drexel.edu>, another Drexel
     student who took the time to convert the 6510 processor into hand-
     coded 68000 assembly!!  Currently it's only about a 20% speed increase
     over my old C code, but it's a great starting point.

One person that I forgot to credit in my last release was Werner Zsolt,
<mttto22@ursus.bke.hu>.  I used his program "t64tobin.pas" from the IBM
to figure out the format of T64 images.  Thanks Werner!

--------
Changes since v0.2:

    *** Hot Damn! ***  George T. Talbot has written a 68000 assembly 
    implementation of the synthetic processor.  It's about 20% faster!
    
    Color and Black-and-White display supported by one program.  You can
    now dynamically change between B/W (for speed) and color (for graphics)
    video displays!
    
    There is now a D64 directory listing window that allows you to view the
    files contained on a disk image, and the ability (via a double-click)
    to copy files from the D64 image to the Mac.

    Floppy disk image errors (i.e. short D64 files) no longer crash the
    entire Mac.  Instead the C64 is told of the error, and a error dialog
    is displayed.

    Preferences dialog has been implemented.  Allows you to switch between
    color and b/w video, to skip the KERNEL ram test (MUCH faster reset),
    to byte-align the video (which is significantly faster on 1-bit deep
    displays), and switch between my old C 6510 processor and G. Talbot's
    new assembly 6510 processor.  These settings are stored in a preferences
    file, in (duh) the Preferences folder.  [Very slick, if I say so myself.]
    
    My 6510 C code is now slightly faster, as it uses look-up tables for the
    BCD arithmetic instructions (from G. Talbot's code).
    
    Hard Drive interface has been fixed.  It should now work just like a
    1541 drive, without the "$" support or wildcards.
    
    Tons of little changes to the program structure to make the program
    easier to maintain.

---------
Commodore 64 -- Frequently Asked Questions (FAQ)

Q.  What's a "xxx.D64" or "xxx.T64" file?
A.  A *.D64 file is a binary image of a 1541 floppy disk.  To use it with the
    emulator, use "Attach Floppy Image" from the Devices menu.  Just use the
    regular "LOAD "xxxxx",8" commands in C64 BASIC to load any of the programs
    on the disk.  Enter "RUN <enter>" to make the program RUN after LOADing it.
    
    A *.T64 file is just a hacked copy of a C64 file.  In theory it supports
    storing multiple programs per image, but as of now 99.9% of the images are
    only holding one file.  To load a T64 file, select "Load Tape Image" from
    the Devices menu.  Then type "RUN" to make the program go.

Q.  How can I get 1541 disks from my Commodore to my Mac?
A1. You can't.  Use a PC with "disk64e" or "x1541" to transfer the files to a
    IBM format floppy, the use PC Exchange to copy the files from the IBM
    disk to your Mac.
A2. Use a RS232 converter from your C64's user port and a Null-Modem cable
    between the converter and the Mac.  *DO NOT CONNECT YOUR C64 TO YOUR MAC/PC
    WITHOUT AN RS232 CONVERTER.  YOU WILL DAMAGE YOUR C64 BY DOING SO!*

Q.  I want to do some work with your code.  What should I do if I want my
    changes to be inclued in one of your later C64 releases?
A.  I'm very open to changes/additions to my program.  In fact, almost 30% of
    the code is now from others.  If you've done some work send me some mail
    at Drexel, and *comment* any changes you make.  It'll make my work much
    easier!  And, of course, you've got to allow distribution of your changes
    unde the GNU GPL.

------------
User's Guide:

     See 0.2 - README for the User's Guide!

------------
How Can I Help?

  I now have the control codes for the MPS801 printer.  I've also got the
68000 code for the 6510 emulator.  Color's been done.  Now if only someone
would send me that 18 year old lingerie(sp?) model I've been asking for I'd
have a 1.0 release. <g>
  
  Seriously, if you recompile the program for the PPC I'd be interested in
any changes you had to make.

  I am also looking for some C64 logo scans to place in the splash screen.
Right now it's pretty ugly, and I don't have the time or the talent to draw
something a little prettier.  It's an easy way to get your name in on the
program docs!

------------
Credits:
(If I've forgotten you, drop me a line and I'll correct my oversight)

    68000 6510 Simulator:  George T. Talbot        <ugtalbot@mcs.drexel.edu>
    Color VIC Display:     Eric M. Stadtherr          <emstadth@iastate.edu>
    Major Testing:         Georg Schwarz   <georg@marie.physik.tu-berlin.de>
    Optimization, PPC:     Peter Creath              <peterc@gnu.ai.mit.edu>
    Tape Image Format:     Werner Zsolt               <mttto22@ursus.bke.hu>

------------
"Commodore 64 Emulator...
It's not much, but it's the *only* Commodore 64 you can run on your Mac!"

Any user suggestions, bug-fixes, updates please email me at Drexel Univ.
(st916w9r@dunx1.ocs.drexel.edu).  A 1.0 release doesn't seem to be too far
away, as most things are already implemented!

You can also get in contact with me on ISCA BBS [telnet whip.isca.uiowa.edu]
under the handle (suprise) "Earle."  I frequent the "Antique Computers" forum.

    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 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.

(C) 1993-4 Earle F. Philhower III (st916w9r@dunx1.ocs.drexel.edu)
