===================================================
Installation Notes for the Nominal Datatype Package
===================================================

The nominal datatype package is part of the development
snapshots of Isabelle. However, please download the 
nominal Isabelle snapshot from

    http://isabelle.in.tum.de/nominal/download.html

Unpack the sources in a suitable place, which in the 
following will be called [ISABELLE_HOME]. If you use
Isabelle for the first time, remember that you also 
have to install ProofGeneral and Emacs or XEmacs.
Instructions are given at

    http://www.cl.cam.ac.uk/research/hvg/Isabelle/installation.html

The building process for the nominal datatype package
needs to be started inside the [ISABELLE_HOME] directory 
with the command:

   ./build -m HOL-Nominal

The build can take 5 or more minutes. After the build 
completes, install the files with the command

   ./bin/isatool install -p /usr/local/bin

where -p /usr/local/bin is an option that refers to a 
directory in which executables are stored on your system 
(you might like to adapt this therefore).

The sources of the nominal datatype package can be 
found in the directory

    [ISABELLE_HOME]/src/HOL/Nominal

The examples are in

    [ISABELLE_HOME]/src/HOL/Nominal/Examples

===================================================
Starting Isabelle with the Nominal Datatype Package 
Preloaded
===================================================

Isabelle including the ProofGeneral interface can be 
started with

  Isabelle <<theory file you want to open>> &

This automatically loads the correct keyword file 
needed for the nominal datatype package and starts 
ProofGeneral. You can enable the option HOL-Nominal
in the menu "Isabelle -> Logics" in order to load
the pre-built heap of Isabelle that includes the
nominal package already. If not, the nominal theories
will be rechecked.

======================
Problems / Bugs / News
======================

If you encounter any problems or bugs, please let us 
know at the nominal mailing list to which you can
subscribe at

  https://mailmanbroy.informatik.tu-muenchen.de/mailman/listinfo/nominal-isabelle

We will also announce all updates there. 