Admin/website/installation_notes_cygwin.html
author haftmann
Mon, 04 Jul 2005 15:15:55 +0200
changeset 16674 bf2cd93cc245
child 17563 abb280dd3431
permissions -rw-r--r--
unified main and dist
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
16674
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     1
<?xml version='1.0' encoding='iso-8859-1' ?>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     3
<!-- $Id$ -->
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     4
<html xmlns="http://www.w3.org/1999/xhtml">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     5
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     6
<head>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     7
    <title>Installation notes for Windows/Cygwin</title>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     8
    <?include file="//include/htmlheader.include.html"?>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
     9
</head>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    10
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    11
<body class="dist">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    12
    <?include file="//include/header.include.html"?>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    13
    <div class="hr"><hr/></div>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    14
    <?include file="//include/navigation.include.html"?>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    15
    <div class="hr"><hr/></div>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    16
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    17
    <div id="content">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    18
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    19
      <h2>Preconditions and restrictions</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    20
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    21
      <p>Please notice before you go ahead:</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    22
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    23
      <ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    24
        <li>The ML system these notes apply to is <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    25
        "http://www.smlnj.org/">Standard ML of New Jersey</a>; it is <em>not</em>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    26
        known yet how to get Isabelle run completely with <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    27
        "www.polyml.org/">Poly/ML</a>. See <a href="#polyml">a note on Poly/ML</a>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    28
        down this page.</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    29
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    30
        <li>It is assumed you have some experience with an Unix operating system
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    31
        (e.g. what a shell is for and how to use it).</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    32
      </ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    33
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    34
      <p>Any suggestions and improvements concerning this hints are welcomed!</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    35
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    36
      <h2>Acknowlegements</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    37
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    38
      <p>Thanks to <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    39
      "http://cswww.essex.ac.uk/Research/FSS/projects/isawin/">Norbert
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    40
      Völker</a> and <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    41
      "http://www.abo.fi/~viorel.preoteasa/isabelle/">Viorel Preoteasa</a> whose
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    42
      efforts helped a lot to get Isabelle run this way.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    43
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    44
      <h2>Installing Cygwin</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    45
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    46
      <p>Cygwin is a POSIX emulation layer for Windows; it contains ports of a
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    47
      large collection of common Unix software (shells, perl, gcc, X11, latex,
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    48
      ImageMagick, &hellip;).</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    49
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    50
      <p>To install it, get the installer from the <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    51
      "http://www.cygwin.com">Cygwin website</a> and run it. It will ask you which
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    52
      packages to install, and then downloads and installs them. Please make sure
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    53
      you install everything needed by Isabelle; it is hard to give a concise list
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    54
      of packages here since the bundling of Cygwin packages may vary over time,
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    55
      but installing the base packages, perl, make, xemacs and x-server should be a
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    56
      good choice for the beginning.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    57
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    58
      <p>By default, cygwin installs to <tt class="shellcmd">c:\cygwin</tt>; you may choose an
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    59
      arbitrary location, but it is recommended that it does not include any space
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    60
      or exotic characters. This directory will then become the root directory of
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    61
      the Cygwin filesystem tree, i.e. the Cygwin path <tt class="shellcmd">/opt/smlnj</tt> will be
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    62
      mapped to Windows path <tt class="shellcmd">c:\cygwin\opt\smlnj</tt>.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    63
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    64
      <p>After installation, open a Cygwin shell window (normally the installer
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    65
      makes a shortcut for you).</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    66
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    67
      <h2>Getting and building SML/NJ</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    68
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    69
      <p>Now we are ready to get and build <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    70
      "http://www.smlnj.org/">SML/NJ</a>; before this, set the environment variable
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    71
      SMLNJ_CYGWIN_RUNTIME to 1:</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    72
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    73
      <ul class="shellcmd">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    74
        <li>export SMLNJ_CYGWIN_RUNTIME=1</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    75
      </ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    76
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    77
      <p>This setting will tell the build process that it should
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    78
      <em>not</em> attempt to build SML/NJ natively for Win32 but for Cygwin
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    79
      instead (see further <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    80
      "http://smlnj.cs.uchicago.edu/dist/working/110.53/CYGWININSTALL">CYGWININSTALL</a>).</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    81
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    82
      <p>So far, this setup was tested using the working version 110.53 of SML/NJ
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    83
      from <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    84
      "http://smlnj.cs.uchicago.edu/dist/working/110.53/">http://smlnj.cs.uchicago.edu/dist/working/110.53/</a>.
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    85
      SML/NJ provides a nice installer enabling you to download and build it. Read
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    86
      <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    87
      "http://smlnj.cs.uchicago.edu/dist/working/110.53/INSTALL">INSTALL</a> to
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    88
      learn about the different possibilites to do this. The default packages
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    89
      should be sufficient.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    90
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    91
      <p>In the following, it is assumed that you install SML/NJ to Cygwin path
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    92
      <tt class="shellcmd">/opt/smlnj</tt>; if you choose an other location, some tweaking in the
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    93
      <a href="#config"><tt class="shellcmd">etc/settings</tt> file</a> may be neccessary later.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    94
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    95
      <p>Whenever SMLNJ is used, the SMLNJ_CYGWIN_RUNTIME environment variable must
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    96
      be set to 1 (later on a convenient mechanism to make this the default is
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    97
      proposed).</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    98
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
    99
      <h2>Installing Isabelle</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   100
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   101
      <p>Download the latest Isabelle and ProofGeneral <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   102
      "download.html">release packages</a>. Assuming that you are in the directory
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   103
      where you downloaded the files, install them into <tt class="shellcmd">/opt</tt> by typing
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   104
      into the bash shell:</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   105
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   106
      <ul class="shellcmd">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   107
        <li>tar -C /usr/opt -xvzf <?value key="distname"?>.tar.gz</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   108
        <li>tar -C /usr/opt -xvzf ProofGeneral.tar.gz</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   109
      </ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   110
      
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   111
      <p>During extraction, one inconvenience may occur, see <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   112
      "#inconvenience">below</a>.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   113
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   114
      <p>The location <tt class="shellcmd">/opt</tt> again is just a proposal; if you choose other
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   115
      locations, some tweaking in the <a href="#config"><tt class="shellcmd">etc/settings</tt>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   116
      file</a> may be neccessary later.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   117
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   118
      <h2 id="config">Configuring Isabelle</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   119
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   120
      <p>Edit the file <tt class="shellcmd">/opt/Isabelle/etc/settings</tt>; first, uncomment the
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   121
      lines about SMLNJ. Also set the variable SMLNJ_CYGWIN_RUNTIME to 1, in order
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   122
      the cygwin version of SMLNJ is used. As mentioned above, the path variables
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   123
      for the ML system and ProofGeneral may need adjustions, depending on your
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   124
      different installation locations.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   125
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   126
      <p>Take heed of the setting of ISABELLE_HOME_USER; by default, this is
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   127
      <tt class="shellcmd">~/isabelle</tt>. To detect which Windows path this will be mapped to,
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   128
      type into the Cygwin bash shell:</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   129
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   130
      <ul class="shellcmd">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   131
        <li>cygpath --windows ~/isabelle</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   132
      </ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   133
      
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   134
      <p>If you don't like this location to be the isabelle home
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   135
      directory, consider setting of ISABELLE_HOME_USER to another value; use
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   136
      <tt class="shellcmd">cygpath --unix &lt;winpath&gt;</tt> to detect which Cygwin path a given
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   137
      Windows path is mapped to.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   138
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   139
      <p>A typical change could look like this:</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   140
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   141
      <blockquote>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   142
        from<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   143
        <tt># Standard ML of New Jersey 110 or later<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   144
        #ML_SYSTEM=smlnj-110<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   145
        #ML_HOME="$ISABELLE_HOME/../smlnj/bin"<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   146
        #ML_OPTIONS="@SMLdebug=/dev/null"<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   147
        #ML_PLATFORM=$(eval $("$ML_HOME/.arch-n-opsys" 2&gt;/dev/null); echo
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   148
        "$HEAP_SUFFIX")<br /></tt>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   149
      </blockquote>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   150
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   151
      <blockquote>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   152
        to<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   153
        <tt># Standard ML of New Jersey 110 or later<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   154
        SMLNJ_CYGWIN_RUNTIME=1<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   155
        ML_SYSTEM=smlnj-110<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   156
        ML_HOME="$ISABELLE_HOME/../smlnj/bin"<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   157
        ML_OPTIONS="@SMLdebug=/dev/null"<br />
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   158
        ML_PLATFORM=$(eval $("$ML_HOME/.arch-n-opsys" 2&gt;/dev/null); echo
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   159
        "$HEAP_SUFFIX")</tt>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   160
      </blockquote>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   161
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   162
      <h2>Building logics</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   163
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   164
      <p>Now we can compile some logics. Start the cygwin shell (if not still
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   165
      running) and type:</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   166
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   167
      <ul class="shellcmd">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   168
        <li>cd /opt/Isabelle</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   169
        <li>build HOL</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   170
        <li>build ZF</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   171
      </ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   172
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   173
      <p>The compilation process may take some time (depending on how fast the
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   174
      computer is). Before building a logic image the build program shows some
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   175
      variables and expects user input &ndash; just hit enter.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   176
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   177
      <h2>Running Isabelle with ProofGeneral</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   178
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   179
      <p>On Linux, Isabelle can be started by two scripts located in
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   180
      <tt class="shellcmd">Isabelle/bin</tt>: <tt class="shellcmd">Isabelle</tt> and <tt class="shellcmd">isabelle</tt>.
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   181
      <tt class="shellcmd">Isabelle</tt> attempts to start ProofGeneral with XEmacs, and isabelle
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   182
      starts it in an SML shell session. However Windows treats the two names as
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   183
      one. To get around this, just rename <tt class="shellcmd">/opt/Isabelle/bin/isabelle</tt> to
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   184
      <tt class="shellcmd">/opt/Isabelle/bin/Isabelle</tt>. This script
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   185
      will start Isabelle with ProofGeneral; the <tt class="shellcmd">isabelle</tt>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   186
      script in any case is available as <tt class="shellcmd">isabelle-process</tt>.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   187
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   188
      <p>Now everything should be ready. To test, start the cygwin shell and
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   189
      type</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   190
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   191
      <ul class="shellcmd">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   192
        <li>startx &amp;</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   193
      </ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   194
      
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   195
      <p>This will start the cygwin X server and an X shell window. In
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   196
      the X shell window, type</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   197
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   198
      <ul class="shellcmd">
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   199
        <li>/opt/Isabelle/bin/Isabelle &amp;</li>.
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   200
      </ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   201
      
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   202
      <p>This will start the ProofGeneral interface for Isabelle. After a
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   203
      while an empty buffer <tt>Scratch.thy</tt> is created. You can turn on
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   204
      X-Symbol from the menu Proof-General, item Options.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   205
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   206
      <p>Load one of your favorite theories and test your Isabelle installation by
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   207
      proving something.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   208
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   209
      <p>To simplify starting ProofGeneral, consider writing a Windows command
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   210
      script, e.&nbsp;g.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   211
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   212
      <blockquote>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   213
        <tt>@bash startx -geometry 30x4 -iconic -e Isabell</tt>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   214
      </blockquote>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   215
      
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   216
      <p>and assigning a shortcut in the start menu to it.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   217
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   218
      <h2 id="inconvenience">Inconveniencies with the current version of
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   219
      Isabelle</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   220
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   221
      <p>With the current Isabelle release (Isabelle 2004), there are two
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   222
      inconveniencies:</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   223
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   224
      <ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   225
        <li>During extraction you will get a warning that file
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   226
        <tt class="shellcmd">Real/HahnBanach/Aux.thy</tt> can not be created. This is because
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   227
        <tt class="shellcmd">Aux</tt> is not allowed as a filename under Windows. If you do not want
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   228
        to run the HahnBanach example, you might simply want to ignore this
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   229
        warning.</li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   230
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   231
        <li>The tool <tt class="shellcmd">isatool mkdir</tt> tries to detect the name of the current
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   232
        user, to put it into the generated <tt class="shellcmd">root.tex</tt>. Alas, on Windows,
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   233
        this leads to an unquoted <tt>\</tt> in the TeX file. So you either must
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   234
        edit your <tt class="shellcmd">root.tex</tt> manually to fix this, or directly patch
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   235
        <tt class="shellcmd">/opt/Isabelle/lib/Tools/mkdir</tt> by replacing
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   236
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   237
          <blockquote>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   238
            <tt>AUTHOR=$("$AUTO_PERL" -e "@pw = getpwnam(\"$USER\"); print @pw[6]" | tr _ -)</tt>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   239
          </blockquote>with
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   240
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   241
          <blockquote>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   242
            <tt>AUTHOR="default author name"</tt>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   243
          </blockquote>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   244
        </li>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   245
      </ul>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   246
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   247
      <p>To get around these inconveniencies, consider using a recent developer
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   248
      snapshot of Isabelle; both will be fixed in the next Isabelle release.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   249
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   250
      <h2 id="polyml">A note on Poly/ML</h2>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   251
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   252
      <p>As indicated above, Isabelle does <em>not</em> run neatly with <a href=
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   253
      "http://www.polyml.org/">Poly/ML</a> on Windows, since it is not clear
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   254
      how Poly/ML has to be compiled for Cygwin, and the native Windows port
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   255
      of PolyML does not provide some Posix signals Isabelle/ProofGeneral relies on.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   256
    
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   257
      <p>If you know how to circumvent (fully or partially) any of these problems,
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   258
      please let us know.</p>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   259
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   260
    </div>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   261
    <div class="hr"><hr/></div>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   262
    <?include file="//include/footer.include.html"?>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   263
</body>
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   264
bf2cd93cc245 unified main and dist
haftmann
parents:
diff changeset
   265
</html>