25 \isamarkupsection{Isabelle/jEdit Prover IDE \label{sec:tool-jedit}% |
25 \isamarkupsection{Isabelle/jEdit Prover IDE \label{sec:tool-jedit}% |
26 } |
26 } |
27 \isamarkuptrue% |
27 \isamarkuptrue% |
28 % |
28 % |
29 \begin{isamarkuptext}% |
29 \begin{isamarkuptext}% |
30 The \indexdef{}{tool}{jedit}\hypertarget{tool.jedit}{\hyperlink{tool.jedit}{\mbox{\isa{\isatool{jedit}}}}} tool invokes a version of jEdit that has |
30 The \indexdef{}{tool}{jedit}\hypertarget{tool.jedit}{\hyperlink{tool.jedit}{\mbox{\isa{\isatool{jedit}}}}} tool invokes a version of |
31 been augmented with some components to provide a fully-featured |
31 jEdit\footnote{\url{http://www.jedit.org/}} that has been augmented |
32 Prover IDE (based on Isabelle/Scala): |
32 with some components to provide a fully-featured Prover IDE: |
33 \begin{ttbox} |
33 \begin{ttbox} Usage: isabelle jedit [OPTIONS] |
34 Usage: isabelle jedit [OPTIONS] [FILES ...] |
34 [FILES ...] |
35 |
35 |
36 Options are: |
36 Options are: |
37 -J OPTION add JVM runtime option (default JEDIT_JAVA_OPTIONS) |
37 -J OPTION add JVM runtime option (default JEDIT_JAVA_OPTIONS) |
38 -b build only |
38 -b build only |
39 -d enable debugger |
|
40 -f fresh build |
39 -f fresh build |
41 -j OPTION add jEdit runtime option (default JEDIT_OPTIONS) |
40 -j OPTION add jEdit runtime option (default JEDIT_OPTIONS) |
42 -l NAME logic image name (default ISABELLE_LOGIC) |
41 -l NAME logic image name (default ISABELLE_LOGIC) |
43 -m MODE add print mode for output |
42 -m MODE add print mode for output |
44 |
43 |
49 The \verb|-l| option specifies the logic image. The |
48 The \verb|-l| option specifies the logic image. The |
50 \verb|-m| option specifies additional print modes. |
49 \verb|-m| option specifies additional print modes. |
51 |
50 |
52 The \verb|-J| and \verb|-j| options allow to pass |
51 The \verb|-J| and \verb|-j| options allow to pass |
53 additional low-level options to the JVM or jEdit, respectively. The |
52 additional low-level options to the JVM or jEdit, respectively. The |
54 defaults are provided by the Isabelle settings environment. |
53 defaults are provided by the Isabelle settings environment |
55 |
54 (\secref{sec:settings}). |
56 The \verb|-d| option allows to connect to the runtime |
|
57 debugger of the JVM. Note that the Scala Console of Isabelle/jEdit |
|
58 is more convenient in most practical situations. |
|
59 |
55 |
60 The \verb|-b| and \verb|-f| options control the |
56 The \verb|-b| and \verb|-f| options control the |
61 self-build mechanism of Isabelle/jEdit. This is only relevant for |
57 self-build mechanism of Isabelle/jEdit. This is only relevant for |
62 building from sources, which also requires an auxiliary \verb|jedit_build| component. Official Isabelle releases already include |
58 building from sources, which also requires an auxiliary \verb|jedit_build| |
63 a version of Isabelle/jEdit that is built properly.% |
59 component.\footnote{\url{http://isabelle.in.tum.de/components}} Note |
|
60 that official Isabelle releases already include a version of |
|
61 Isabelle/jEdit that is built properly.% |
64 \end{isamarkuptext}% |
62 \end{isamarkuptext}% |
65 \isamarkuptrue% |
63 \isamarkuptrue% |
66 % |
64 % |
67 \isamarkupsection{Proof General / Emacs% |
65 \isamarkupsection{Proof General / Emacs% |
68 } |
66 } |
69 \isamarkuptrue% |
67 \isamarkuptrue% |
70 % |
68 % |
71 \begin{isamarkuptext}% |
69 \begin{isamarkuptext}% |
72 The \indexdef{}{tool}{emacs}\hypertarget{tool.emacs}{\hyperlink{tool.emacs}{\mbox{\isa{\isatool{emacs}}}}} tool invokes a version of Emacs and |
70 The \indexdef{}{tool}{emacs}\hypertarget{tool.emacs}{\hyperlink{tool.emacs}{\mbox{\isa{\isatool{emacs}}}}} tool invokes a version of Emacs and |
73 Proof General \cite{proofgeneral} within the regular Isabelle |
71 Proof General\footnote{http://proofgeneral.inf.ed.ac.uk/} within the |
74 settings environment (\secref{sec:settings}). This is more |
72 regular Isabelle settings environment (\secref{sec:settings}). This |
75 convenient than starting Emacs separately, loading the Proof General |
73 is more convenient than starting Emacs separately, loading the Proof |
76 lisp files, and then attempting to start Isabelle with dynamic |
74 General LISP files, and then attempting to start Isabelle with |
77 \hyperlink{setting.PATH}{\mbox{\isa{\isatt{PATH}}}} lookup etc. |
75 dynamic \hyperlink{setting.PATH}{\mbox{\isa{\isatt{PATH}}}} lookup etc. |
78 |
76 |
79 The actual interface script is part of the Proof General |
77 The actual interface script is part of the Proof General |
80 distribution; its usage depends on the particular version. There |
78 distribution; its usage depends on the particular version. There |
81 are some options available, such as \verb|-l| for passing the |
79 are some options available, such as \verb|-l| for passing the |
82 logic image to be used by default, or \verb|-m| to tune the |
80 logic image to be used by default, or \verb|-m| to tune the |
121 \verb|-m| option specifies additional print modes. The |
119 \verb|-m| option specifies additional print modes. The |
122 \verb|-p| option specifies an alternative line editor (such |
120 \verb|-p| option specifies an alternative line editor (such |
123 as the \indexdef{}{executable}{rlwrap}\hypertarget{executable.rlwrap}{\hyperlink{executable.rlwrap}{\mbox{\isa{\isatt{rlwrap}}}}} wrapper for GNU readline); the |
121 as the \indexdef{}{executable}{rlwrap}\hypertarget{executable.rlwrap}{\hyperlink{executable.rlwrap}{\mbox{\isa{\isatt{rlwrap}}}}} wrapper for GNU readline); the |
124 fall-back is to use raw standard input. |
122 fall-back is to use raw standard input. |
125 |
123 |
126 Regular interaction is via the standard Isabelle/Isar toplevel loop. |
124 Regular interaction works via the standard Isabelle/Isar toplevel |
127 The Isar command \hyperlink{command.exit}{\mbox{\isa{\isacommand{exit}}}} drops out into the bare-bones ML |
125 loop. The Isar command \hyperlink{command.exit}{\mbox{\isa{\isacommand{exit}}}} drops out into the |
128 system, which is occasionally useful for debugging of the Isar |
126 bare-bones ML system, which is occasionally useful for debugging of |
129 infrastructure itself. Invoking \verb|Isar.loop|~\verb|();| |
127 the Isar infrastructure itself. Invoking \verb|Isar.loop|~\verb|();| in ML will return to the Isar toplevel.% |
130 in ML will return to the Isar toplevel.% |
|
131 \end{isamarkuptext}% |
128 \end{isamarkuptext}% |
132 \isamarkuptrue% |
129 \isamarkuptrue% |
133 % |
130 % |
134 \isamarkupsection{Theory graph browser \label{sec:browse}% |
131 \isamarkupsection{Theory graph browser \label{sec:browse}% |
135 } |
132 } |