Installing Common Music

1)  Restore Common Music sources to a directory at your site. Common Music 
is available free of charge by anonymous ftp on ccmra-ftp:/pub/cm.tar.Z
Installation scripts and documentation (including this file) are located in
the subdirectory cm/build/.

2a) If you are using PCL (a public domain version of the Common Lisp Object
System, read the section "Installing PCL" below.
 b) If you want to use Common Lisp Music (CLM) -- a music synthesis package developed by Bill Schottstaedt at CCRMA -- together with Common Music, see
the section "Installing CLM" below for further directions.

3)  Edit the file build/build.lisp. Read the introductory explanation and then
set the configuration parameters to values appropriate to your site.

4)  Start up a terminal and execute the build/buildcm command.  You will use
this script to both compile Common Music and to load and save the final
Common Music lisp image from its compiled binaries.  Note that buildcm will
not both compile sources and save an image file in a single execution. This
is because we want to save Common Music in as clean a state as possible,
without including any garbage created from the lengthly compilation process.
Therefore, when you install Common Music from scratch you will execute 
the buildcm script twice.  The first execution will compile the binary
files from the sources.  Ignore any warnings.  The second execution will load
Common Music from its binaries and save a lisp image.  You must specify the
base lisp image as an argument to buildcm.  For example, at ZKM I build
Common Music by typing:
	buildcm /lisp/cl/cl
or 
	buildcm /usr/local/bin/akcl
When buildcm has finished executing it will print an "All done!" message
and leave you back at the terminal. If the completed pass was used to compile
the sources, you can go ahead and immediately reexecute the buildcm script to
build the image file.  It takes a long time to compile or load Common Music.

Installing PCL

1) Common Music is known to work in versions "March 92 PCL (2c)" and 
"September 16 92 PCL (f)".  It probably won't work with earlier
versions, and if you use a PCL version other than the two listed, you
may have to edit the files common-music.lisp and stella/pkg.lisp and figure
out the pcl import statements yourself. You can get PCL from:

ma2s2.mathematik.uni-karlsruhe.de
	pub/lisp/clisp/packages/pcl.sept92f.clisp.tar.z   (CLISP)
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

2) Restore the PCL sources to an appropriate directory at your site.
If you are using AKCL or KCL on a NEXT with the PCL:

   2a) Edit the file "defsys.lisp", find the defvar for *pathname-extensions*
       and change the kcl conditional line:
		#+KCL                               ("lsp"   . "o")
       to
		#+KCL                               ("lisp"   . "o")
       This is because the PCL sources from CCRMA all end with "lisp", 
       and not "lsp".
   2b) Boot lisp and then compile and load thefile "defsys.lisp" in the
       PCL directory:
       > (compile-file "defsys.lisp")
       > (load "defsys.o")

If you are using Franz Common Lisp on a NeXT with PCL:

   2a) edit the file "defsys.lisp", find the defvar for *pathname-extensions*
       and replace the excl conditional line:
		#+(and excl m68k)                   ("cl"    . "m68k")
       with these two lines:
		#+(and excl m68k (not NeXT))        ("cl"    . "m68k")
		#+(and excl NeXT)                   ("lisp"  . "fasl")	 
   2b) Boot lisp and then compile and load the pcl file defsys.lisp
       in the pcl directory:
       <cl> :cl /pcl/defsys.lisp 

If you are using CLISP:

   2a) Boot lisp and load the pcl file "defsys.lsp" in the PCL directory:
       > (load "defsys.lisp")


3) After the file pcl/defsys.lisp been compiled and loaded, call the function
   (pcl::compile-pcl) to compile the entire PCL system.  This takes about 20 
   minutes. Ignore any warning messages.

4)  Exit Lisp, you are finished installing PCL.


Installing CLM

1)  Restore the CLM sources to an appropriate directory at your site.  CLM
is available free of charge by anonymous ftp from 
ccmra-ftp:/pub/clm.tar.Z

2)  Execute the script file clm-make located in the clm source directory.



