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