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