ReadMe for C:\ctools
December, 2008

ctools version 0.4

Copyright (c) 1995-1997 Jochen Metzinger, Schrammsweg 33 D, 20249
Hamburg/Germany <1metzing@informatik.uni-hamburg.de> All rights reserved

ctools is a public domain program to allow Unix and  MSDOS systems to read,
write and manipulate files on an c64/c128 CP/M disk image.

This archive contains the original distribution of ctools, and additional
documentation and an example of how ctools can be used with the vice
emulator. The environment is pre-configured for use under Windows XP.

Copyright
---------

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

Files:
------

C:\ctools\ctools - The standard distribution of ctools version 0.4. 

This is targetted more at programmers than at power users.

C:\ctools\DOC - The ctools "manpages" and additional docs.
C:\ctools\UTL - The ctools "binaries" (executables).
C:\ctools\x128 - An example of how ctools can be used.

The emulator disk images are targeted at the x128 Vice emulator for the 
C128. You must download this emulator yourself.

Vice http://www.viceteam.org/

Boot x128 with cpm128.d64 in drive 8 and load AZSAMPLE.D64 in drive 9. Both
drives 8 and 9 must be active and set to 1541's. When booting, run at warp 
speed and for most accurate results run x128 at 2x when in CP/M. 


Getting Started
---------------

Unzip the ZIP file(s) with directories intact onto the root of your C:
Drive. The Windows XP shortcut has been pre-configured to use this directory
structure.

Open the C:\ctools folder in MyComputer and click-on the shortcut. A cmd
window will open, and you will be in the C:\ctools directory which is the
parent directory for this environment. The required environment variables 
are set for you, and you can run these anywhere on your computer from this 
cmd window.

You must be somewhat familiar with DOS commands to use this environment. 
i.e. You must CD (Chdir) to each directory, etc.

You can also copy the XP shortcut that I have provided to your working
directory and set that as your startup directory to avoid much typing.


Other Notes
-----------

If you don't know what CP/M-80 was you didn't miss much because of the way
everything turned-out but should probably read the Wikipedia article for a
synopsis:

http://en.wikipedia.org/wiki/CP/M-80

OTOH without the assisted suicide of CP/M Microsoft arguably may not have
been the power that it is today... a point for discussion that makes little
difference now.

Another link especially if you think you have missed something is the 
Unofficial CP/M Web Site:

http://www.cpm.z80.de/

If you want to hear more about what I have say about CP/M on the C128 or
just on the C64 or C128 in general visit Lance Lyon's site and do a search
on me (buckels)

http://landover.no-ip.com/forums/index.php?action=forum

And finally visit my CP/M site if you are not fed-up yet:

http://www.cpm8680.com/


Have Fun!

Bill Buckels
bbuckels@mts.net
December 2008

End of Document