
                        PORTABLE CLU 

		   *PRELIMINARY* RELEASE
		   ---------------------

                  Distribution of 9 July 1991

0 Installation
   See howto.install

1 Notes
   CLU is not licensed.  See ~CLU/COPYRIGHT for distribution information.

   If  you  have  problems with this distribution, you can call Dorothy Curtis 
at (617) 253-1945 to get help.  If you find bugs, please tell us
about   them,   either   in   writing   or   by   sending   network   mail   to
dcurtis@LCS.MIT.EDU.  We do  not  have  the time  or  the  staff  for 
"releases"; you will have to either FTP a new copy or request a distribution 
tape (for a fee)  periodically.    

   The CLU Reference Manual is currently  published  by  Springer-Verlag  as  a
monograph,  ISBN  0-387-91253-3 or ISBN 3-540-91253-3. Formerly it was in their
Lecture Notes in Computer Science series, Number  114.    The  manual  is  also
included  as  an  appendix to the book Abstraction and Specification in Program
Development by Barbara Liskov and John Guttag, published in  1986  by  The  MIT
Press (ISBN 0-262-12112-3) and McGraw-Hill (ISBN 0-07-037996-3).

   This release has been tested on DecStations running Ultrix 3.0, 3.1,
4.1, 4.2, Mips Workstations, and SparcStations.  This release also works
on Sony News Workstations thanks to Howard Wilkinson (howard@cohtech.co.uk).

2 Installation
   If you are installing a new version of the CLU  system,  you  should  backup
your current system onto tape before loading the new system over it.

   The  system  files  and  directories  are set up to live under a single root
directory, and most system programs will not work reasonably if the files  live
elsewhere.    (The  executable  files  in  the exe directory may live anywhere,
however).  There is some flexibility in where the CLU  root  directory  can  be
installed.  The possibilities (in the order searched) are

   1. the directory specified by the environment variable CLUHOME

   2. the home directory, as listed in /etc/passwd, of user name CLU

   3. /usr/local/lib/clu

   4. /usr/lib/clu

   5. /usr/clu

   Any such directory can, of course, be a symbolic link to the real directory.
In the file/directory names in this and other CLU documents, ~CLU  is  used  to
represent  the  CLU  root directory.  (In fact, this can be used within any CLU
program to refer to the root.)

   There is one tar file on the tape.  If you are using a tape device connected
directly  to  the Vax, you can extract the files by creating ~CLU, mounting the
tape, connecting to ~CLU, and issuing the command tar x

   See ~CLU/howto.install for installation information.

   If you want the executables in ~CLU/exe to live elsewhere, move them.


3 Bugs

There are several known bugs and I expect there are more: mail to
dcurtis@lcs.mit.edu.

4 Acknowledgements

Thanks go to Prof. Liskov & the designers of CLU, Digital Equipment Corporation
& Jim Horning for support for this project, to Sharon Perl for developing 
a clu-to-clu translator, to Mark Vandevoorde for using early verions of the 
compiler and improving the garbage collector, Hans Boehm & Mark Weiser for 
their conservative garbage collector, Prof. Guttag for encouragement,
Howard Wilkinson for sony news port.
