      CLING (Common Lisp INGres interface)

CLING is a package that provides an inteface between Common LISP and the INGRES
database system.  CLING permits database commands to be executed from Common 
LISP programs.

All the files necessary for loading CLING are in this directory.
The following files should be present:

   READ_ME
   cling.cl
   cling.doc
   main.cl
   subs.cl
   macros.cl
   libq.c
   low.cl.lucid
   low.cl.franz

The file cling.doc contains the troff listings for generating a manual on
how to use CLING.  It uses the "me" macros.

CLING has been implemented for LUCID Common LISP and FRANZ Allegro Common
LISP.  Below are instructions for using CLING with each of these systems.


FRANZ Allegro Common LISP

To permit CLING to run on your FRANZ Allegro Common LISP, do the following:

1.  Rename the file low.cl.franz to low.cl.

2.  Edit the file low.cl so that the file references to the following files:

         foreign.fasl
	 libqlib    -->  These two are replaced
	 compatlib  -->  by libingres in v6

    are correct.

3.  Make sure that your path allows you to access ingres system commands.

4.  Compile the c language portion of CLING (the file libq.c) with

    cc -c libq.c

To load CLING into lisp, load the file cling.cl.


LUCID Common LISP

To run CLING on your LUCID Common LISP, do the following:

1.  Rename the file low.cl.lucid to low.cl.

2.  Edit the file low.cl so that the file references to the following files:

	 libqlib
	 compatlib

    are correct.

3.  Make sure that your path allows you to access ingres system commands.

4.  Compile the c language portion of CLING (the file libq.c with

          cc -c libq.c

To load CLING into LISP, load the file cling.cl.  Ignore any "multiply defined"
warning messages that may appear.

BUGS

With Lucid Common LISP, the "multiply defined" messages are caused by a 
problem with INGRES.  Use of the db-open function produces error messages.  
This is also caused by a bug in INGRES.  The newest version of INGRES should
correct both these problems.

Bug reports to 

	Jeff Sedayao
	Computer Science
	Evans Hall
	University of California
	Berkeley, CA 94720
	sedayao@postgres.berkeley.edu.
	..ucbvax!postgres!sedayao
