# Installation instructions

This chapter explains how to install Caml Light on your machine.

## The Unix version

Requirements:
  Any machine that runs under one of the various flavors of the Unix operating system, and that has a flat, non-segmented, 32-bit or 64-bit address space. 4M of RAM, 2M of free disk space. The graphics library requires X11 release 4 or later.

Installation:
  The Unix version is distributed in source format, as a compressed `tar` file named `cl74unix.tar.gz`. To extract, move to the directory where you want the source files to reside, transfer `cl74unix.tar.gz` to that directory, and execute

              zcat cl74unix.tar.gz | tar xBf -

  This extracts the source files in the current directory. The file `INSTALL` contains complete instructions on how to configure, compile and install Caml Light. Read it and follow the instructions.

Troubleshooting:
  See the file `INSTALL`.

## The Macintosh version

Requirements:
  Any Macintosh with at least 1M of RAM (2M is recommended), running System 6 or 7. About 850K of free space on the disk. The parts of the Caml Light system that support batch compilation currently require the Macintosh Programmer's Workshop (MPW) version 3.2. MPW is Apple's development environment, and it is distributed by APDA, Apple's Programmers and Developers Association. See the file `READ ME` in the distribution for APDA's address.

Installation:
  Create the folder where the Caml Light files will reside. Double-click on the file `cl74macbin.sea` from the distribution. This displays a file dialog box. Open the folder where the Caml Light files will reside, and click on the `Extract` button. This will re-create all files from the distribution in the Caml Light folder.

  To test the installation, double-click on the application `Caml Light`. The ``Caml Light output'' window should display something like

              >       Caml Light version 0.74

              #

  In the ``Caml Light input'' window, enter `1+2;;` and press the `Return` key. The ``Caml Light output'' window should display:

              >       Caml Light version 0.74

              #1+2;;
              - : int = 3
              #

  Select ``Quit'' from the ``File'' menu to return to the Finder.

  If you have MPW, you can install the batch compilation tools as follows. The tools and scripts from the `tools` folder must reside in a place where MPW will find them as commands. There are two ways to achieve this result: either copy the files in the `tools` folder to the `Tools` or the `Scripts` folder in your MPW folder; or keep the files in the `tools` folder and add the following line to your `UserStartup` file (assuming Caml Light resides in folder `Caml Light` on the disk named `My HD`):

              Set Commands "{Commands},My HD:Caml Light:tools:"

  In either case, you now have to edit the `camlc` script, and replace the string

              Macintosh HD:Caml Light:lib:

  (in the first line) with the actual pathname of the `lib` folder. For example, if you put Caml Light in folder `Caml Light` on the disk named `My HD`, the first line of `camlc` should read:

              Set stdlib "My HD:Caml Light:lib:"

Troubleshooting:

  Here is one commonly encountered problem.

  `Cannot find file stream.zi`
    (Displayed in the ``Caml Light output'' window, with an alert box telling you that Caml Light has terminated abnormally.) This is an installation error. The folder named `lib` in the distribution must always be in the same folder as the `Caml Light` application. It's OK to move the application to another folder; but remember to move the `lib` directory to the same folder. (To return to the Finder, first select ``Quit'' from the ``File'' menu.)

## The MS-Windows version

Requirements:
  A PC equipped with a 80386, 80486 or Pentium processor, running MS Windows 3.x, Windows 95 or Windows NT. About 3M of free space on the disk. At least 8M of RAM is recommended.

Installation:
  The MS-Windows version is distributed as a self-extracting, self-installing archive named `cl74win.exe`. Simply run it and follow the steps of the installation program.