----------------------------------------------------------------------
          isa-mode -- GNU Emacs support for Isabelle
----------------------------------------------------------------------

Files in this directory provide facilities for interacting with
Isabelle and editing theory files.

In outline, the facilities are:

 * Theory mode    -  for editing theory files
 * Isabelle mode  -  for interacting with Isabelle
 * Menus          -  including tactics and common proof commands 
 * Listener       -  a buffer for recording interactive proofs
 * Proof-State    -  a buffer which displays the current proof state
 * Rule-table     -  rule names for the current logic

Menus and mouse functions give Isabelle a primitive user-interface.
They only function in the latest versions of Emacs - FSF Emacs 19
or Lucid Emacs.

Follow the instructions below for configuring your environment to use
isa-mode.

Then visit a theory file or type:
 
     M-x isabelle            to start an Isabelle session, or
     M-x isa-menus           to show the Isabelle main menu.

See the file DOC.txt for more details.

Please tell me of any problems or suggestions (see also IDEAS.txt
and PROBLEMS.txt).

Have fun!

				 	  David Aspinall, Feb 1994.
					  (da@dcs.ed.ac.uk)
  

P.S. If isa-mode is not installed at your site, read INSTALL.txt now;
the instructions below will not work.



============================================================================


Add this line to your ~/.emacs file:

     (load "/usr/local/share/isabelle/emacs/isa-site")

This loads a short prelude which ensures that isa-mode will be loaded
automatically when a theory file is visited, or on running the
commands: M-x isabelle, M-x isa-menus, M-x isa-thy-mode.



You may also like to include the default X resources for 
Lucid GNU Emacs.  Either add

   xrdb -merge /usr/local/share/isabelle/emacs/Xdefaults-full

to your ~/.x11rc file, or add
 
   #include "/usr/local/share/isabelle/emacs/Xdefaults-full"

to your ~/.Xresources or ~/.Xdefaults-load file. 
(If you already have some defaults set for Lucid GNU Emacs, use
 Xdefaults instead)



By default, Isabelle under Poly/ML is selected.  If you want to use
Isabelle under SML of New Jersey instead (necessary for Solaris
machines), add these lines to ~/.emacs:

   (setq isa-ml-compiler 'NJ)

=============================================================================



