README.html
author wenzelm
Sun, 15 Oct 2000 19:50:35 +0200
changeset 10220 2a726de6e124
parent 10079 0d78784176f4
child 11066 ceab8d437b96
permissions -rw-r--r--
proper symbol markup with \isamath, \isatext; support sub/super scripts:
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
     1
<html>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
     2
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
     3
<!-- $Id$ -->
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
     4
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
     5
<head>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
     6
<title>The Isabelle System Distribution</title>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
     7
</head>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
     8
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
     9
<body>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    10
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    11
<h1>The Isabelle System Distribution</h1>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    12
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    13
<h2>Version information</h2>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    14
6486
wenzelm
parents: 6125
diff changeset
    15
This is the internal repository version of Isabelle.  The current line
9927
wenzelm
parents: 9406
diff changeset
    16
of Isabelle99 development introduces many new concepts, while
wenzelm
parents: 9406
diff changeset
    17
attempting to keep incompatibilities over Isabelle98 at a minimum.
wenzelm
parents: 9406
diff changeset
    18
See the <tt>NEWS</tt> file in the distribution for more details.
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    19
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    20
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    21
<h2>System requirements</h2>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    22
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    23
Isabelle requires a real Unix box with sufficient resources. Fun
7959
wenzelm
parents: 7483
diff changeset
    24
starts at about 32-64 MB of free main memory (somewhat depending on
9927
wenzelm
parents: 9406
diff changeset
    25
the ML system), with several tens of MB disk space and a decent CPU.
6486
wenzelm
parents: 6125
diff changeset
    26
Speaking by today's hardware standards, any moderate Linux box should
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    27
give a very nice platform for Isabelle.
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    28
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    29
<p>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    30
6077
60d97d521453 tuned, updated;
wenzelm
parents: 5708
diff changeset
    31
Furthermore, Isabelle needs the following software, which is not part
60d97d521453 tuned, updated;
wenzelm
parents: 5708
diff changeset
    32
of the distribution:
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    33
<ul>
8385
514df4f1df10 updated discussion of compilers
paulson
parents: 8068
diff changeset
    34
<li> A full Standard ML Compiler (e.g. Poly/ML).
3279
815ef5848324 tuned all READMEs;
wenzelm
parents: 3274
diff changeset
    35
<li> The GNU bash shell (version 1.x or 2.x).
5665
1dc74203b1d2 updated, tuned;
wenzelm
parents: 5534
diff changeset
    36
<li> Perl 5.x - the Pathologically Eclectic Rubbish Lister (Perl 4.x
6077
60d97d521453 tuned, updated;
wenzelm
parents: 5708
diff changeset
    37
is <em>not</em> sufficient).
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    38
</ul>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    39
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    40
<p>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    41
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    42
The following ML system and platform combinations are known to work
6077
60d97d521453 tuned, updated;
wenzelm
parents: 5708
diff changeset
    43
very well:
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    44
<ul>
9927
wenzelm
parents: 9406
diff changeset
    45
<li> Poly/ML 3.x on Linux/x86 and Solaris/Sparc.
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    46
<li> SML/NJ 110.x on any Unix platform (Linux, Suns, SGI etc.).
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    47
</ul>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    48
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    49
<p> <a href="http://www.polyml.org/">Poly/ML</a>, previously a
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    50
commercial product, is back in the free world.  It is by far the best
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    51
compiler for running Isabelle, requiring the least memory and offering
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    52
the highest performance.
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    53
8385
514df4f1df10 updated discussion of compilers
paulson
parents: 8068
diff changeset
    54
<p> <a
4431
22f31e6e5aad added MLWorks;
wenzelm
parents: 4414
diff changeset
    55
href="http://cm.bell-labs.com/cm/cs/what/smlnj/software.html">SML/NJ</a>
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    56
needs lots of store and disk space, but supports many more platforms.
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    57
The current official release is 110.  Basically, we still support the
9406
wenzelm
parents: 8809
diff changeset
    58
old 0.93 release, but do not recommend to use it under normal
wenzelm
parents: 8809
diff changeset
    59
circumstances.
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    60
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    61
<p> MLWorks is a commercial ML programming environment developed by <a
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    62
href="http://www.harlequin.com/">Harlequin</a> and was unfortunately
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    63
withdrawn after that company was taken over.  Isabelle on MLWorks 2.0
9406
wenzelm
parents: 8809
diff changeset
    64
works reasonably well.  It is about 20% faster than on SML/NJ while
wenzelm
parents: 8809
diff changeset
    65
using slightly less memory and disk space.  A few features (e.g. ML
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    66
top-level pretty printing) are not supported, though.
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    67
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    68
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    69
<h2>Installation</h2>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    70
9927
wenzelm
parents: 9406
diff changeset
    71
Binary packages are available for Isabelle/HOL and ZF on the Linux/x86
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    72
platform.  The system may be easily built from scratch as well, taking
9927
wenzelm
parents: 9406
diff changeset
    73
the traditional tar.gz source distribution.  See file <tt>INSTALL</tt>
wenzelm
parents: 9406
diff changeset
    74
as distributed with Isabelle for more information.
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    75
6486
wenzelm
parents: 6125
diff changeset
    76
Further background information may be found in the <em>Isabelle System
wenzelm
parents: 6125
diff changeset
    77
Manual</em>, distributed with the sources (directory <tt>doc</tt>).
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    78
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
    79
9927
wenzelm
parents: 9406
diff changeset
    80
<h2>User interface</h2>
6077
60d97d521453 tuned, updated;
wenzelm
parents: 5708
diff changeset
    81
9927
wenzelm
parents: 9406
diff changeset
    82
The canonical Isabelle user interface is <a
10079
0d78784176f4 www.proofgeneral.org;
wenzelm
parents: 9927
diff changeset
    83
href="http://www.proofgeneral.org">Proof General</a> by David Aspinall
0d78784176f4 www.proofgeneral.org;
wenzelm
parents: 9927
diff changeset
    84
and others.  It is a generic (X)Emacs interface for proof assistants,
0d78784176f4 www.proofgeneral.org;
wenzelm
parents: 9927
diff changeset
    85
including Isabelle (both for the classic and Isar version).  Proof
0d78784176f4 www.proofgeneral.org;
wenzelm
parents: 9927
diff changeset
    86
General is suitable for use by pacifists and Emacs militants
0d78784176f4 www.proofgeneral.org;
wenzelm
parents: 9927
diff changeset
    87
alike. Its most prominent feature is script management, providing a
0d78784176f4 www.proofgeneral.org;
wenzelm
parents: 9927
diff changeset
    88
metaphor of <em>live proof script editing</em>.  Proof General has
0d78784176f4 www.proofgeneral.org;
wenzelm
parents: 9927
diff changeset
    89
recently gained a rather large following of both beginning and expert
0d78784176f4 www.proofgeneral.org;
wenzelm
parents: 9927
diff changeset
    90
users of Isabelle.
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    91
9927
wenzelm
parents: 9406
diff changeset
    92
<p>
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    93
9927
wenzelm
parents: 9406
diff changeset
    94
Proof~General may be used together with the Emacs
wenzelm
parents: 9406
diff changeset
    95
<a href="http://www.fmi.uni-passau.de/~wedler/x-symbol/">
wenzelm
parents: 9406
diff changeset
    96
X-Symbol package</a>, which provides a nice way to get proper
wenzelm
parents: 9406
diff changeset
    97
mathematical symbols displayed on screen.
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
    98
3306
13d955a405f3 added href to Isamode;
wenzelm
parents: 3279
diff changeset
    99
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   100
<h2>Other sources of information</h2>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   101
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   102
<h3>The Isabelle Page</h3>
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   103
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   104
The Isabelle home page may be accessed both from Cambridge and Munich:
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   105
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   106
<ul>
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   107
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   108
<li> <a
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   109
href="http://www.cl.cam.ac.uk/Research/HVG/Isabelle/">http://www.cl.cam.ac.uk/Research/HVG/Isabelle/</a>
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   110
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   111
<li> <a href="http://isabelle.in.tum.de">http://isabelle.in.tum.de</a>
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   112
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   113
</ul>
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   114
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   115
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   116
<h3>Mailing list</h3>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   117
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   118
The electronic mailing list <tt>isabelle-users@cl.cam.ac.uk</tt>
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   119
provides a forum for Isabelle users to discuss problems and exchange
8809
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   120
information. To join, send a message to <a
85539b33be03 updated;
wenzelm
parents: 8385
diff changeset
   121
href="mailto:isabelle-users-request@cl.cam.ac.uk">isabelle-users-request@cl.cam.ac.uk</a>.
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   122
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   123
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   124
<h3>Personal mail</h3>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   125
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   126
<a href="http://www.cl.cam.ac.uk/users/lcp/">Lawrence C Paulson</a><br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   127
Computer Laboratory<br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   128
University of Cambridge<br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   129
Pembroke Street<br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   130
Cambridge CB2 3QG<br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   131
England<br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   132
<br>
8068
72d783f7313a corrected, improved eMail addresses, user interface section
oheimb
parents: 7959
diff changeset
   133
E-mail: <A HREF="mailto:lcp@cl.cam.ac.uk">lcp@cl.cam.ac.uk</A><br>
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   134
Phone: +44-223-334600<br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   135
Fax:   +44-223-334748<br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   136
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   137
<p>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   138
or
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   139
<p>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   140
5401
79d3b232d859 www.in.tum.de;
wenzelm
parents: 5207
diff changeset
   141
<a href="http://www.in.tum.de/~nipkow/">Tobias Nipkow</a><br>
9927
wenzelm
parents: 9406
diff changeset
   142
Institut für Informatik<br>
wenzelm
parents: 9406
diff changeset
   143
T. U. München<br>
wenzelm
parents: 9406
diff changeset
   144
D-80290 München<br>
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   145
Germany<br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   146
<br>
8068
72d783f7313a corrected, improved eMail addresses, user interface section
oheimb
parents: 7959
diff changeset
   147
E-mail: <A HREF="mailto:nipkow@in.tum.de">nipkow@in.tum.de</A><br>
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   148
Phone: +49-89-289-22690<br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   149
Fax:   +49-89-289-28183<br>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   150
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   151
<p>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   152
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   153
<hr>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   154
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   155
Please report any problems you encounter.  While we shall try to be
5665
1dc74203b1d2 updated, tuned;
wenzelm
parents: 5534
diff changeset
   156
helpful, we can accept no responsibility for the deficiencies of
3259
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   157
Isabelle and their consequences.
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   158
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   159
<hr>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   160
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   161
</body>
667be2ebd22f the new README;
wenzelm
parents:
diff changeset
   162
</html>