README.html
author paulson
Thu Mar 09 10:35:07 2000 +0100 (2000-03-09)
changeset 8385 514df4f1df10
parent 8068 72d783f7313a
child 8809 85539b33be03
permissions -rw-r--r--
updated discussion of compilers
wenzelm@3259
     1
wenzelm@3259
     2
<html>
wenzelm@3259
     3
wenzelm@3259
     4
<!-- $Id$ -->
wenzelm@3259
     5
wenzelm@3259
     6
<head>
wenzelm@3259
     7
<title>The Isabelle System Distribution</title>
wenzelm@3259
     8
</head>
wenzelm@3259
     9
wenzelm@3259
    10
<body>
wenzelm@3259
    11
wenzelm@3259
    12
<h1>The Isabelle System Distribution</h1>
wenzelm@3259
    13
wenzelm@3259
    14
<h2>Version information</h2>
wenzelm@3259
    15
wenzelm@6486
    16
This is the internal repository version of Isabelle.  The current line
wenzelm@7959
    17
of development introduces many new features, while attempting to keep
wenzelm@7959
    18
incompatibilities over Isabelle98-X at a minimum.  See the
wenzelm@7959
    19
<tt>NEWS</tt> file in the distribution for more details.
wenzelm@3259
    20
wenzelm@3259
    21
wenzelm@3259
    22
<h2>System requirements</h2>
wenzelm@3259
    23
wenzelm@3259
    24
Isabelle requires a real Unix box with sufficient resources. Fun
wenzelm@7959
    25
starts at about 32-64 MB of free main memory (somewhat depending on
wenzelm@7959
    26
your ML system), with several tens of MB disk space and a decent CPU.
wenzelm@6486
    27
Speaking by today's hardware standards, any moderate Linux box should
wenzelm@6486
    28
make a nice platform for Isabelle.
wenzelm@3259
    29
wenzelm@3259
    30
<p>
wenzelm@3259
    31
wenzelm@6077
    32
Furthermore, Isabelle needs the following software, which is not part
wenzelm@6077
    33
of the distribution:
wenzelm@3259
    34
<ul>
paulson@8385
    35
<li> A full Standard ML Compiler (e.g. Poly/ML).
wenzelm@3279
    36
<li> The GNU bash shell (version 1.x or 2.x).
wenzelm@5665
    37
<li> Perl 5.x - the Pathologically Eclectic Rubbish Lister (Perl 4.x
wenzelm@6077
    38
is <em>not</em> sufficient).
wenzelm@3259
    39
</ul>
wenzelm@3259
    40
wenzelm@3259
    41
<p>
wenzelm@3259
    42
wenzelm@3259
    43
The following ML system and platform combinations are known to work
wenzelm@6077
    44
very well:
wenzelm@3259
    45
<ul>
paulson@8385
    46
<li> Poly/ML 3.x on Linux and Suns.
wenzelm@6486
    47
<li> SML/NJ 110.x on any Unix platform (e.g. Linux, Suns).
wenzelm@3259
    48
<li> SML/NJ 0.93 on Suns and SGIs. There seem to be several
wenzelm@5665
    49
problems with Linux and HP-UX, though.
wenzelm@3259
    50
</ul>
wenzelm@3259
    51
paulson@8385
    52
<p> <A HREF="http://www.polyml.org/">Poly/ML</A>, previously a commercial
paulson@8385
    53
product, is back in the public domain.  It is the best compiler for running
paulson@8385
    54
Isabelle, requiring the least memory and offering the fastest performance.
wenzelm@3259
    55
paulson@8385
    56
<p> <a
wenzelm@4431
    57
href="http://cm.bell-labs.com/cm/cs/what/smlnj/software.html">SML/NJ</a>
wenzelm@4431
    58
needs lots of store and disk space, but it is free.  The current
wenzelm@6077
    59
official release is 110 (there is an <a
wenzelm@6077
    60
href="ftp://ftp.cl.cam.ac.uk/MIRRORED/smlnj/release/110/smlnj-110.0-3.i386.rpm">RPM
wenzelm@6077
    61
archive</a> available for Linux/x86).  We still support the old 0.93
paulson@8385
    62
release, but do not recommend it.
wenzelm@3259
    63
paulson@8385
    64
<p> MLWorks is a commercial ML programming environment developed by 
paulson@8385
    65
<a href="http://www.harlequin.com/">Harlequin</A> and was
paulson@8385
    66
unfortunately withdrawn after that company was taken over.  Isabelle on
paulson@8385
    67
MLWorks 2.0 works well.  It is about 20% faster than on SML/NJ while using
paulson@8385
    68
slightly less memory and disk space.  A few minor features (e.g. ML top-level
paulson@8385
    69
pretty printing) are not supported, though. 
wenzelm@5665
    70
wenzelm@3259
    71
wenzelm@3259
    72
wenzelm@3259
    73
<h2>Installation</h2>
wenzelm@3259
    74
wenzelm@6486
    75
Binary rpm packages are available for Isabelle/HOL and ZF on the
wenzelm@6486
    76
Linux/x86 platform.  Alternatively, the system may be built from
wenzelm@6486
    77
scratch as described in file <tt>INSTALL</tt> of the Isabelle sources.
wenzelm@6486
    78
Further background information may be found in the <em>Isabelle System
wenzelm@6486
    79
Manual</em>, distributed with the sources (directory <tt>doc</tt>).
wenzelm@3259
    80
wenzelm@3259
    81
oheimb@8068
    82
<h2>User interfaces</h2>
wenzelm@3306
    83
wenzelm@3306
    84
The distribution includes only a very primitive interface based on
oheimb@8068
    85
ordinary terminal sessions. Advanced interfaces are available from 
oheimb@8068
    86
other sources:
wenzelm@6077
    87
oheimb@8068
    88
<UL>
oheimb@8068
    89
<LI>
wenzelm@5534
    90
<a href="http://www.dcs.ed.ac.uk/home/da/Isamode/">Isamode</a> by
wenzelm@4481
    91
David Aspinall is a more elaborate interface for Isabelle.  It runs
wenzelm@5534
    92
under recent versions of XEmacs and is useful to both novices and
wenzelm@5534
    93
experts.
wenzelm@3306
    94
oheimb@8068
    95
<LI>
wenzelm@6077
    96
<a href="http://www.dcs.ed.ac.uk/home/proofgen/">Proof General</a> is
wenzelm@7483
    97
a generic Emacs interface for proof assistants, including Isabelle
wenzelm@7483
    98
(both for the classic and Isar version).  Proof General is suitable
wenzelm@7483
    99
for use by pacifists and Emacs militants alike. Its most prominent
wenzelm@7483
   100
feature is script management, providing a metaphor of <em>live proof
wenzelm@7483
   101
script editing</em>.
oheimb@8068
   102
</UL>
wenzelm@3306
   103
wenzelm@3259
   104
<h2>Other sources of information</h2>
wenzelm@3259
   105
wenzelm@3259
   106
<h3>Mailing list</h3>
wenzelm@3259
   107
oheimb@8068
   108
The electronic mailing list <TT>isabelle-users@cl.cam.ac.uk</TT>
wenzelm@3259
   109
provides a forum for Isabelle users to discuss problems and exchange
wenzelm@3259
   110
information. To join, send a message to
oheimb@8068
   111
<A HREF="mailto:isabelle-users-request@cl.cam.ac.uk">isabelle-users-request@cl.cam.ac.uk</A>.
wenzelm@3259
   112
wenzelm@3259
   113
wenzelm@3259
   114
<h3>Personal mail</h3>
wenzelm@3259
   115
wenzelm@3259
   116
<a href="http://www.cl.cam.ac.uk/users/lcp/">Lawrence C Paulson</a><br>
wenzelm@3259
   117
Computer Laboratory<br>
wenzelm@3259
   118
University of Cambridge<br>
wenzelm@3259
   119
Pembroke Street<br>
wenzelm@3259
   120
Cambridge CB2 3QG<br>
wenzelm@3259
   121
England<br>
wenzelm@3259
   122
<br>
oheimb@8068
   123
E-mail: <A HREF="mailto:lcp@cl.cam.ac.uk">lcp@cl.cam.ac.uk</A><br>
wenzelm@3259
   124
Phone: +44-223-334600<br>
wenzelm@3259
   125
Fax:   +44-223-334748<br>
wenzelm@3259
   126
wenzelm@3259
   127
<p>
wenzelm@3259
   128
or
wenzelm@3259
   129
<p>
wenzelm@3259
   130
wenzelm@5401
   131
<a href="http://www.in.tum.de/~nipkow/">Tobias Nipkow</a><br>
wenzelm@3259
   132
Institut fuer Informatik<br>
wenzelm@3259
   133
T. U. Muenchen<br>	
wenzelm@3259
   134
D-80290 Muenchen<br>
wenzelm@3259
   135
Germany<br>
wenzelm@3259
   136
<br>
oheimb@8068
   137
E-mail: <A HREF="mailto:nipkow@in.tum.de">nipkow@in.tum.de</A><br>
wenzelm@3259
   138
Phone: +49-89-289-22690<br>
wenzelm@3259
   139
Fax:   +49-89-289-28183<br>
wenzelm@3259
   140
wenzelm@3259
   141
<p>
wenzelm@3259
   142
wenzelm@3259
   143
<hr>
wenzelm@3259
   144
wenzelm@3259
   145
Please report any problems you encounter.  While we shall try to be
wenzelm@5665
   146
helpful, we can accept no responsibility for the deficiencies of
wenzelm@3259
   147
Isabelle and their consequences.
wenzelm@3259
   148
wenzelm@3259
   149
<hr>
wenzelm@3259
   150
wenzelm@3259
   151
</body>
wenzelm@3259
   152
</html>