-----------------------------------------------------------------------------
 Copyright (C) 1993 Christian-Albrechts-Universitaet zu Kiel, Germany
-----------------------------------------------------------------------------
 Projekt  : APPLY - A Practicable And Portable Lisp Implementation
            ------------------------------------------------------
 Funktion : README for the directory src/compiler

 $Revision: 1.2 $
 $Id: README,v 1.2 1993/06/18 13:23:34 hk Exp $
-----------------------------------------------------------------------------

This directory contains the Common LIsp to C Compiler (CLICC).
--------------------------------------------------------------

The file clcload.lisp is used to load CLICC into an interactive lisp
system. CLICC has been tested under Allegro-CL-4.1, Lucid-CL-4.0 and
CMU-CL-16d.

When you have loaded CLICC into an interactive lisp system, you should
type (compile-clicc) to get an compiled version of CLICC for your lisp
system.

Compilation of lisp applications to C
-------------------------------------
You must have installed the CLICC runtime system, see ../../INSTALL.
After loading the file clcload.lisp and compiling CLICC, switch to the
directory where you have placed your lisp application.  Type (clicc
"<name>"), where <name> is the name of the file which loads and starts
your application. If the compilation process is successful, you will
get files <name>.c and <name>.h.  These files have to be compiled by a
C compiler and linked with the CLICC runtime system.  This will be
done if you type cl <name> in a command shell. You will get a
executable file named <name>. See ../../bin for details.

CLICC may be configured by global variables and / or keyword
parameters in the call to the function clicc. Look at the definition
of clicc in file clcload.lisp and at the variable describtions in the
files clcdef.lisp and config.lisp.


Standalone version of CLICC
---------------------------
The file clicc.lisp will be used to compile CLICC by itself, which will
generate an standalone version of CLICC. This Program will be
controlled by command line arguments.
Currently this program is not executable due to minor bugs and its
runtime behaviour is bad because the dispatch mechanism for generic
funtion calls has to be improved.