| author | wenzelm |
| Fri, 25 Jan 2013 13:21:13 +0100 | |
| changeset 51049 | 0b48d00aba8f |
| parent 50544 | c76b41cde4f5 |
| child 51082 | 55b82b1417d1 |
| permissions | -rw-r--r-- |
| 41628 | 1 |
<?xml version="1.0" encoding="UTF-8" ?> |
| 39591 | 2 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
3 |
<html xmlns="http://www.w3.org/1999/xhtml"> |
|
4 |
||
5 |
<head> |
|
6 |
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> |
|
| 43470 | 7 |
<style type="text/css" media="screen"> |
| 49956 | 8 |
body { font-family: IsabelleText; font-size: 14pt; }
|
| 43470 | 9 |
</style> |
| 45098 | 10 |
<title>Welcome to the Isabelle/jEdit Prover IDE</title> |
| 39591 | 11 |
</head> |
12 |
||
13 |
<body> |
|
14 |
||
| 45099 | 15 |
<center><h2><img alt="PIDE" src="PIDE.png" width="230" align="middle"/></h2></center> |
| 45098 | 16 |
|
17 |
<p> |
|
| 50407 | 18 |
<b>PIDE</b> is a framework for sophisticated Prover IDEs, |
| 45098 | 19 |
based on Isabelle/Scala technology that is integrated with Isabelle. |
| 47741 | 20 |
It is built around a concept of |
| 45098 | 21 |
<em>asynchronous document processing</em>, which is supported |
22 |
natively by the <em>parallel proof engine</em> implemented in Isabelle/ML. |
|
23 |
</p> |
|
24 |
||
25 |
<p> |
|
|
51049
0b48d00aba8f
minimal updated of jEdit/README.html, without any substantial reforms;
wenzelm
parents:
50544
diff
changeset
|
26 |
<b>Isabelle/jEdit</b> is the flagship application of the PIDE |
| 45098 | 27 |
framework — it illustrates many of the ideas in a realistic |
28 |
manner, ready to be used right now in Isabelle applications. |
|
29 |
</p> |
|
| 44700 | 30 |
|
| 45098 | 31 |
<p> |
| 47491 | 32 |
<em>Research and implementation of concepts around PIDE has started |
33 |
around 2008 and was kindly supported by BMBF (http://www.bmbf.de), |
|
|
48917
ce37d4f8b4f4
updated READMEs -- most Mac OS X problems are gone thanks to jdk-7u6;
wenzelm
parents:
47741
diff
changeset
|
34 |
Université Paris-Sud (http://www.u-psud.fr), Digiteo |
|
ce37d4f8b4f4
updated READMEs -- most Mac OS X problems are gone thanks to jdk-7u6;
wenzelm
parents:
47741
diff
changeset
|
35 |
(http://www.digiteo.fr), and ANR |
|
ce37d4f8b4f4
updated READMEs -- most Mac OS X problems are gone thanks to jdk-7u6;
wenzelm
parents:
47741
diff
changeset
|
36 |
(http://www.agence-nationale-recherche.fr).</em> |
| 45098 | 37 |
</p> |
38 |
||
39 |
||
40 |
||
41 |
<h2>The Isabelle/jEdit Prover IDE</h2> |
|
42 |
||
43 |
<p> |
|
44 |
Isabelle/jEdit consists of some plugins for the well-known jEdit text |
|
45 |
editor framework (http://www.jedit.org), according to the following |
|
46 |
principles. |
|
47 |
</p> |
|
| 39591 | 48 |
|
49 |
<ul> |
|
50 |
||
| 39738 | 51 |
<li>The original jEdit look-and-feel is generally preserved, although |
52 |
some default properties have been changed to accommodate Isabelle |
|
| 40894 | 53 |
(e.g. the text area font).</li> |
| 39736 | 54 |
|
| 39738 | 55 |
<li>Formal Isabelle/Isar text is checked asynchronously while editing. |
56 |
The user is in full command of the editor, and the prover refrains |
|
57 |
from locking portions of the buffer etc.</li> |
|
| 39591 | 58 |
|
| 39738 | 59 |
<li>Prover feedback works via tooltips, syntax highlighting, colors, |
60 |
boxes etc. based on semantic markup provided by Isabelle in the |
|
61 |
background.</li> |
|
62 |
||
63 |
<li>Using the mouse together with the modifier key <tt>C</tt> |
|
64 |
(<tt>CONTROL</tt> on Linux or Windows, |
|
| 45097 | 65 |
<tt>COMMAND</tt> on Mac OS X) exposes additional information.</li> |
| 39736 | 66 |
|
| 39738 | 67 |
<li>Dockable panels (e.g. <em>Output</em>) are managed as independent |
68 |
windows by jEdit, which also allows multiple instances.</li> |
|
| 39591 | 69 |
|
|
51049
0b48d00aba8f
minimal updated of jEdit/README.html, without any substantial reforms;
wenzelm
parents:
50544
diff
changeset
|
70 |
<li>Formal output (tooltips etc.) may be explored recursively, using the |
|
0b48d00aba8f
minimal updated of jEdit/README.html, without any substantial reforms;
wenzelm
parents:
50544
diff
changeset
|
71 |
same techniques as in the editor source buffer.</li> |
|
0b48d00aba8f
minimal updated of jEdit/README.html, without any substantial reforms;
wenzelm
parents:
50544
diff
changeset
|
72 |
|
|
49173
fa01a202399c
eliminated potentially confusing terminology of Scala "layer";
wenzelm
parents:
48917
diff
changeset
|
73 |
<li>Prover process and source files are managed by the Isabelle/Scala on |
| 45098 | 74 |
the editor side. The prover experiences a mostly timeless and |
75 |
stateless environment of formal document content.</li> |
|
76 |
||
| 39591 | 77 |
</ul> |
78 |
||
| 41628 | 79 |
|
80 |
<h2>Isabelle symbols and fonts</h2> |
|
81 |
||
82 |
<ul> |
|
83 |
<li>Isabelle supports infinitely many symbols:<br/> |
|
|
43472
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
84 |
α, β, γ, …<br/> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
85 |
∀, ∃, ∨, ∧, ⟶, ⟷, …<br/> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
86 |
≤, ≥, ⊓, ⊔, …<br/> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
87 |
ℵ, △, ∇, …<br/> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
88 |
<tt>\<foo></tt>, <tt>\<bar></tt>, <tt>\<baz></tt>, …<br/> |
| 41628 | 89 |
</li> |
90 |
||
| 43470 | 91 |
<li>There are some special control symbols to modify the style of a |
92 |
<em>single</em> symbol:<br/> |
|
|
43472
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
93 |
⇩ subscript<br/> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
94 |
⇧ superscript<br/> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
95 |
⇣ subscript within identifier<br/> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
96 |
⇡ superscript within identifier<br/> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
97 |
❙ bold face</li> |
| 43470 | 98 |
|
| 41628 | 99 |
<li>A default mapping relates some Isabelle symbols to Unicode points |
100 |
(see <tt>$ISABELLE_HOME/etc/symbols</tt> and <tt>$ISABELLE_HOME_USER/etc/symbols</tt>). |
|
101 |
</li> |
|
102 |
||
103 |
<li>The <em>IsabelleText</em> font ensures that Unicode points are actually |
|
104 |
seen on the screen (or printer). |
|
105 |
</li> |
|
106 |
||
107 |
<li>Input methods: |
|
108 |
<ul> |
|
|
51049
0b48d00aba8f
minimal updated of jEdit/README.html, without any substantial reforms;
wenzelm
parents:
50544
diff
changeset
|
109 |
<li>use the Symbols dockable</li> |
| 41628 | 110 |
<li>copy/paste from decoded source files</li> |
111 |
<li>copy/paste from prover output</li> |
|
112 |
<li>completion provided by Isabelle plugin, e.g.<br/> |
|
113 |
||
114 |
<table border="1"> |
|
115 |
<tr><th><b>name</b></th> <th><b>abbreviation</b></th> <th><b>symbol</b></th></tr> |
|
116 |
||
|
43472
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
117 |
<tr><td>lambda</td> <td><tt>%</tt></td> <td>λ</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
118 |
<tr><td>Rightarrow</td> <td><tt>=></tt></td> <td>⇒</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
119 |
<tr><td>Longrightarrow</td> <td><tt>==></tt></td> <td>⟹</td></tr> |
| 41628 | 120 |
|
|
43472
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
121 |
<tr><td>And</td> <td><tt>!!</tt></td> <td>⋀</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
122 |
<tr><td>equiv</td> <td><tt>==</tt></td> <td>≡</td></tr> |
| 41628 | 123 |
|
|
43472
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
124 |
<tr><td>forall</td> <td><tt>!</tt></td> <td>∀</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
125 |
<tr><td>exists</td> <td><tt>?</tt></td> <td>∃</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
126 |
<tr><td>longrightarrow</td> <td><tt>--></tt></td> <td>⟶</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
127 |
<tr><td>and</td> <td><tt>/\</tt></td> <td>∧</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
128 |
<tr><td>or</td> <td><tt>\/</tt></td> <td>∨</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
129 |
<tr><td>not</td> <td><tt>~ </tt></td> <td>¬</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
130 |
<tr><td>noteq</td> <td><tt>~=</tt></td> <td>≠</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
131 |
<tr><td>in</td> <td><tt>:</tt></td> <td>∈</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
132 |
<tr><td>notin</td> <td><tt>~:</tt></td> <td>∉</td></tr> |
| 43470 | 133 |
|
|
43472
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
134 |
<tr><td>sub</td> <td><tt>=_</tt></td> <td>⇩</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
135 |
<tr><td>sup</td> <td><tt>=^</tt></td> <td>⇧</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
136 |
<tr><td>isup</td> <td><tt>-_</tt></td> <td>⇣</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
137 |
<tr><td>isub</td> <td><tt>-^</tt></td> <td>⇡</td></tr> |
|
ac6db8f44e5d
literal unicode in README.html allows to copy/paste from Lobo output;
wenzelm
parents:
43470
diff
changeset
|
138 |
<tr><td>bold</td> <td><tt>-.</tt></td> <td>❙</td></tr> |
| 43470 | 139 |
|
| 41628 | 140 |
</table> |
141 |
</li> |
|
142 |
</ul> |
|
143 |
</li> |
|
144 |
||
145 |
<li><b>NOTE:</b> The above abbreviations refer to the input method. |
|
146 |
The logical notation provides ASCII alternatives that often |
|
147 |
coincide, but deviate occasionally. |
|
148 |
</li> |
|
149 |
||
150 |
<li><b>NOTE:</b> Generic jEdit abbreviations or plugins perform similar |
|
151 |
source replacement operations; this works for Isabelle as long |
|
152 |
as the Unicode sequences coincide with the symbol mapping. |
|
153 |
</li> |
|
154 |
||
| 45107 | 155 |
<li><b>NOTE:</b> Raw unicode characters within prover source files |
| 45098 | 156 |
should be restricted to informal parts, e.g. to write text in |
157 |
non-latin alphabets. Mathematical symbols should be defined via the |
|
158 |
official rendering tables. |
|
159 |
</li> |
|
160 |
||
| 41628 | 161 |
</ul> |
162 |
||
163 |
||
| 50544 | 164 |
<h2>Limitations and known problems</h2> |
|
41538
d060ccad02bd
updated Isabelle/jEdit limitations and workarounds;
wenzelm
parents:
40894
diff
changeset
|
165 |
|
|
d060ccad02bd
updated Isabelle/jEdit limitations and workarounds;
wenzelm
parents:
40894
diff
changeset
|
166 |
<ul> |
| 44700 | 167 |
<li>Lack of dependency managed for auxiliary files that contribute |
|
48917
ce37d4f8b4f4
updated READMEs -- most Mac OS X problems are gone thanks to jdk-7u6;
wenzelm
parents:
47741
diff
changeset
|
168 |
to a theory (e.g. <tt>ML_file</tt>).<br/> |
|
ce37d4f8b4f4
updated READMEs -- most Mac OS X problems are gone thanks to jdk-7u6;
wenzelm
parents:
47741
diff
changeset
|
169 |
<em>Workaround:</em> Re-load files manually within the prover.</li> |
|
41538
d060ccad02bd
updated Isabelle/jEdit limitations and workarounds;
wenzelm
parents:
40894
diff
changeset
|
170 |
|
| 50544 | 171 |
<li>Odd behavior of some diagnostic commands with global |
172 |
side-effects, like writing a physical |
|
173 |
file.<br/> <em>Workaround:</em> Avoid such commands.</li> |
|
174 |
||
| 44806 | 175 |
<li>No way to delete document nodes from the overall collection of |
176 |
theories.<br/> |
|
177 |
<em>Workaround:</em> Restart whole Isabelle/jEdit session in |
|
178 |
worst-case situation.</li> |
|
179 |
||
|
41538
d060ccad02bd
updated Isabelle/jEdit limitations and workarounds;
wenzelm
parents:
40894
diff
changeset
|
180 |
<li>No support for non-local markup, e.g. commands reporting on |
|
d060ccad02bd
updated Isabelle/jEdit limitations and workarounds;
wenzelm
parents:
40894
diff
changeset
|
181 |
previous commands (proof end on proof head), or markup produced by |
|
d060ccad02bd
updated Isabelle/jEdit limitations and workarounds;
wenzelm
parents:
40894
diff
changeset
|
182 |
loading external files.</li> |
|
50131
921cc694057b
known problems with Mac OS X are back -- Java 7u6 is not the last word (cf. ce37d4f8b4f4);
wenzelm
parents:
49956
diff
changeset
|
183 |
|
| 50544 | 184 |
<li>The native MacOSX plugin for jEdit tends to be disruptive. It |
185 |
might or might not improve the user experience, and is off by |
|
186 |
default.</li> |
|
|
50131
921cc694057b
known problems with Mac OS X are back -- Java 7u6 is not the last word (cf. ce37d4f8b4f4);
wenzelm
parents:
49956
diff
changeset
|
187 |
|
| 50544 | 188 |
<li>Java 7 on MacOSX is officially supported on Lion and Mountain |
189 |
Lion, but not Snow Leopard. It usually works on the latter, but |
|
190 |
there might be some instabilities.</li> |
|
|
50131
921cc694057b
known problems with Mac OS X are back -- Java 7u6 is not the last word (cf. ce37d4f8b4f4);
wenzelm
parents:
49956
diff
changeset
|
191 |
</ul> |
|
921cc694057b
known problems with Mac OS X are back -- Java 7u6 is not the last word (cf. ce37d4f8b4f4);
wenzelm
parents:
49956
diff
changeset
|
192 |
|
|
921cc694057b
known problems with Mac OS X are back -- Java 7u6 is not the last word (cf. ce37d4f8b4f4);
wenzelm
parents:
49956
diff
changeset
|
193 |
|
| 44700 | 194 |
<h2>Licenses and home sites of contributing systems</h2> |
195 |
||
196 |
<ul> |
|
197 |
||
| 45098 | 198 |
<li>Isabelle: BSD-style</li> |
199 |
||
| 44700 | 200 |
<li>Scala: BSD-style <br/> http://www.scala-lang.org</li> |
201 |
||
202 |
<li>jEdit: GPL (with special cases) <br/> http://www.jedit.org/</li> |
|
203 |
||
204 |
<li>Lobo/Cobra: GPL and LGPL <br/> http://lobobrowser.org/</li> |
|
205 |
||
206 |
</ul> |
|
207 |
||
| 39591 | 208 |
</body> |
209 |
</html> |