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