Installing Common Music

[cmlogo.gif]

Heinrich Taube
School of Music, University of Illinois
taube@uiuc.edu




Contents


Installing Sources

Transferring Source archives

Use your Web client or anonymous FTP in binary mode to transfer the source archives from:

Restoring Sources on Unix:

Use your Web client or transfer cm.tar.gz using binary FTP mode and restore the archived cm source folder.
% mv cm.tar.gz /usr/local/lisp
% cd /usr/local/lisp
% tar -zxf cm.tar.gz

Resoring Sources on Macintosh:

Transfer cm.sea.bin with your Web client, Fetch, or FTP in MacBinary mode. (If MacBinary mode is not possible, transfer in binary mode and then use the freely available MacBinary application to convert cm.sea.bin to the Mac application file cm.sea.) Double-click on cm.sea to restore the archive.

Realtime MIDI output from Common Music requires that the Opcode MIDI System first be installed.

Resoring Sources on Windows 95 and NT:

Use your Web client or transfer cm.zip using binary FTP mode. Use PKUNZIP to restore the archive:
MOVE CM.ZIP \LISP
CD \LISP
PKUNZIP -D CM.ZIP


Installing Binaries

Precompiled runtime versions of Common Music are available for Macintosh PPC, NT, Windows 95, IRIX and Linux. Unpack the archive and see the enclosed RELEASE file for further information.


Installing Patches

Patches for various Common Music releases are available for download from

See the README file in each directory for a description. To install a patch, simply place the file in the "patches" directory inside your cm (source or runtime) directory and restart the image.


Compiling in MCL (4.2, 3.3)

Common Music runs on all System 7 or higher Macintoshes with at least 6MB of RAM and 8 MB of hard disk storage.
  1. Realtime MIDI output from Common Music requires that the Opcode MIDI System first be installed.
  2. Read about the build parameters. Here is an example of what reasonable parameter settings might look like for a Mac:

    cm-directory                "HD:Lisp:CM:"
    cm-image-name               "HD:Lisp:CM:Common Music"
    syntaxes                    '(:MIDI :CSOUND)
    extensions                  nil
    save?                       t
    
  3. Start up Lisp and load cm:build:make-cm.lisp. The make-cm script will prompt you for whatever information it needs. Do not make Common Music in a Lisp image that already contains Common Music.
  4. Allocate at least a 6 MB heap size for the Common Music application. If the image contains CMN the heap should be at least 8 MB.

Compiling in ACL (3.1, 4.2, 5.0)

  1. Read about the build parameters. Here is an example of what reasonable parameter settings might look like on Linux for ACL5.0:
    cm-directory                "/usr/local/lisp/cm/"
    cm-image-name               "/usr/lisp/bin/cm.dxl"
    clm-directory               "/usr/local/lisp/clm/"
    cmn-directory               "/usr/local/lisp/cmn/"
    syntaxes                    '(:MIDI :CLM :CMN)
    extensions                  nil
    save?                       t
    
  2. Start up Lisp and load cm/build/make-cm.lisp. The make-cm script will prompt you for whatever information it needs. Do not make Common Music in a Lisp image that already contains Common Music.
  3. ACL 5.0 only: after saving the image, make a cm script to automatically boot Common Music. On my machine it would look something like:
    #!/bin/sh
    # cm script start acl 5.0 with the saved cm memory image
    exec /usr/local/lisp/acl5.0/lisp -I /usr/lisp/bin/cm.dxl
    
    then make the script executible by doing:
    chmod a+x cm
    
    Then simply type "cm" to start Common Music. The system will automatically look for "cminit.lisp" customization file in the "-I" directory you specified in the script.

Compiling in CLISP (Unix, Windows 95, NT)

Common Music has been tested in CLISP 1997-09-19 on NT and Linux.
  1. Read about the build parameters. Here is an example of what reasonable parameter settings might look like for DOS:

    [Note: The double backslash is necessary for DOS style pathnames in Lisp. However, CLISP 1997-09-19 also allows Unix style pathnames to be used in NT and WIN95]

    cm-directory                "c:\\cm\\"
    cm-image-name               "c:\\cm\\cm.mem"
    syntaxes                    '(:midi :csound)
    extensions                  nil
    save?                       t
    
  2. Start up Lisp and load CM\BUILD\MAKE-CM.LSP. The make-cm script will prompt you for whatever information it needs. Do not make Common Music in a Lisp image that already contains Common Music.
  3. Make a CM.BAT script that boots clisp using the saved image. It would look something like:
    c:\clisp\lisp.exe -M c:\cm\cm.mem %1 %2 %3 %4 %5 %6 %7 %8 %9
    

    About the Build Parameters

    When build/make-cm.lisp is loaded into lisp it prompts for the informtion it needs to compile, load and save Common Music. The settings you specify will be (optionally) saved in a site configuration file. This file can be used in subsequent builds to save the system exactly the way you specified.

    Experienced users can call make-cm directly with the build information specified as keyword arguments to the function. Here is an explanation of the build parameters:

    KEYWORD           DESCRIPTION                              DEFAULT VALUE
    
    cm-directory      Common Music source directory            <current directory>
    
    cm-image-name     The application file to build, if any.   <cm-directory>/cm
    
    site-directory    Directory for site customized files.     <cm-directory>/site
                      If you specify a directory other than
                      the default, you must move any scripts
                      from cm/site that you intend to use to
                      your personal site directory.
    
    bin-directory     Where to put the binaries if you don't    <cm-directory>
                      keep them with the sources.
    
    pcl-directory     If you use PCL (public domain CLOS),     NIL
                      set this variable to the PCL source
                      directory.  You must have compiled PCL
                      before building Common Music.
    
    clm-directory    If using CLM, set to the CLM source      NIL
                     directory, othwise NIL.
    
    clm-bin-directory   Set to CLM's binary directory,       <clm-directory>
                     defaults to clm-directory
    
    cmn-directory    If using CMN, set to the CMN source      NIL
                     directory, othwise NIL.
    
    cmn-bin-directory   Set to CMN's binary directory,       <cmn-directory>
                     defaults to clm-directory
    
    save?             If T, make-cm compiles sources and       :IF-NO-COMPILE
                      saves the cm application in one pass.
                      If :IF-NO-COMPILE, the build script
                      either compiles sources or loads the
                      binaries and saves the application if
                      no sources needed compilation.  If NIL,
                      make-cm script compiles/loads sources
                      but will not save an application.
                      The :IF-NO-COMPILE option results in the
                      smallest application size.
    syntaxes          The list of output syntaxes to build     '(:MIDI :CSOUND)
                      into Common Music.  Select any from:
    
                          :MIDI
                          :CLM
                          :CMN
                          :CSound
                          :MusicKit
                          :CMix
                          :CMusic
                          :RT
                          :SGIMix
    
                      The first syntax in the list becomes
                      the default syntax when the system
                      boots up.  You must load clm and cmn
                      before calling make-cm if you want cm
                      to build withto build with either the
                      :CLM or :CMN syntax.
    
    capella           Whether to include Capella or not.       T
                      [MCL only]
    
    extensions        Optional list of additional files to     NIL
                     load.
    
    

    ©MCMXCV by hkt@ccrma.stanford.edu Last Modified: 14-Aug-1998