
       Installation of MIT Scheme 7.3 beta test on a Unix system

We will demonstrate the installation for HP 9000 series 400 computers.
The installation is essentially the same for other machines.

MIT Scheme is distributed as a compressed `tar' file.  The tar file
contains a single directory, called "dist-7.3", and that directory
contains subdirectories "bin", "etc", and "lib".  The "bin"
subdirectory contains two executable files, "scheme" and "bchscheme".
The "etc" subdirectory contains several files that are used during the
installation process.  The "lib" subdirectory contains several files
and subdirectories that Scheme uses while it is executing.

The goal of the installation is to put the executable files in a
directory where they will be executed as commands, and to put the
library files in some convenient place where Scheme can find them.

* First unpack the distribution:

     gzip -cd hp400.tar.gz | tar xvf -

  If you do not have the `gzip' program: we have built executables of
  this program for each of the machines that we support.  Either use
  the executable that we have already built, or else get the gzip
  sources (from us or from numerous other sources) and build it
  yourself.

* Next, go to the directory that you just unpacked:

     cd dist-7.3

The easiest way to install the files is to use the "install.sh" shell
script that we've provided in the distribution.  You will need to edit
that script to tell it where and how you want Scheme installed.  If
you want to do something more complicated, or if the script can't
easily be made to work for your system, use the script as a guide to
installation.

* The installation script normally uses the command "cp -pr" to copy
  the files from the distribution directory to their final locations.
  You can change this by editing the definition of the "install"
  variable in the "install.sh" shell script.

* The installation script may try to make some symbolic links during
  the installation.  This is normally done using the command "ln -s".
  If your system doesn't support symbolic links, or if you prefer to
  copy or hard-link files, change the definition of the "link"
  variable in the shell script.

* For many systems, a standard place to put executable files is the
  directory "/usr/local/bin".  If this is true for your system, we
  suggest installing the executables there.  Otherwise, you probably
  have some other directory that serves the same purpose; edit
  "install.sh" and change the definition of the shell variable
  "bindir" to be this other directory.

* Normally, MIT Scheme's auxiliary files are stored in the directory
  "/usr/local/lib/mit-scheme/".  If you can, we suggest that you
  create such a directory and install these files there.  Otherwise,
  create a directory somewhere else and edit the installation script
  to change the value of the variable "libdir" to be this directory.

* If you have GNU Emacs installed on your system, uncomment the
  definitions of the variables "infodir", "emacslisp", and "movemail"
  in the installation script.  You will also need to edit these
  definitions so that they correctly indicate where the GNU Emacs
  files are located.

* Once you are satisfied that the "install.sh" script is correct,
  execute it:

     ./install.sh

* After "install.sh" finishes, you can delete the "dist-7.3" directory
  that you unpacked earlier.

You should now be able to run MIT Scheme by typing

     scheme

at the command line (if you use the C shell, you may have to type
"rehash" before "scheme" will be recognized).
