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.