doc-src/System/Thy/document/Interfaces.tex
changeset 48603 a37463482e5f
parent 48602 342ca8f3197b
child 48791 9e8f30bfbdca
equal deleted inserted replaced
48602:342ca8f3197b 48603:a37463482e5f
    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 }