               	SEQUEL INSTALLATION INSTRUCTIONS
                ================================

Hello
=====

	Welcome to version 5.2 of the SEQUEL programming language.  
For a quick introduction to what SEQUEL is about print the intro.ps
file in DOC. 

What is SEQUEL?
===============

	SEQUEL is both a typed functional programming language with a Lisp 
platform and a powerful tool for the very high level specification of
theorem-provers and proof assistants.  With SEQUEL you will be able to 
generate efficient type-secure Lisp programs from source that is half the
length of the equivalent Lisp programs and build theorem provers in days 
rather than months.  If you are a Lisp programmer then SEQUEL will
drastically cut down your implementation time whatever the application.  

What SEQUEL Offers

* Optional Static Type-Checking
* An means of generating efficient Lisp programs from a language
  that is twice as compact as Lisp
* A tailored trace package for both function calls and type checking.
* Type Secure Lisp programs. 
* A very powerful means of generating proof assistants and theorem provers
  with very fast performance using WAM-derived compilation techniques.
* Automatically verified theorem provers
* An approach to logic derived from type theory
* Facility for Datalog and an occurs-check Horn-clause-to-Lisp
  compiler. 
* Mouse driven graphical interfaces for all proof assistants and theorem
  provers constructed under SEQUEL.
* A logic-independent theory of tactics.
* Backtracking within a functional paradigm
* Demos programs for several logics.

	SEQUEL is the subject of a book forthcoming in 1995 ('Functional
Programming & Automated Deduction in SEQUEL' (Wiley)).

What do I need to run SEQUEL?
=============================

	You need either Lucid Common Lisp v. 4.01 or Kyoto Common Lisp.  
The first costs money and the second is free under licence.

To install under Lucid

See the section 'Installing under Lucid'.
  
To install under Kyoto common Lisp

See the section 'Installing under KCL'.

Installing under Lucid
======================

	The Lucid version runs under SPARC workstations and builds to a 10Mb image.

	The Lucid version runs under graphics from the X-windows and ATHENA
Widgets libraries.  These are all public domain utilities, but Lucid is not
a public domain Lisp.  It takes at least 16Mb of free memory to run it 
comfortably. 

	You require Lucid Common Lisp version 4.01.  Enter LIB and type
'make windows.o'; then call up Lucid and type (load "install.lucid") 
and follow the instructions.

Installing under KCL
====================

	The KCL version has NO graphics.  However it is smaller (7 Mb)
than the Lucid versions and will sit comfortably on machines with less memory.

	To install;  go to LIB, enter KCL and type (load "install.kcl") and 
follow the instructions.  Remember to set *toplevel-directory* if you wish 
to use ~ to denote the top level.

	Note that when using the 'save-framework' command under KCL (see manual) 
the file thus created has to be edited by hand by replacing all occurences of |\|-|
by |-.

	KCL is much slower than Lucid in consulting frameworks.  Remember to be
patient sometimes!

Setting the Top Level Directory
===============================

	The demo programs that come with SEQUEL use pathnames containng
~ to automatically load in files.  You may need to inform SEQUEL what ~
means.

	The KCL version of SEQUEL does not understand ~ at all.
The Lucid version does and interprets it as referring to your home 
directory.  When loading the demo programs from some public area, 
it may be necessary to set  SEQUEL so that ~ is interpreted relative 
to the public area.

	Thus suppose that the SEQUEL directory lives in /usr/public and
you wish to load a demo program "~/SEQUEL/FRAMEWORKS/FOL/fol.fr".  
SEQUEL needs to be told that ~ refers to "/usr/public".  To do this 
type (set *toplevel-directory* "/usr/public") into the SEQUEL top
level.

First Steps
===========

	Once you are past the installation process, then you'll want to
do something interesting.  Try the following:-

sequel and RETURN 
<<type this to UNIX and wait till you get a (0-) prompt>>

(consult "~/SEQUEL/FRAMEWORKS/FOL/fol.fr") and RETURN 
<<wait a bit>>

(prooftool) and RETURN

	Now type (p => q) and RETURN.
        Now type (q => r) and RETURN
        Now type ok and RETURN

	Now type (p => (q => r)) and RETURN

	and play around with what comes up.  If you have loaded the graphics 
package under Lucid, a pop-up window will appear.  The Lucid version of SEQUEL 
comes with graphics.  It is likely that the KCL version will acquire graphics 
before the end of 1993.  

Using the Graphics
==================

Remember use the mouse to point and keep it in the proof tool window while 
conducting a proof.  Window is only active during the proof.

Left mouse button selects a element of a command.
Middle Mouse Button executes it.
Right Mouse Button produces pop-up help on selection. 
 
Finding Out More About SEQUEL
=============================

	The file manual.ps in DOC is the manual to SEQUEL. The file intro.ps 
is a copy of an IJCAI paper that gives an overview of SEQUEL and what it can do.  

Bugs
====

Report them to me (mark@uk.ac.leeds.scs.).  The bugs file contains the list of 
known bugs meaning that we are working on them.  updates contains the latest 
updates.

SEQUEL is Free for Academia
===========================

	No charge is made for educational purposes.  SEQUEL may not be used 
for commercial purposes without permission.  Read the copyright file.

SEQUEL News Letters 
===================

	SEQUEL news letters appear every month (approximately) informing you
of updates.  To put yourself on the list, e-mail mark@uk.ac.leeds.scs.

What Does 'SEQUEL' Stand For?
============================

	Actually nothing when I first implemented it.  But for lovers of
acronyms it can be thought of as short for SEQUEnt processing Language.

					       Mark Tarver
                                               mark@uk.ac.leeds.scs
