doc-src/IsarRef/Thy/document/Introduction.tex
author ballarin
Tue, 28 Oct 2008 11:03:07 +0100
changeset 28699 32b6a8f12c1c
parent 28505 f98751bd715f
child 29717 51ed69c9422b
child 30240 5b25fee0362c
permissions -rw-r--r--
Removed 'includes meta_term_syntax' and 'includes meta_conjunction_syntax'.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
27035
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
     1
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
     2
\begin{isabellebody}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
     3
\def\isabellecontext{Introduction}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
     4
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
     5
\isadelimtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
     6
\isanewline
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
     7
\isanewline
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
     8
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
     9
\endisadelimtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    10
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    11
\isatagtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    12
\isacommand{theory}\isamarkupfalse%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    13
\ Introduction\isanewline
27052
5c48cecb981b updated generated file;
wenzelm
parents: 27042
diff changeset
    14
\isakeyword{imports}\ Main\isanewline
27035
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    15
\isakeyword{begin}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    16
\endisatagtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    17
{\isafoldtheory}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    18
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    19
\isadelimtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    20
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    21
\endisadelimtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    22
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    23
\isamarkupchapter{Introduction%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    24
}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    25
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    26
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    27
\isamarkupsection{Overview%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    28
}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    29
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    30
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    31
\begin{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    32
The \emph{Isabelle} system essentially provides a generic
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    33
  infrastructure for building deductive systems (programmed in
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    34
  Standard ML), with a special focus on interactive theorem proving in
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    35
  higher-order logics.  In the olden days even end-users would refer
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    36
  to certain ML functions (goal commands, tactics, tacticals etc.) to
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    37
  pursue their everyday theorem proving tasks
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    38
  \cite{isabelle-intro,isabelle-ref}.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    39
  
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    40
  In contrast \emph{Isar} provides an interpreted language environment
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    41
  of its own, which has been specifically tailored for the needs of
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    42
  theory and proof development.  Compared to raw ML, the Isabelle/Isar
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    43
  top-level provides a more robust and comfortable development
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    44
  platform, with proper support for theory development graphs,
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    45
  single-step transactions with unlimited undo, etc.  The
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    46
  Isabelle/Isar version of the \emph{Proof~General} user interface
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    47
  \cite{proofgeneral,Aspinall:TACAS:2000} provides an adequate
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    48
  front-end for interactive theory and proof development in this
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    49
  advanced theorem proving environment.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    50
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    51
  \medskip Apart from the technical advances over bare-bones ML
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    52
  programming, the main purpose of the Isar language is to provide a
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    53
  conceptually different view on machine-checked proofs
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    54
  \cite{Wenzel:1999:TPHOL,Wenzel-PhD}.  ``Isar'' stands for
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    55
  ``Intelligible semi-automated reasoning''.  Drawing from both the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    56
  traditions of informal mathematical proof texts and high-level
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    57
  programming languages, Isar offers a versatile environment for
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    58
  structured formal proof documents.  Thus properly written Isar
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    59
  proofs become accessible to a broader audience than unstructured
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    60
  tactic scripts (which typically only provide operational information
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    61
  for the machine).  Writing human-readable proof texts certainly
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    62
  requires some additional efforts by the writer to achieve a good
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    63
  presentation, both of formal and informal parts of the text.  On the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    64
  other hand, human-readable formal texts gain some value in their own
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    65
  right, independently of the mechanic proof-checking process.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    66
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    67
  Despite its grand design of structured proof texts, Isar is able to
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    68
  assimilate the old tactical style as an ``improper'' sub-language.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    69
  This provides an easy upgrade path for existing tactic scripts, as
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    70
  well as additional means for interactive experimentation and
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    71
  debugging of structured proofs.  Isabelle/Isar supports a broad
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    72
  range of proof styles, both readable and unreadable ones.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    73
27057
ecbe1afe800b updated generated file;
wenzelm
parents: 27052
diff changeset
    74
  \medskip The Isabelle/Isar framework \cite{Wenzel:2006:Festschrift}
ecbe1afe800b updated generated file;
wenzelm
parents: 27052
diff changeset
    75
  is generic and should work reasonably well for any Isabelle
ecbe1afe800b updated generated file;
wenzelm
parents: 27052
diff changeset
    76
  object-logic that conforms to the natural deduction view of the
ecbe1afe800b updated generated file;
wenzelm
parents: 27052
diff changeset
    77
  Isabelle/Pure framework.  Specific language elements introduced by
ecbe1afe800b updated generated file;
wenzelm
parents: 27052
diff changeset
    78
  the major object-logics are described in \chref{ch:hol}
ecbe1afe800b updated generated file;
wenzelm
parents: 27052
diff changeset
    79
  (Isabelle/HOL), \chref{ch:holcf} (Isabelle/HOLCF), and \chref{ch:zf}
ecbe1afe800b updated generated file;
wenzelm
parents: 27052
diff changeset
    80
  (Isabelle/ZF).  The main language elements are already provided by
ecbe1afe800b updated generated file;
wenzelm
parents: 27052
diff changeset
    81
  the Isabelle/Pure framework. Nevertheless, examples given in the
ecbe1afe800b updated generated file;
wenzelm
parents: 27052
diff changeset
    82
  generic parts will usually refer to Isabelle/HOL as well.
27042
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
    83
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
    84
  \medskip Isar commands may be either \emph{proper} document
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
    85
  constructors, or \emph{improper commands}.  Some proof methods and
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
    86
  attributes introduced later are classified as improper as well.
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
    87
  Improper Isar language elements, which are marked by ``\isa{{\isachardoublequote}\isactrlsup {\isacharasterisk}{\isachardoublequote}}'' in the subsequent chapters; they are often helpful
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
    88
  when developing proof documents, but their use is discouraged for
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
    89
  the final human-readable outcome.  Typical examples are diagnostic
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
    90
  commands that print terms or theorems according to the current
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
    91
  context; other commands emulate old-style tactical theorem proving.%
27035
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    92
\end{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    93
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    94
%
27052
5c48cecb981b updated generated file;
wenzelm
parents: 27042
diff changeset
    95
\isamarkupsection{User interfaces%
27035
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    96
}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    97
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    98
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
    99
\isamarkupsubsection{Terminal sessions%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   100
}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   101
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   102
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   103
\begin{isamarkuptext}%
27036
220fb39be543 isatool tty;
wenzelm
parents: 27035
diff changeset
   104
The Isabelle \texttt{tty} tool provides a very interface for running
220fb39be543 isatool tty;
wenzelm
parents: 27035
diff changeset
   105
  the Isar interaction loop, with some support for command line
220fb39be543 isatool tty;
wenzelm
parents: 27035
diff changeset
   106
  editing.  For example:
27035
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   107
\begin{ttbox}
28505
f98751bd715f updated generated file;
wenzelm
parents: 27057
diff changeset
   108
isabelle tty\medskip
27036
220fb39be543 isatool tty;
wenzelm
parents: 27035
diff changeset
   109
{\out Welcome to Isabelle/HOL (Isabelle2008)}\medskip
27035
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   110
theory Foo imports Main begin;
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   111
definition foo :: nat where "foo == 1";
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   112
lemma "0 < foo" by (simp add: foo_def);
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   113
end;
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   114
\end{ttbox}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   115
27036
220fb39be543 isatool tty;
wenzelm
parents: 27035
diff changeset
   116
  Any Isabelle/Isar command may be retracted by \hyperlink{command.undo}{\mbox{\isa{\isacommand{undo}}}}.
220fb39be543 isatool tty;
wenzelm
parents: 27035
diff changeset
   117
  See the Isabelle/Isar Quick Reference (\appref{ap:refcard}) for a
220fb39be543 isatool tty;
wenzelm
parents: 27035
diff changeset
   118
  comprehensive overview of available commands and other language
220fb39be543 isatool tty;
wenzelm
parents: 27035
diff changeset
   119
  elements.%
27035
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   120
\end{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   121
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   122
%
27042
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
   123
\isamarkupsubsection{Emacs Proof General%
27035
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   124
}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   125
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   126
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   127
\begin{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   128
Plain TTY-based interaction as above used to be quite feasible with
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   129
  traditional tactic based theorem proving, but developing Isar
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   130
  documents really demands some better user-interface support.  The
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   131
  Proof~General environment by David Aspinall
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   132
  \cite{proofgeneral,Aspinall:TACAS:2000} offers a generic Emacs
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   133
  interface for interactive theorem provers that organizes all the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   134
  cut-and-paste and forward-backward walk through the text in a very
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   135
  neat way.  In Isabelle/Isar, the current position within a partial
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   136
  proof document is equally important than the actual proof state.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   137
  Thus Proof~General provides the canonical working environment for
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   138
  Isabelle/Isar, both for getting acquainted (e.g.\ by replaying
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   139
  existing Isar documents) and for production work.%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   140
\end{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   141
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   142
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   143
\isamarkupsubsubsection{Proof~General as default Isabelle interface%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   144
}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   145
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   146
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   147
\begin{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   148
The Isabelle interface wrapper script provides an easy way to invoke
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   149
  Proof~General (including XEmacs or GNU Emacs).  The default
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   150
  configuration of Isabelle is smart enough to detect the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   151
  Proof~General distribution in several canonical places (e.g.\
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   152
  \verb|$ISABELLE_HOME/contrib/ProofGeneral|).  Thus the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   153
  capital \verb|Isabelle| executable would already refer to the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   154
  \verb|ProofGeneral/isar| interface without further ado.  The
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   155
  Isabelle interface script provides several options; pass \verb|-?|  to see its usage.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   156
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   157
  With the proper Isabelle interface setup, Isar documents may now be edited by
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   158
  visiting appropriate theory files, e.g.\ 
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   159
\begin{ttbox}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   160
Isabelle \({\langle}isabellehome{\rangle}\)/src/HOL/Isar_examples/Summation.thy
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   161
\end{ttbox}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   162
  Beginners may note the tool bar for navigating forward and backward
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   163
  through the text (this depends on the local Emacs installation).
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   164
  Consult the Proof~General documentation \cite{proofgeneral} for
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   165
  further basic command sequences, in particular ``\verb|C-c C-return|''
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   166
  and ``\verb|C-c u|''.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   167
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   168
  \medskip Proof~General may be also configured manually by giving
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   169
  Isabelle settings like this (see also \cite{isabelle-sys}):
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   170
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   171
\begin{ttbox}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   172
ISABELLE_INTERFACE=\$ISABELLE_HOME/contrib/ProofGeneral/isar/interface
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   173
PROOFGENERAL_OPTIONS=""
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   174
\end{ttbox}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   175
  You may have to change \verb|$ISABELLE_HOME/contrib/ProofGeneral| to the actual installation
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   176
  directory of Proof~General.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   177
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   178
  \medskip Apart from the Isabelle command line, defaults for
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   179
  interface options may be given by the \verb|PROOFGENERAL_OPTIONS|
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   180
  setting.  For example, the Emacs executable to be used may be
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   181
  configured in Isabelle's settings like this:
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   182
\begin{ttbox}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   183
PROOFGENERAL_OPTIONS="-p xemacs-mule"  
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   184
\end{ttbox}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   185
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   186
  Occasionally, a user's \verb|~/.emacs| file contains code
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   187
  that is incompatible with the (X)Emacs version used by
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   188
  Proof~General, causing the interface startup to fail prematurely.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   189
  Here the \verb|-u false| option helps to get the interface
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   190
  process up and running.  Note that additional Lisp customization
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   191
  code may reside in \verb|proofgeneral-settings.el| of
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   192
  \verb|$ISABELLE_HOME/etc| or \verb|$ISABELLE_HOME_USER/etc|.%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   193
\end{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   194
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   195
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   196
\isamarkupsubsubsection{The X-Symbol package%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   197
}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   198
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   199
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   200
\begin{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   201
Proof~General incorporates a version of the Emacs X-Symbol package
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   202
  \cite{x-symbol}, which handles proper mathematical symbols displayed
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   203
  on screen.  Pass option \verb|-x true| to the Isabelle
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   204
  interface script, or check the appropriate Proof~General menu
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   205
  setting by hand.  The main challenge of getting X-Symbol to work
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   206
  properly is the underlying (semi-automated) X11 font setup.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   207
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   208
  \medskip Using proper mathematical symbols in Isabelle theories can
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   209
  be very convenient for readability of large formulas.  On the other
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   210
  hand, the plain ASCII sources easily become somewhat unintelligible.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   211
  For example, \isa{{\isachardoublequote}{\isasymLongrightarrow}{\isachardoublequote}} would appear as \verb|\<Longrightarrow>| according
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   212
  the default set of Isabelle symbols.  Nevertheless, the Isabelle
27042
8fcf19f2168b updated generated file;
wenzelm
parents: 27036
diff changeset
   213
  document preparation system (see \chref{ch:document-prep}) will be
27035
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   214
  happy to print non-ASCII symbols properly.  It is even possible to
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   215
  invent additional notation beyond the display capabilities of Emacs
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   216
  and X-Symbol.%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   217
\end{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   218
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   219
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   220
\isamarkupsection{Isabelle/Isar theories%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   221
}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   222
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   223
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   224
\begin{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   225
Isabelle/Isar offers the following main improvements over classic
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   226
  Isabelle.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   227
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   228
  \begin{enumerate}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   229
  
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   230
  \item A \emph{theory format} that integrates specifications and
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   231
  proofs, supporting interactive development and unlimited undo
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   232
  operation.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   233
  
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   234
  \item A \emph{formal proof document language} designed to support
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   235
  intelligible semi-automated reasoning.  Instead of putting together
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   236
  unreadable tactic scripts, the author is enabled to express the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   237
  reasoning in way that is close to usual mathematical practice.  The
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   238
  old tactical style has been assimilated as ``improper'' language
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   239
  elements.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   240
  
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   241
  \item A simple document preparation system, for typesetting formal
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   242
  developments together with informal text.  The resulting
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   243
  hyper-linked PDF documents are equally well suited for WWW
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   244
  presentation and as printed copies.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   245
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   246
  \end{enumerate}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   247
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   248
  The Isar proof language is embedded into the new theory format as a
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   249
  proper sub-language.  Proof mode is entered by stating some
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   250
  \hyperlink{command.theorem}{\mbox{\isa{\isacommand{theorem}}}} or \hyperlink{command.lemma}{\mbox{\isa{\isacommand{lemma}}}} at the theory level, and
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   251
  left again with the final conclusion (e.g.\ via \hyperlink{command.qed}{\mbox{\isa{\isacommand{qed}}}}).
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   252
  A few theory specification mechanisms also require some proof, such
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   253
  as HOL's \hyperlink{command.typedef}{\mbox{\isa{\isacommand{typedef}}}} which demands non-emptiness of the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   254
  representing sets.%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   255
\end{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   256
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   257
%
27052
5c48cecb981b updated generated file;
wenzelm
parents: 27042
diff changeset
   258
\isamarkupsection{How to write Isar proofs anyway? \label{sec:isar-howto}%
27035
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   259
}
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   260
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   261
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   262
\begin{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   263
This is one of the key questions, of course.  First of all, the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   264
  tactic script emulation of Isabelle/Isar essentially provides a
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   265
  clarified version of the very same unstructured proof style of
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   266
  classic Isabelle.  Old-time users should quickly become acquainted
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   267
  with that (slightly degenerative) view of Isar.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   268
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   269
  Writing \emph{proper} Isar proof texts targeted at human readers is
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   270
  quite different, though.  Experienced users of the unstructured
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   271
  style may even have to unlearn some of their habits to master proof
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   272
  composition in Isar.  In contrast, new users with less experience in
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   273
  old-style tactical proving, but a good understanding of mathematical
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   274
  proof in general, often get started easier.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   275
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   276
  \medskip The present text really is only a reference manual on
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   277
  Isabelle/Isar, not a tutorial.  Nevertheless, we will attempt to
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   278
  give some clues of how the concepts introduced here may be put into
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   279
  practice.  Especially note that \appref{ap:refcard} provides a quick
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   280
  reference card of the most common Isabelle/Isar language elements.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   281
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   282
  Further issues concerning the Isar concepts are covered in the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   283
  literature
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   284
  \cite{Wenzel:1999:TPHOL,Wiedijk:2000:MV,Bauer-Wenzel:2000:HB,Bauer-Wenzel:2001}.
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   285
  The author's PhD thesis \cite{Wenzel-PhD} presently provides the
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   286
  most complete exposition of Isar foundations, techniques, and
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   287
  applications.  A number of example applications are distributed with
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   288
  Isabelle, and available via the Isabelle WWW library (e.g.\
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   289
  \url{http://isabelle.in.tum.de/library/}).  The ``Archive of Formal
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   290
  Proofs'' \url{http://afp.sourceforge.net/} also provides plenty of
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   291
  examples, both in proper Isar proof style and unstructured tactic
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   292
  scripts.%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   293
\end{isamarkuptext}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   294
\isamarkuptrue%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   295
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   296
\isadelimtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   297
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   298
\endisadelimtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   299
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   300
\isatagtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   301
\isacommand{end}\isamarkupfalse%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   302
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   303
\endisatagtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   304
{\isafoldtheory}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   305
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   306
\isadelimtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   307
%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   308
\endisadelimtheory
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   309
\isanewline
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   310
\end{isabellebody}%
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   311
%%% Local Variables:
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   312
%%% mode: latex
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   313
%%% TeX-master: "root"
d038a2ba87f6 renamed theory "intro" to "Introduction";
wenzelm
parents:
diff changeset
   314
%%% End: