This is the main README for Common Music. After reading this file, read:

if you use Macintosh with MCL:		README.MCL
if you use AKCL 6.15 on any machine:	README.AKCL 
if you use Windows with CL/PC:		README.WIN 
if you use Excl or Lispworks on SGI:	README.SGI
if you use CLISP on any machine:	README.CLISP
if you use DOS but not Windows:		README.WIN  (filename info)

The file build/README contains complete installation instructions for
Common Music, CLM and PCL.

The file changes.text contains a summary of the most recent enchancements
and bug fixes.

Documentation about Common Music is located in the subdirectory doc/.  

The tutorial is in stella/tutorial/stella.rtf.

Demo files are in stella/scripts and stella/examples/.

-------------------------------------------------------------------------------

Common Music is known to work in the following hardware/os/lisp configurations:

   Machine           OS               Lisps
   ----------------------------------------------------------
   NeXT              2.1,3.0          Franz ACL 3.1.2, 4.1
                                      AKCL 6.15
                                      CLISP
   Macintosh         System 7         MCL 2.0 (final release)
   SGI Iris          IRIX             Franz ACL 4.1
   Sun4              SunOS 4.1        AKCL 6.15
   486               Windows 3.1      Franz CL/PC
                     DOS              CLISP

-------------------------------------------------------------------------------

In addition to the source files located here, Common Music depends on two
lisp utilities which may or may not be provided by the lisp you are using.
The first of these utilities is the MIT or ANSI loop macro, which is widely
available and included in most lisp vendor's distribution software.  If you
are running in Allegro Common Lisp, MCL, Lucid or Symbolics your lisp 
distribution contains a copy of it.  If your lisp does not have the loop
macro, try the one in utils/loop.lisp.  The second utility you need is CLOS,
the Common Lisp Object System.  If your lisp does not contain CLOS, you may
use PCL, which is a portable public domain implementation available through 
anonymous ftp on
ftp.zkm.de
	pub/March-92-PCL-2c.tar.Z
parcftp.xerox.com:
	pub/pcl/September-16-92-PCL-f.tar.Z
ccrma-ftp.stanford.edu
	pub/Lisp/pcl.tar.Z
ma2s2.mathematik.uni-karlsruhe.de	   (CLISP)
	pub/lisp/clisp/packages/pcl.sept92f.clisp.tar.z

-------------------------------------------------------------------------------

Common Music directory structure:
   ./                - kernel
   build/            - build scripts. see build/README
   contrib/          - source files for extensions, tools, etc.
   doc/              - documention. see doc/README
   midi/             - source files for MIDI syntax
   midi/examples/    - example files for midi
   oldsys/           - old runtime system (defscorefile, etc)
   stella/           - composition editor
   stella/scripts/   - demo script files to load
   stella/tutorial/  - tutorial files 
   stella/examples/  - example files 
   stella/help       - long help files used by editor
   utils/            - external utilities used by Common Music

------------------------------------------------------------------------------

A mailing list cmdist@ccrma.stanford.edu has been established for
people interested in tracking Common Music, CLM and CMN. Send
request to cmdist-request@ccrma.stanford.edu

If you have any questions or comments please feel free to contact me:

Rick Taube
Zentrum fuer Kunst und Medientechnologie
Ritterstr. 42    7500 Karlsruhe 1    Germany
Net: hkt@zkm.de, hkt@ccrma.stanford.edu
Fax: +49 721 9340 39
Vox: +49 721 9340 300
