(* $Id$ *)

 theory Quick_Reference

 imports Main

 begin

 chapter {* Isabelle/Isar quick reference \label{ap:refcard} *}

 section {* Proof commands *}

 subsection {* Primitives and basic syntax *}

 text {*

   \begin{tabular}{ll}

     @{command "fix"}~@{text x} & augment context by @{text "\<And>x. \<box>"} \\

     @{command "assume"}~@{text "a: \<phi>"} & augment context by @{text "\<phi> \<Longrightarrow> \<box>"} \\

     @{command "then"} & indicate forward chaining of facts \\

     @{command "have"}~@{text "a: \<phi>"} & prove local result \\

     @{command "show"}~@{text "a: \<phi>"} & prove local result, refining some goal \\

     @{command "using"}~@{text a} & indicate use of additional facts \\

     @{command "unfolding"}~@{text a} & unfold definitional equations \\

     @{command "proof"}~@{text "m\<^sub>1"}~\dots~@{command "qed"}~@{text "m\<^sub>2"} & indicate proof structure and refinements \\

     @{command "{"}~\dots~@{command "}"} & indicate explicit blocks \\

     @{command "next"} & switch blocks \\

     @{command "note"}~@{text "a = b"} & reconsider facts \\

     @{command "let"}~@{text "p = t"} & abbreviate terms by higher-order matching \\

   \end{tabular}

   \begin{matharray}{rcl}

     @{text "theory\<dash>stmt"} & = & @{command "theorem"}~@{text "name: prop proof"} \Or @{command "definition"}~\dots \Or \dots \\[1ex]

     @{text "proof"} & = & @{text "prfx\<^sup>*"}~@{command "proof"}~@{text "method stmt\<^sup>*"}~@{command "qed"}~@{text method} \\

     & \Or & @{text "prfx\<^sup>*"}~@{command "done"} \\[1ex]

     @{text prfx} & = & @{command "apply"}~@{text method} \\

     & \Or & @{command "using"}~@{text "name\<^sup>+"} \\

     & \Or & @{command "unfolding"}~@{text "name\<^sup>+"} \\

     @{text stmt} & = & @{command "{"}~@{text "stmt\<^sup>*"}~@{command "}"} \\

     & \Or & @{command "next"} \\

     & \Or & @{command "note"}~@{text "name = name\<^sup>+"} \\

     & \Or & @{command "let"}~@{text "term = term"} \\

     & \Or & @{command "fix"}~@{text "var\<^sup>+"} \\

     & \Or & @{command "assume"}~@{text "name: prop\<^sup>+"} \\

     & \Or & @{command "then"}@{text "\<^sup>?"}~@{text goal} \\

     @{text goal} & = & @{command "have"}~@{text "name: prop\<^sup>+ proof"} \\

     & \Or & @{command "show"}~@{text "name: prop\<^sup>+ proof"} \\

   \end{matharray}

 *}

 subsection {* Abbreviations and synonyms *}

 text {*

   \begin{matharray}{rcl}

     @{command "by"}~@{text "m\<^sub>1 m\<^sub>2"} & \equiv & @{command "proof"}~@{text "m\<^sub>1"}~@{command "qed"}~@{text "m\<^sub>2"} \\

     @{command ".."} & \equiv & @{command "by"}~@{text rule} \\

     @{command "."} & \equiv & @{command "by"}~@{text this} \\

     @{command "hence"} & \equiv & @{command "then"}~@{command "have"} \\

     @{command "thus"} & \equiv & @{command "then"}~@{command "show"} \\

     @{command "from"}~@{text a} & \equiv & @{command "note"}~@{text a}~@{command "then"} \\

     @{command "with"}~@{text a} & \equiv & @{command "from"}~@{text "a \<AND> this"} \\[1ex]

     @{command "from"}~@{text this} & \equiv & @{command "then"} \\

     @{command "from"}~@{text this}~@{command "have"} & \equiv & @{command "hence"} \\

     @{command "from"}~@{text this}~@{command "show"} & \equiv & @{command "thus"} \\

   \end{matharray}

 *}

 subsection {* Derived elements *}

 text {*

   \begin{matharray}{rcl}

     @{command "also"}@{text "\<^sub>0"} & \approx & @{command "note"}~@{text "calculation = this"} \\

     @{command "also"}@{text "\<^sub>n\<^sub>+\<^sub>1"} & \approx & @{command "note"}~@{text "calculation = trans [OF calculation this]"} \\

     @{command "finally"} & \approx & @{command "also"}~@{command "from"}~@{text calculation} \\[0.5ex]

     @{command "moreover"} & \approx & @{command "note"}~@{text "calculation = calculation this"} \\

     @{command "ultimately"} & \approx & @{command "moreover"}~@{command "from"}~@{text calculation} \\[0.5ex]

     @{command "presume"}~@{text "a: \<phi>"} & \approx & @{command "assume"}~@{text "a: \<phi>"} \\

     @{command "def"}~@{text "a: x \<equiv> t"} & \approx & @{command "fix"}~@{text x}~@{command "assume"}~@{text "a: x \<equiv> t"} \\

     @{command "obtain"}~@{text "x \<WHERE> a: \<phi>"} & \approx & \dots~@{command "fix"}~@{text x}~@{command "assume"}~@{text "a: \<phi>"} \\

     @{command "case"}~@{text c} & \approx & @{command "fix"}~@{text x}~@{command "assume"}~@{text "c: \<phi>"} \\

     @{command "sorry"} & \approx & @{command "by"}~@{text cheating} \\

   \end{matharray}

 *}

 subsection {* Diagnostic commands *}

 text {*

   \begin{tabular}{ll}

     @{command "pr"} & print current state \\

     @{command "thm"}~@{text a} & print fact \\

     @{command "term"}~@{text t} & print term \\

     @{command "prop"}~@{text \<phi>} & print meta-level proposition \\

     @{command "typ"}~@{text \<tau>} & print meta-level type \\

   \end{tabular}

 *}

 section {* Proof methods *}

 text {*

   \begin{tabular}{ll}

     \multicolumn{2}{l}{\textbf{Single steps (forward-chaining facts)}} \\[0.5ex]

     @{method assumption} & apply some assumption \\

     @{method this} & apply current facts \\

     @{method rule}~@{text a} & apply some rule  \\

     @{method rule} & apply standard rule (default for @{command "proof"}) \\

     @{method contradiction} & apply @{text "\<not>"} elimination rule (any order) \\

     @{method cases}~@{text t} & case analysis (provides cases) \\

     @{method induct}~@{text x} & proof by induction (provides cases) \\[2ex]

     \multicolumn{2}{l}{\textbf{Repeated steps (inserting facts)}} \\[0.5ex]

     @{method "-"} & no rules \\

     @{method intro}~@{text a} & introduction rules \\

     @{method intro_classes} & class introduction rules \\

     @{method elim}~@{text a} & elimination rules \\

     @{method unfold}~@{text a} & definitional rewrite rules \\[2ex]

     \multicolumn{2}{l}{\textbf{Automated proof tools (inserting facts)}} \\[0.5ex]

     @{method iprover} & intuitionistic proof search \\

     @{method blast}, @{method fast} & Classical Reasoner \\

     @{method simp}, @{method simp_all} & Simplifier (+ Splitter) \\

     @{method auto}, @{method force} & Simplifier + Classical Reasoner \\

     @{method arith} & Arithmetic procedures \\

   \end{tabular}

 *}

 section {* Attributes *}

 text {*

   \begin{tabular}{ll}

     \multicolumn{2}{l}{\textbf{Operations}} \\[0.5ex]

     @{attribute OF}~@{text a} & rule resolved with facts (skipping ``@{text _}'') \\

     @{attribute of}~@{text t} & rule instantiated with terms (skipping ``@{text _}'') \\

     @{attribute "where"}~@{text "x = t"} & rule instantiated with terms, by variable name \\

     @{attribute symmetric} & resolution with symmetry rule \\

     @{attribute THEN}~@{text b} & resolution with another rule \\

     @{attribute rule_format} & result put into standard rule format \\

     @{attribute elim_format} & destruct rule turned into elimination rule format \\[1ex]

     \multicolumn{2}{l}{\textbf{Declarations}} \\[0.5ex]

     @{attribute simp} & Simplifier rule \\

     @{attribute intro}, @{attribute elim}, @{attribute dest} & Pure or Classical Reasoner rule \\

     @{attribute iff} & Simplifier + Classical Reasoner rule \\

     @{attribute split} & case split rule \\

     @{attribute trans} & transitivity rule \\

     @{attribute sym} & symmetry rule \\

   \end{tabular}

 *}

 section {* Rule declarations and methods *}

 text {*

   \begin{tabular}{l|lllll}

       & @{method rule} & @{method iprover} & @{method blast} & @{method simp} & @{method auto} \\

       &                &                   & @{method fast} & @{method simp_all} & @{method force} \\

     \hline

     @{attribute Pure.elim}@{text "!"} @{attribute Pure.intro}@{text "!"}

       & @{text "\<times>"}    & @{text "\<times>"} \\

     @{attribute Pure.elim} @{attribute Pure.intro}

       & @{text "\<times>"}    & @{text "\<times>"} \\

     @{attribute elim}@{text "!"} @{attribute intro}@{text "!"}

       & @{text "\<times>"}    &                    & @{text "\<times>"}          &                     & @{text "\<times>"} \\

     @{attribute elim} @{attribute intro}

       & @{text "\<times>"}    &                    & @{text "\<times>"}          &                     & @{text "\<times>"} \\

     @{attribute iff}

       & @{text "\<times>"}    &                    & @{text "\<times>"}          & @{text "\<times>"}         & @{text "\<times>"} \\

     @{attribute iff}@{text "?"}

       & @{text "\<times>"} \\

     @{attribute elim}@{text "?"} @{attribute intro}@{text "?"}

       & @{text "\<times>"} \\

     @{attribute simp}

       &                &                    &                      & @{text "\<times>"}         & @{text "\<times>"} \\

     @{attribute cong}

       &                &                    &                      & @{text "\<times>"}         & @{text "\<times>"} \\

     @{attribute split}

       &                &                    &                      & @{text "\<times>"}         & @{text "\<times>"} \\

   \end{tabular}

 *}

 section {* Emulating tactic scripts *}

 subsection {* Commands *}

 text {*

   \begin{tabular}{ll}

     @{command "apply"}~@{text m} & apply proof method at initial position \\

     @{command "apply_end"}~@{text m} & apply proof method near terminal position \\

     @{command "done"} & complete proof \\

     @{command "defer"}~@{text n} & move subgoal to end \\

     @{command "prefer"}~@{text n} & move subgoal to beginning \\

     @{command "back"} & backtrack last command \\

   \end{tabular}

 *}

 subsection {* Methods *}

 text {*

   \begin{tabular}{ll}

     @{method rule_tac}~@{text insts} & resolution (with instantiation) \\

     @{method erule_tac}~@{text insts} & elim-resolution (with instantiation) \\

     @{method drule_tac}~@{text insts} & destruct-resolution (with instantiation) \\

     @{method frule_tac}~@{text insts} & forward-resolution (with instantiation) \\

     @{method cut_tac}~@{text insts} & insert facts (with instantiation) \\

     @{method thin_tac}~@{text \<phi>} & delete assumptions \\

     @{method subgoal_tac}~@{text \<phi>} & new claims \\

     @{method rename_tac}~@{text x} & rename innermost goal parameters \\

     @{method rotate_tac}~@{text n} & rotate assumptions of goal \\

     @{method tactic}~@{text "text"} & arbitrary ML tactic \\

     @{method case_tac}~@{text t} & exhaustion (datatypes) \\

     @{method induct_tac}~@{text x} & induction (datatypes) \\

     @{method ind_cases}~@{text t} & exhaustion + simplification (inductive predicates) \\

   \end{tabular}

 *}

 end