
       Installation of MIT Scheme 7.3 beta test on a Unix system

We will use as an example the installation for HP 9000 series 400
computers.  The installation for other Unix systems is similar.

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 script assumes there is no pre-existing installation of MIT
  Scheme on your system.  If there is, you may need to edit the script,
  or delete the existing version (particularly the contents of
  /usr/local/lib/mit-scheme, see the later note on editing 'libdir').
  If you have trouble deleting the binary because it is in use, try
  renaming it to 'scheme.busy' and deleting it later.

* 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.  Some versions of "cp" do
  not support the "p" option; using simply "cp -r" in this case is
  acceptable.  Note that most versions of "mv" require the source and
  destination to be on the same physical device.

* 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).
