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