---------------------------------------------------------------------
 CLiCC: The Common Lisp to C Compiler
 Copyright (C) 1994 Wolfgang Goerigk, Ulrich Hoffmann, Heinz Knutzen
 Christian-Albrechts-Universitaet zu Kiel, Germany
---------------------------------------------------------------------
 CLiCC has been developed as part of the APPLY research project,
 funded by the German Ministry of Research and Technology.

 CLiCC is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or
 (at your option) any later version.

 CLiCC is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License in file COPYING for more details.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
------------------------------------------------------------------------------
 Funktion : README for the directory lib

 $Revision: 1.4 $
 $Id: README,v 1.4 1994/11/22 15:10:31 hk Exp $
-----------------------------------------------------------------------------

This directory contains files which are used for building executable
files from generated C files.
-----------------------------------------------------------------------------

The file c_decl.h is included by every generated C file and by the C
files in src/runtime/c which form the system module and which are part
of the lisp runtime system.

The file obrep1.h is included in c_decl.h by default. This file
determines the representation of Lisp data structures by means of C
data structures. We are experimenting with an alternative
representation which is defined in obrep2.h. The value of the
preprocessor constant __OBREP determines which file is included in
c_decl.h. obrep2.h may only be used with gcc, because it uses the
language extension __attribute__ ((aligned (8))).

The file sys.def describes the system module i.e. the part of the lisp
runtime system which is written in C.

The files makefile.cl and makefile.cl386 are used by the commands
bin/cl and bin/clg, which compile and link generated C files.

The other files in this directory are automatically generated:

sys.h contains the prototypes and variable declarations for the C
files in src/runtime/c. It is included by every generated C file and
by the C files in src/runtime/c. sys.h is generated by the command
bin/build-protos. You may extend this file manually, if you don't want
to use bin/build-protos.

The files lisp.syntax, lisp.def, lisp.h and inline.h are written into
the directory src/runtime/lisp2c, when the files lisp.lisp and
inline.lisp are compiled. They are copied to this directory when
the command bin/rt or bin/rtg is executed.

The file rtc.a is a library, which contains the files *.o of the
system module.

rtc-g.a is like rtc.a but with debugging information.

The file rtl.a is a library, which contains the files *.o of the
lisp and inline module.

rtl-g.a is like rtl.a but with debugging information.

The files main.o, main-g.o are the compilation result of
src/runtime/c/main.c. They contain the definition of the main
function, i.e the entry point for the linker.

The files initialize.o and initialize-g.o are built from
src/runtime/c/main too, but they are used to integrate a lisp module
into a C program.
ViewGit