%

\begin{isabellebody}%

\def\isabellecontext{Document{\isaliteral{5F}{\isacharunderscore}}Preparation}%

%

\isadelimtheory

%

\endisadelimtheory

%

\isatagtheory

\isacommand{theory}\isamarkupfalse%

\ Document{\isaliteral{5F}{\isacharunderscore}}Preparation\isanewline

\isakeyword{imports}\ Base\ Main\isanewline

\isakeyword{begin}%

\endisatagtheory

{\isafoldtheory}%

%

\isadelimtheory

%

\endisadelimtheory

%

\isamarkupchapter{Document preparation \label{ch:document-prep}%

}

\isamarkuptrue%

%

\begin{isamarkuptext}%

Isabelle/Isar provides a simple document preparation system

  based on regular {PDF-\LaTeX} technology, with full support for

  hyper-links and bookmarks.  Thus the results are well suited for WWW

  browsing and as printed copies.

  \medskip Isabelle generates {\LaTeX} output while running a

  \emph{logic session} (see also \cite{isabelle-sys}).  Getting

  started with a working configuration for common situations is quite

  easy by using the Isabelle \verb|mkdir| and \verb|make|

  tools.  First invoke

\begin{ttbox}

  isabelle mkdir Foo

\end{ttbox}

  to initialize a separate directory for session \verb|Foo| (it

  is safe to experiment, since \verb|isabelle mkdir| never

  overwrites existing files).  Ensure that \verb|Foo/ROOT.ML|

  holds ML commands to load all theories required for this session;

  furthermore \verb|Foo/document/root.tex| should include any

  special {\LaTeX} macro packages required for your document (the

  default is usually sufficient as a start).

  The session is controlled by a separate \verb|IsaMakefile|

  (with crude source dependencies by default).  This file is located

  one level up from the \verb|Foo| directory location.  Now

  invoke

\begin{ttbox}

  isabelle make Foo

\end{ttbox}

  to run the \verb|Foo| session, with browser information and

  document preparation enabled.  Unless any errors are reported by

  Isabelle or {\LaTeX}, the output will appear inside the directory

  defined by the \verb|ISABELLE_BROWSER_INFO| setting (as

  reported by the batch job in verbose mode).

  \medskip You may also consider to tune the \verb|usedir|

  options in \verb|IsaMakefile|, for example to switch the output

  format between \verb|pdf| and \verb|dvi|, or activate the

  \verb|-D| option to retain a second copy of the generated

  {\LaTeX} sources (for manual inspection or separate runs of

  \hyperlink{executable.latex}{\mbox{\isa{\isatt{latex}}}}).

  \medskip See \emph{The Isabelle System Manual} \cite{isabelle-sys}

  for further details on Isabelle logic sessions and theory

  presentation.  The Isabelle/HOL tutorial \cite{isabelle-hol-book}

  also covers theory presentation to some extent.%

\end{isamarkuptext}%

\isamarkuptrue%

%

\isamarkupsection{Markup commands \label{sec:markup}%

}

\isamarkuptrue%

%

\begin{isamarkuptext}%

\begin{matharray}{rcl}

    \indexdef{}{command}{header}\hypertarget{command.header}{\hyperlink{command.header}{\mbox{\isa{\isacommand{header}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}toplevel\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ toplevel{\isaliteral{22}{\isachardoublequote}}} \\[0.5ex]

    \indexdef{}{command}{chapter}\hypertarget{command.chapter}{\hyperlink{command.chapter}{\mbox{\isa{\isacommand{chapter}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\

    \indexdef{}{command}{section}\hypertarget{command.section}{\hyperlink{command.section}{\mbox{\isa{\isacommand{section}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\

    \indexdef{}{command}{subsection}\hypertarget{command.subsection}{\hyperlink{command.subsection}{\mbox{\isa{\isacommand{subsection}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\

    \indexdef{}{command}{subsubsection}\hypertarget{command.subsubsection}{\hyperlink{command.subsubsection}{\mbox{\isa{\isacommand{subsubsection}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\

    \indexdef{}{command}{text}\hypertarget{command.text}{\hyperlink{command.text}{\mbox{\isa{\isacommand{text}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\

    \indexdef{}{command}{text\_raw}\hypertarget{command.text-raw}{\hyperlink{command.text-raw}{\mbox{\isa{\isacommand{text{\isaliteral{5F}{\isacharunderscore}}raw}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}local{\isaliteral{5F}{\isacharunderscore}}theory\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ local{\isaliteral{5F}{\isacharunderscore}}theory{\isaliteral{22}{\isachardoublequote}}} \\[0.5ex]

    \indexdef{}{command}{sect}\hypertarget{command.sect}{\hyperlink{command.sect}{\mbox{\isa{\isacommand{sect}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{22}{\isachardoublequote}}} \\

    \indexdef{}{command}{subsect}\hypertarget{command.subsect}{\hyperlink{command.subsect}{\mbox{\isa{\isacommand{subsect}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{22}{\isachardoublequote}}} \\

    \indexdef{}{command}{subsubsect}\hypertarget{command.subsubsect}{\hyperlink{command.subsubsect}{\mbox{\isa{\isacommand{subsubsect}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{22}{\isachardoublequote}}} \\

    \indexdef{}{command}{txt}\hypertarget{command.txt}{\hyperlink{command.txt}{\mbox{\isa{\isacommand{txt}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{22}{\isachardoublequote}}} \\

    \indexdef{}{command}{txt\_raw}\hypertarget{command.txt-raw}{\hyperlink{command.txt-raw}{\mbox{\isa{\isacommand{txt{\isaliteral{5F}{\isacharunderscore}}raw}}}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}proof\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}\ proof{\isaliteral{22}{\isachardoublequote}}} \\

  \end{matharray}

  Markup commands provide a structured way to insert text into the

  document generated from a theory.  Each markup command takes a

  single \hyperlink{syntax.text}{\mbox{\isa{text}}} argument, which is passed as argument to a

  corresponding {\LaTeX} macro.  The default macros provided by

  \verb|~~/lib/texinputs/isabelle.sty| can be redefined according

  to the needs of the underlying document and {\LaTeX} styles.

  Note that formal comments (\secref{sec:comments}) are similar to

  markup commands, but have a different status within Isabelle/Isar

  syntax.

  \begin{railoutput}

\rail@begin{5}{}

\rail@bar

\rail@term{\hyperlink{command.chapter}{\mbox{\isa{\isacommand{chapter}}}}}[]

\rail@nextbar{1}

\rail@term{\hyperlink{command.section}{\mbox{\isa{\isacommand{section}}}}}[]

\rail@nextbar{2}

\rail@term{\hyperlink{command.subsection}{\mbox{\isa{\isacommand{subsection}}}}}[]

\rail@nextbar{3}

\rail@term{\hyperlink{command.subsubsection}{\mbox{\isa{\isacommand{subsubsection}}}}}[]

\rail@nextbar{4}

\rail@term{\hyperlink{command.text}{\mbox{\isa{\isacommand{text}}}}}[]

\rail@endbar

\rail@bar

\rail@nextbar{1}

\rail@nont{\hyperlink{syntax.target}{\mbox{\isa{target}}}}[]

\rail@endbar

\rail@nont{\hyperlink{syntax.text}{\mbox{\isa{text}}}}[]

\rail@end

\rail@begin{7}{}

\rail@bar

\rail@term{\hyperlink{command.header}{\mbox{\isa{\isacommand{header}}}}}[]

\rail@nextbar{1}

\rail@term{\hyperlink{command.text-raw}{\mbox{\isa{\isacommand{text{\isaliteral{5F}{\isacharunderscore}}raw}}}}}[]

\rail@nextbar{2}

\rail@term{\hyperlink{command.sect}{\mbox{\isa{\isacommand{sect}}}}}[]

\rail@nextbar{3}

\rail@term{\hyperlink{command.subsect}{\mbox{\isa{\isacommand{subsect}}}}}[]

\rail@nextbar{4}

\rail@term{\hyperlink{command.subsubsect}{\mbox{\isa{\isacommand{subsubsect}}}}}[]

\rail@nextbar{5}

\rail@term{\hyperlink{command.txt}{\mbox{\isa{\isacommand{txt}}}}}[]

\rail@nextbar{6}

\rail@term{\hyperlink{command.txt-raw}{\mbox{\isa{\isacommand{txt{\isaliteral{5F}{\isacharunderscore}}raw}}}}}[]

\rail@endbar

\rail@nont{\hyperlink{syntax.text}{\mbox{\isa{text}}}}[]

\rail@end

\end{railoutput}

  \begin{description}

  \item \hyperlink{command.header}{\mbox{\isa{\isacommand{header}}}} provides plain text markup just preceding

  the formal beginning of a theory.  The corresponding {\LaTeX} macro

  is \verb|\isamarkupheader|, which acts like \hyperlink{command.section}{\mbox{\isa{\isacommand{section}}}} by default.

  \item \hyperlink{command.chapter}{\mbox{\isa{\isacommand{chapter}}}}, \hyperlink{command.section}{\mbox{\isa{\isacommand{section}}}}, \hyperlink{command.subsection}{\mbox{\isa{\isacommand{subsection}}}},

  and \hyperlink{command.subsubsection}{\mbox{\isa{\isacommand{subsubsection}}}} mark chapter and section headings

  within the main theory body or local theory targets.  The

  corresponding {\LaTeX} macros are \verb|\isamarkupchapter|,

  \verb|\isamarkupsection|, \verb|\isamarkupsubsection| etc.

  \item \hyperlink{command.sect}{\mbox{\isa{\isacommand{sect}}}}, \hyperlink{command.subsect}{\mbox{\isa{\isacommand{subsect}}}}, and \hyperlink{command.subsubsect}{\mbox{\isa{\isacommand{subsubsect}}}}

  mark section headings within proofs.  The corresponding {\LaTeX}

  macros are \verb|\isamarkupsect|, \verb|\isamarkupsubsect| etc.

  \item \hyperlink{command.text}{\mbox{\isa{\isacommand{text}}}} and \hyperlink{command.txt}{\mbox{\isa{\isacommand{txt}}}} specify paragraphs of plain

  text.  This corresponds to a {\LaTeX} environment \verb|\begin{isamarkuptext}| \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{22}{\isachardoublequote}}} \verb|\end{isamarkuptext}| etc.

  \item \hyperlink{command.text-raw}{\mbox{\isa{\isacommand{text{\isaliteral{5F}{\isacharunderscore}}raw}}}} and \hyperlink{command.txt-raw}{\mbox{\isa{\isacommand{txt{\isaliteral{5F}{\isacharunderscore}}raw}}}} insert {\LaTeX}

  source into the output, without additional markup.  Thus the full

  range of document manipulations becomes available, at the risk of

  messing up document output.

  \end{description}

  Except for \hyperlink{command.text-raw}{\mbox{\isa{\isacommand{text{\isaliteral{5F}{\isacharunderscore}}raw}}}} and \hyperlink{command.txt-raw}{\mbox{\isa{\isacommand{txt{\isaliteral{5F}{\isacharunderscore}}raw}}}}, the text

  passed to any of the above markup commands may refer to formal

  entities via \emph{document antiquotations}, see also

  \secref{sec:antiq}.  These are interpreted in the present theory or

  proof context, or the named \isa{{\isaliteral{22}{\isachardoublequote}}target{\isaliteral{22}{\isachardoublequote}}}.

  \medskip The proof markup commands closely resemble those for theory

  specifications, but have a different formal status and produce

  different {\LaTeX} macros.  The default definitions coincide for

  analogous commands such as \hyperlink{command.section}{\mbox{\isa{\isacommand{section}}}} and \hyperlink{command.sect}{\mbox{\isa{\isacommand{sect}}}}.%

\end{isamarkuptext}%

\isamarkuptrue%

%

\isamarkupsection{Document Antiquotations \label{sec:antiq}%

}

\isamarkuptrue%

%

\begin{isamarkuptext}%

\begin{matharray}{rcl}

    \indexdef{}{antiquotation}{theory}\hypertarget{antiquotation.theory}{\hyperlink{antiquotation.theory}{\mbox{\isa{theory}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{thm}\hypertarget{antiquotation.thm}{\hyperlink{antiquotation.thm}{\mbox{\isa{thm}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{lemma}\hypertarget{antiquotation.lemma}{\hyperlink{antiquotation.lemma}{\mbox{\isa{lemma}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{prop}\hypertarget{antiquotation.prop}{\hyperlink{antiquotation.prop}{\mbox{\isa{prop}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{term}\hypertarget{antiquotation.term}{\hyperlink{antiquotation.term}{\mbox{\isa{term}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{term\_type}\hypertarget{antiquotation.term-type}{\hyperlink{antiquotation.term-type}{\mbox{\isa{term{\isaliteral{5F}{\isacharunderscore}}type}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{typeof}\hypertarget{antiquotation.typeof}{\hyperlink{antiquotation.typeof}{\mbox{\isa{typeof}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{const}\hypertarget{antiquotation.const}{\hyperlink{antiquotation.const}{\mbox{\isa{const}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{abbrev}\hypertarget{antiquotation.abbrev}{\hyperlink{antiquotation.abbrev}{\mbox{\isa{abbrev}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{typ}\hypertarget{antiquotation.typ}{\hyperlink{antiquotation.typ}{\mbox{\isa{typ}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{type}\hypertarget{antiquotation.type}{\hyperlink{antiquotation.type}{\mbox{\isa{type}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{class}\hypertarget{antiquotation.class}{\hyperlink{antiquotation.class}{\mbox{\isa{class}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{text}\hypertarget{antiquotation.text}{\hyperlink{antiquotation.text}{\mbox{\isa{text}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{goals}\hypertarget{antiquotation.goals}{\hyperlink{antiquotation.goals}{\mbox{\isa{goals}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{subgoals}\hypertarget{antiquotation.subgoals}{\hyperlink{antiquotation.subgoals}{\mbox{\isa{subgoals}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{prf}\hypertarget{antiquotation.prf}{\hyperlink{antiquotation.prf}{\mbox{\isa{prf}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{full\_prf}\hypertarget{antiquotation.full-prf}{\hyperlink{antiquotation.full-prf}{\mbox{\isa{full{\isaliteral{5F}{\isacharunderscore}}prf}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{ML}\hypertarget{antiquotation.ML}{\hyperlink{antiquotation.ML}{\mbox{\isa{ML}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{ML\_type}\hypertarget{antiquotation.ML-type}{\hyperlink{antiquotation.ML-type}{\mbox{\isa{ML{\isaliteral{5F}{\isacharunderscore}}type}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{ML\_struct}\hypertarget{antiquotation.ML-struct}{\hyperlink{antiquotation.ML-struct}{\mbox{\isa{ML{\isaliteral{5F}{\isacharunderscore}}struct}}}} & : & \isa{antiquotation} \\

    \indexdef{}{antiquotation}{file}\hypertarget{antiquotation.file}{\hyperlink{antiquotation.file}{\mbox{\isa{file}}}} & : & \isa{antiquotation} \\

  \end{matharray}

  The overall content of an Isabelle/Isar theory may alternate between

  formal and informal text.  The main body consists of formal

  specification and proof commands, interspersed with markup commands

  (\secref{sec:markup}) or document comments (\secref{sec:comments}).

  The argument of markup commands quotes informal text to be printed

  in the resulting document, but may again refer to formal entities

  via \emph{document antiquotations}.

  For example, embedding of ``\isa{{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}term\ {\isaliteral{5B}{\isacharbrackleft}}show{\isaliteral{5F}{\isacharunderscore}}types{\isaliteral{5D}{\isacharbrackright}}\ {\isaliteral{22}{\isachardoublequote}}f\ x\ {\isaliteral{3D}{\isacharequal}}\ a\ {\isaliteral{2B}{\isacharplus}}\ x{\isaliteral{22}{\isachardoublequote}}{\isaliteral{7D}{\isacharbraceright}}}''

  within a text block makes

  \isa{{\isacharparenleft}f{\isasymColon}{\isacharprime}a\ {\isasymRightarrow}\ {\isacharprime}a{\isacharparenright}\ {\isacharparenleft}x{\isasymColon}{\isacharprime}a{\isacharparenright}\ {\isacharequal}\ {\isacharparenleft}a{\isasymColon}{\isacharprime}a{\isacharparenright}\ {\isacharplus}\ x} appear in the final {\LaTeX} document.

  Antiquotations usually spare the author tedious typing of logical

  entities in full detail.  Even more importantly, some degree of

  consistency-checking between the main body of formal text and its

  informal explanation is achieved, since terms and types appearing in

  antiquotations are checked within the current theory or proof

  context.

  \begin{railoutput}

\rail@begin{1}{}

\rail@term{\isa{{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}}}[]

\rail@nont{\isa{antiquotation}}[]

\rail@term{\isa{{\isaliteral{7D}{\isacharbraceright}}}}[]

\rail@end

\rail@begin{22}{\indexdef{}{syntax}{antiquotation}\hypertarget{syntax.antiquotation}{\hyperlink{syntax.antiquotation}{\mbox{\isa{antiquotation}}}}}

\rail@bar

\rail@term{\hyperlink{antiquotation.theory}{\mbox{\isa{theory}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@nextbar{1}

\rail@term{\hyperlink{antiquotation.thm}{\mbox{\isa{thm}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\isa{styles}}[]

\rail@nont{\hyperlink{syntax.thmrefs}{\mbox{\isa{thmrefs}}}}[]

\rail@nextbar{2}

\rail@term{\hyperlink{antiquotation.lemma}{\mbox{\isa{lemma}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.prop}{\mbox{\isa{prop}}}}[]

\rail@term{\isa{\isakeyword{by}}}[]

\rail@nont{\hyperlink{syntax.method}{\mbox{\isa{method}}}}[]

\rail@bar

\rail@nextbar{3}

\rail@nont{\hyperlink{syntax.method}{\mbox{\isa{method}}}}[]

\rail@endbar

\rail@nextbar{4}

\rail@term{\hyperlink{antiquotation.prop}{\mbox{\isa{prop}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\isa{styles}}[]

\rail@nont{\hyperlink{syntax.prop}{\mbox{\isa{prop}}}}[]

\rail@nextbar{5}

\rail@term{\hyperlink{antiquotation.term}{\mbox{\isa{term}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\isa{styles}}[]

\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]

\rail@nextbar{6}

\rail@term{\hyperlink{antiquotation.term-type}{\mbox{\isa{term{\isaliteral{5F}{\isacharunderscore}}type}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\isa{styles}}[]

\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]

\rail@nextbar{7}

\rail@term{\hyperlink{antiquotation.typeof}{\mbox{\isa{typeof}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\isa{styles}}[]

\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]

\rail@nextbar{8}

\rail@term{\hyperlink{antiquotation.const}{\mbox{\isa{const}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]

\rail@nextbar{9}

\rail@term{\hyperlink{antiquotation.abbrev}{\mbox{\isa{abbrev}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.term}{\mbox{\isa{term}}}}[]

\rail@nextbar{10}

\rail@term{\hyperlink{antiquotation.typ}{\mbox{\isa{typ}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.type}{\mbox{\isa{type}}}}[]

\rail@nextbar{11}

\rail@term{\hyperlink{antiquotation.type}{\mbox{\isa{type}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@nextbar{12}

\rail@term{\hyperlink{antiquotation.class}{\mbox{\isa{class}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@nextbar{13}

\rail@term{\hyperlink{antiquotation.text}{\mbox{\isa{text}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@nextbar{14}

\rail@term{\hyperlink{antiquotation.goals}{\mbox{\isa{goals}}}}[]

\rail@nont{\isa{options}}[]

\rail@nextbar{15}

\rail@term{\hyperlink{antiquotation.subgoals}{\mbox{\isa{subgoals}}}}[]

\rail@nont{\isa{options}}[]

\rail@nextbar{16}

\rail@term{\hyperlink{antiquotation.prf}{\mbox{\isa{prf}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.thmrefs}{\mbox{\isa{thmrefs}}}}[]

\rail@nextbar{17}

\rail@term{\hyperlink{antiquotation.full-prf}{\mbox{\isa{full{\isaliteral{5F}{\isacharunderscore}}prf}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.thmrefs}{\mbox{\isa{thmrefs}}}}[]

\rail@nextbar{18}

\rail@term{\hyperlink{antiquotation.ML}{\mbox{\isa{ML}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@nextbar{19}

\rail@term{\hyperlink{antiquotation.ML-type}{\mbox{\isa{ML{\isaliteral{5F}{\isacharunderscore}}type}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@nextbar{20}

\rail@term{\hyperlink{antiquotation.ML-struct}{\mbox{\isa{ML{\isaliteral{5F}{\isacharunderscore}}struct}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@nextbar{21}

\rail@term{\hyperlink{antiquotation.file}{\mbox{\isa{file}}}}[]

\rail@nont{\isa{options}}[]

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@endbar

\rail@end

\rail@begin{3}{\isa{options}}

\rail@term{\isa{{\isaliteral{5B}{\isacharbrackleft}}}}[]

\rail@bar

\rail@nextbar{1}

\rail@plus

\rail@nont{\isa{option}}[]

\rail@nextplus{2}

\rail@cterm{\isa{{\isaliteral{2C}{\isacharcomma}}}}[]

\rail@endplus

\rail@endbar

\rail@term{\isa{{\isaliteral{5D}{\isacharbrackright}}}}[]

\rail@end

\rail@begin{2}{\isa{option}}

\rail@bar

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@nextbar{1}

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@term{\isa{{\isaliteral{3D}{\isacharequal}}}}[]

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@endbar

\rail@end

\rail@begin{2}{\isa{styles}}

\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]

\rail@plus

\rail@nont{\isa{style}}[]

\rail@nextplus{1}

\rail@cterm{\isa{{\isaliteral{2C}{\isacharcomma}}}}[]

\rail@endplus

\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]

\rail@end

\rail@begin{2}{\isa{style}}

\rail@plus

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@nextplus{1}

\rail@endplus

\rail@end

\end{railoutput}

  Note that the syntax of antiquotations may \emph{not} include source

  comments \verb|(*|~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{22}{\isachardoublequote}}}~\verb|*)| nor verbatim

  text \verb|{|\verb|*|~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{22}{\isachardoublequote}}}~\verb|*|\verb|}|.

  \begin{description}

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}theory\ A{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints the name \isa{{\isaliteral{22}{\isachardoublequote}}A{\isaliteral{22}{\isachardoublequote}}}, which is

  guaranteed to refer to a valid ancestor theory in the current

  context.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}thm\ a\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ a\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints theorems \isa{{\isaliteral{22}{\isachardoublequote}}a\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ a\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{22}{\isachardoublequote}}}.

  Full fact expressions are allowed here, including attributes

  (\secref{sec:syn-att}).

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}prop\ {\isaliteral{5C3C7068693E}{\isasymphi}}{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints a well-typed proposition \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7068693E}{\isasymphi}}{\isaliteral{22}{\isachardoublequote}}}.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}lemma\ {\isaliteral{5C3C7068693E}{\isasymphi}}\ by\ m{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} proves a well-typed proposition

  \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7068693E}{\isasymphi}}{\isaliteral{22}{\isachardoublequote}}} by method \isa{m} and prints the original \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7068693E}{\isasymphi}}{\isaliteral{22}{\isachardoublequote}}}.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}term\ t{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints a well-typed term \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{22}{\isachardoublequote}}}.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}term{\isaliteral{5F}{\isacharunderscore}}type\ t{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints a well-typed term \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{22}{\isachardoublequote}}}

  annotated with its type.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}typeof\ t{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints the type of a well-typed term

  \isa{{\isaliteral{22}{\isachardoublequote}}t{\isaliteral{22}{\isachardoublequote}}}.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}const\ c{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints a logical or syntactic constant

  \isa{{\isaliteral{22}{\isachardoublequote}}c{\isaliteral{22}{\isachardoublequote}}}.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}abbrev\ c\ x\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ x\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints a constant abbreviation

  \isa{{\isaliteral{22}{\isachardoublequote}}c\ x\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ x\isaliteral{5C3C5E7375623E}{}\isactrlsub n\ {\isaliteral{5C3C65717569763E}{\isasymequiv}}\ rhs{\isaliteral{22}{\isachardoublequote}}} as defined in the current context.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}typ\ {\isaliteral{5C3C7461753E}{\isasymtau}}{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints a well-formed type \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C7461753E}{\isasymtau}}{\isaliteral{22}{\isachardoublequote}}}.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}type\ {\isaliteral{5C3C6B617070613E}{\isasymkappa}}{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints a (logical or syntactic) type

    constructor \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{5C3C6B617070613E}{\isasymkappa}}{\isaliteral{22}{\isachardoublequote}}}.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}class\ c{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints a class \isa{c}.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}text\ s{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints uninterpreted source text \isa{s}.  This is particularly useful to print portions of text according

  to the Isabelle document style, without demanding well-formedness,

  e.g.\ small pieces of terms that should not be parsed or

  type-checked yet.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}goals{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints the current \emph{dynamic} goal

  state.  This is mainly for support of tactic-emulation scripts

  within Isar.  Presentation of goal states does not conform to the

  idea of human-readable proof documents!

  When explaining proofs in detail it is usually better to spell out

  the reasoning via proper Isar proof commands, instead of peeking at

  the internal machine configuration.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}subgoals{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} is similar to \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}goals{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}}, but

  does not print the main goal.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}prf\ a\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ a\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} prints the (compact) proof terms

  corresponding to the theorems \isa{{\isaliteral{22}{\isachardoublequote}}a\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ a\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{22}{\isachardoublequote}}}. Note that this

  requires proof terms to be switched on for the current logic

  session.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}full{\isaliteral{5F}{\isacharunderscore}}prf\ a\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ a\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} is like \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}prf\ a\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ a\isaliteral{5C3C5E7375623E}{}\isactrlsub n{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}}, but prints the full proof terms, i.e.\ also displays

  information omitted in the compact proof term, which is denoted by

  ``\isa{{\isaliteral{5F}{\isacharunderscore}}}'' placeholders there.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}ML\ s{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}}, \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}ML{\isaliteral{5F}{\isacharunderscore}}type\ s{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}}, and \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}ML{\isaliteral{5F}{\isacharunderscore}}struct\ s{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} check text \isa{s} as ML value, type, and

  structure, respectively.  The source is printed verbatim.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{40}{\isacharat}}{\isaliteral{7B}{\isacharbraceleft}}file\ path{\isaliteral{7D}{\isacharbraceright}}{\isaliteral{22}{\isachardoublequote}}} checks that \isa{{\isaliteral{22}{\isachardoublequote}}path{\isaliteral{22}{\isachardoublequote}}} refers to a

  file (or directory) and prints it verbatim.

  \end{description}%

\end{isamarkuptext}%

\isamarkuptrue%

%

\isamarkupsubsubsection{Styled antiquotations%

}

\isamarkuptrue%

%

\begin{isamarkuptext}%

The antiquotations \isa{thm}, \isa{prop} and \isa{term} admit an extra \emph{style} specification to modify the

  printed result.  A style is specified by a name with a possibly

  empty number of arguments;  multiple styles can be sequenced with

  commas.  The following standard styles are available:

  \begin{description}

  \item \isa{lhs} extracts the first argument of any application

  form with at least two arguments --- typically meta-level or

  object-level equality, or any other binary relation.

  \item \isa{rhs} is like \isa{lhs}, but extracts the second

  argument.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}concl{\isaliteral{22}{\isachardoublequote}}} extracts the conclusion \isa{C} from a rule

  in Horn-clause normal form \isa{{\isaliteral{22}{\isachardoublequote}}A\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ A\isaliteral{5C3C5E7375623E}{}\isactrlsub n\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ C{\isaliteral{22}{\isachardoublequote}}}.

  \item \isa{{\isaliteral{22}{\isachardoublequote}}prem{\isaliteral{22}{\isachardoublequote}}} \isa{n} extract premise number

  \isa{{\isaliteral{22}{\isachardoublequote}}n{\isaliteral{22}{\isachardoublequote}}} from from a rule in Horn-clause

  normal form \isa{{\isaliteral{22}{\isachardoublequote}}A\isaliteral{5C3C5E7375623E}{}\isactrlsub {\isadigit{1}}\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ {\isaliteral{5C3C646F74733E}{\isasymdots}}\ A\isaliteral{5C3C5E7375623E}{}\isactrlsub n\ {\isaliteral{5C3C4C6F6E6772696768746172726F773E}{\isasymLongrightarrow}}\ C{\isaliteral{22}{\isachardoublequote}}}

  \end{description}%

\end{isamarkuptext}%

\isamarkuptrue%

%

\isamarkupsubsubsection{General options%

}

\isamarkuptrue%

%

\begin{isamarkuptext}%

The following options are available to tune the printed output

  of antiquotations.  Note that many of these coincide with global ML

  flags of the same names.

  \begin{description}

  \item \indexdef{}{antiquotation option}{show\_types}\hypertarget{antiquotation option.show-types}{\hyperlink{antiquotation option.show-types}{\mbox{\isa{show{\isaliteral{5F}{\isacharunderscore}}types}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}} and

  \indexdef{}{antiquotation option}{show\_sorts}\hypertarget{antiquotation option.show-sorts}{\hyperlink{antiquotation option.show-sorts}{\mbox{\isa{show{\isaliteral{5F}{\isacharunderscore}}sorts}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}} control

  printing of explicit type and sort constraints.

  \item \indexdef{}{antiquotation option}{show\_structs}\hypertarget{antiquotation option.show-structs}{\hyperlink{antiquotation option.show-structs}{\mbox{\isa{show{\isaliteral{5F}{\isacharunderscore}}structs}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}}

  controls printing of implicit structures.

  \item \indexdef{}{antiquotation option}{show\_abbrevs}\hypertarget{antiquotation option.show-abbrevs}{\hyperlink{antiquotation option.show-abbrevs}{\mbox{\isa{show{\isaliteral{5F}{\isacharunderscore}}abbrevs}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}}

  controls folding of abbreviations.

  \item \indexdef{}{antiquotation option}{long\_names}\hypertarget{antiquotation option.long-names}{\hyperlink{antiquotation option.long-names}{\mbox{\isa{long{\isaliteral{5F}{\isacharunderscore}}names}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}} forces

  names of types and constants etc.\ to be printed in their fully

  qualified internal form.

  \item \indexdef{}{antiquotation option}{short\_names}\hypertarget{antiquotation option.short-names}{\hyperlink{antiquotation option.short-names}{\mbox{\isa{short{\isaliteral{5F}{\isacharunderscore}}names}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}}

  forces names of types and constants etc.\ to be printed unqualified.

  Note that internalizing the output again in the current context may

  well yield a different result.

  \item \indexdef{}{antiquotation option}{unique\_names}\hypertarget{antiquotation option.unique-names}{\hyperlink{antiquotation option.unique-names}{\mbox{\isa{unique{\isaliteral{5F}{\isacharunderscore}}names}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}}

  determines whether the printed version of qualified names should be

  made sufficiently long to avoid overlap with names declared further

  back.  Set to \isa{false} for more concise output.

  \item \indexdef{}{antiquotation option}{eta\_contract}\hypertarget{antiquotation option.eta-contract}{\hyperlink{antiquotation option.eta-contract}{\mbox{\isa{eta{\isaliteral{5F}{\isacharunderscore}}contract}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}}

  prints terms in \isa{{\isaliteral{5C3C6574613E}{\isasymeta}}}-contracted form.

  \item \indexdef{}{antiquotation option}{display}\hypertarget{antiquotation option.display}{\hyperlink{antiquotation option.display}{\mbox{\isa{display}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}} indicates

  if the text is to be output as multi-line ``display material'',

  rather than a small piece of text without line breaks (which is the

  default).

  In this mode the embedded entities are printed in the same style as

  the main theory text.

  \item \indexdef{}{antiquotation option}{break}\hypertarget{antiquotation option.break}{\hyperlink{antiquotation option.break}{\mbox{\isa{break}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}} controls

  line breaks in non-display material.

  \item \indexdef{}{antiquotation option}{quotes}\hypertarget{antiquotation option.quotes}{\hyperlink{antiquotation option.quotes}{\mbox{\isa{quotes}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}} indicates

  if the output should be enclosed in double quotes.

  \item \indexdef{}{antiquotation option}{mode}\hypertarget{antiquotation option.mode}{\hyperlink{antiquotation option.mode}{\mbox{\isa{mode}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ name{\isaliteral{22}{\isachardoublequote}}} adds \isa{name} to the print mode to be used for presentation.  Note that the

  standard setup for {\LaTeX} output is already present by default,

  including the modes \isa{latex} and \isa{xsymbols}.

  \item \indexdef{}{antiquotation option}{margin}\hypertarget{antiquotation option.margin}{\hyperlink{antiquotation option.margin}{\mbox{\isa{margin}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ nat{\isaliteral{22}{\isachardoublequote}}} and

  \indexdef{}{antiquotation option}{indent}\hypertarget{antiquotation option.indent}{\hyperlink{antiquotation option.indent}{\mbox{\isa{indent}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ nat{\isaliteral{22}{\isachardoublequote}}} change the margin

  or indentation for pretty printing of display material.

  \item \indexdef{}{antiquotation option}{goals\_limit}\hypertarget{antiquotation option.goals-limit}{\hyperlink{antiquotation option.goals-limit}{\mbox{\isa{goals{\isaliteral{5F}{\isacharunderscore}}limit}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ nat{\isaliteral{22}{\isachardoublequote}}}

  determines the maximum number of goals to be printed (for goal-based

  antiquotation).

  \item \indexdef{}{antiquotation option}{source}\hypertarget{antiquotation option.source}{\hyperlink{antiquotation option.source}{\mbox{\isa{source}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ bool{\isaliteral{22}{\isachardoublequote}}} prints the

  original source text of the antiquotation arguments, rather than its

  internal representation.  Note that formal checking of

  \hyperlink{antiquotation.thm}{\mbox{\isa{thm}}}, \hyperlink{antiquotation.term}{\mbox{\isa{term}}}, etc. is still

  enabled; use the \hyperlink{antiquotation.text}{\mbox{\isa{text}}} antiquotation for unchecked

  output.

  Regular \isa{{\isaliteral{22}{\isachardoublequote}}term{\isaliteral{22}{\isachardoublequote}}} and \isa{{\isaliteral{22}{\isachardoublequote}}typ{\isaliteral{22}{\isachardoublequote}}} antiquotations with \isa{{\isaliteral{22}{\isachardoublequote}}source\ {\isaliteral{3D}{\isacharequal}}\ false{\isaliteral{22}{\isachardoublequote}}} involve a full round-trip from the original source

  to an internalized logical entity back to a source form, according

  to the syntax of the current context.  Thus the printed output is

  not under direct control of the author, it may even fluctuate a bit

  as the underlying theory is changed later on.

  In contrast, \hyperlink{antiquotation option.source}{\mbox{\isa{source}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{3D}{\isacharequal}}\ true{\isaliteral{22}{\isachardoublequote}}}

  admits direct printing of the given source text, with the desirable

  well-formedness check in the background, but without modification of

  the printed text.

  \end{description}

  For boolean flags, ``\isa{{\isaliteral{22}{\isachardoublequote}}name\ {\isaliteral{3D}{\isacharequal}}\ true{\isaliteral{22}{\isachardoublequote}}}'' may be abbreviated as

  ``\isa{name}''.  All of the above flags are disabled by default,

  unless changed from ML, say in the \verb|ROOT.ML| of the

  logic session.%

\end{isamarkuptext}%

\isamarkuptrue%

%

\isamarkupsection{Markup via command tags \label{sec:tags}%

}

\isamarkuptrue%

%

\begin{isamarkuptext}%

Each Isabelle/Isar command may be decorated by additional

  presentation tags, to indicate some modification in the way it is

  printed in the document.

  \begin{railoutput}

\rail@begin{2}{\indexdef{}{syntax}{tags}\hypertarget{syntax.tags}{\hyperlink{syntax.tags}{\mbox{\isa{tags}}}}}

\rail@plus

\rail@nextplus{1}

\rail@cnont{\isa{tag}}[]

\rail@endplus

\rail@end

\rail@begin{2}{\isa{tag}}

\rail@term{\isa{{\isaliteral{25}{\isacharpercent}}}}[]

\rail@bar

\rail@nont{\hyperlink{syntax.ident}{\mbox{\isa{ident}}}}[]

\rail@nextbar{1}

\rail@nont{\hyperlink{syntax.string}{\mbox{\isa{string}}}}[]

\rail@endbar

\rail@end

\end{railoutput}

  Some tags are pre-declared for certain classes of commands, serving

  as default markup if no tags are given in the text:

  \medskip

  \begin{tabular}{ll}

    \isa{{\isaliteral{22}{\isachardoublequote}}theory{\isaliteral{22}{\isachardoublequote}}} & theory begin/end \\

    \isa{{\isaliteral{22}{\isachardoublequote}}proof{\isaliteral{22}{\isachardoublequote}}} & all proof commands \\

    \isa{{\isaliteral{22}{\isachardoublequote}}ML{\isaliteral{22}{\isachardoublequote}}} & all commands involving ML code \\

  \end{tabular}

  \medskip The Isabelle document preparation system

  \cite{isabelle-sys} allows tagged command regions to be presented

  specifically, e.g.\ to fold proof texts, or drop parts of the text

  completely.

  For example ``\hyperlink{command.by}{\mbox{\isa{\isacommand{by}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{25}{\isacharpercent}}invisible\ auto{\isaliteral{22}{\isachardoublequote}}}'' causes

  that piece of proof to be treated as \isa{invisible} instead of

  \isa{{\isaliteral{22}{\isachardoublequote}}proof{\isaliteral{22}{\isachardoublequote}}} (the default), which may be shown or hidden

  depending on the document setup.  In contrast, ``\hyperlink{command.by}{\mbox{\isa{\isacommand{by}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{25}{\isacharpercent}}visible\ auto{\isaliteral{22}{\isachardoublequote}}}'' forces this text to be shown

  invariably.

  Explicit tag specifications within a proof apply to all subsequent

  commands of the same level of nesting.  For example, ``\hyperlink{command.proof}{\mbox{\isa{\isacommand{proof}}}}~\isa{{\isaliteral{22}{\isachardoublequote}}{\isaliteral{25}{\isacharpercent}}visible\ {\isaliteral{5C3C646F74733E}{\isasymdots}}{\isaliteral{22}{\isachardoublequote}}}~\hyperlink{command.qed}{\mbox{\isa{\isacommand{qed}}}}'' forces the whole

  sub-proof to be typeset as \isa{visible} (unless some of its parts

  are tagged differently).

  \medskip Command tags merely produce certain markup environments for

  type-setting.  The meaning of these is determined by {\LaTeX}

  macros, as defined in \verb|~~/lib/texinputs/isabelle.sty| or

  by the document author.  The Isabelle document preparation tools

  also provide some high-level options to specify the meaning of

  arbitrary tags to ``keep'', ``drop'', or ``fold'' the corresponding

  parts of the text.  Logic sessions may also specify ``document

  versions'', where given tags are interpreted in some particular way.

  Again see \cite{isabelle-sys} for further details.%

\end{isamarkuptext}%

\isamarkuptrue%

%

\isamarkupsection{Railroad diagrams%

}

\isamarkuptrue%

%

\begin{isamarkuptext}%

\begin{matharray}{rcl}

    \indexdef{}{antiquotation}{rail}\hypertarget{antiquotation.rail}{\hyperlink{antiquotation.rail}{\mbox{\isa{rail}}}} & : & \isa{antiquotation} \\

  \end{matharray}

  \begin{railoutput}

\rail@begin{1}{}

\rail@term{\isa{rail}}[]

\rail@nont{\isa{string}}[]

\rail@end

\end{railoutput}

  The \hyperlink{antiquotation.rail}{\mbox{\isa{rail}}} antiquotation allows to include syntax

  diagrams into Isabelle documents.  {\LaTeX} requires the style file

  \verb|~~/lib/texinputs/pdfsetup.sty|, which can be used via

  \verb|\usepackage{pdfsetup}| in \verb|root.tex|, for

  example.

  The rail specification language is quoted here as Isabelle \hyperlink{syntax.string}{\mbox{\isa{string}}}; it has its own grammar given below.

  \begin{railoutput}

\rail@begin{3}{}

\rail@plus

\rail@bar

\rail@nextbar{1}

\rail@nont{\isa{rule}}[]

\rail@endbar

\rail@nextplus{2}

\rail@cterm{\isa{{\isaliteral{3B}{\isacharsemicolon}}}}[]

\rail@endplus

\rail@end

\rail@begin{3}{\isa{rule}}

\rail@bar

\rail@nextbar{1}

\rail@bar

\rail@nont{\isa{identifier}}[]

\rail@nextbar{2}

\rail@nont{\hyperlink{syntax.antiquotation}{\mbox{\isa{antiquotation}}}}[]

\rail@endbar

\rail@term{\isa{{\isaliteral{3A}{\isacharcolon}}}}[]

\rail@endbar

\rail@nont{\isa{body}}[]

\rail@end

\rail@begin{2}{\isa{body}}

\rail@plus

\rail@nont{\isa{concatenation}}[]

\rail@nextplus{1}

\rail@cterm{\isa{{\isaliteral{7C}{\isacharbar}}}}[]

\rail@endplus

\rail@end

\rail@begin{3}{\isa{concatenation}}

\rail@plus

\rail@nont{\isa{atom}}[]

\rail@bar

\rail@nextbar{1}

\rail@term{\isa{{\isaliteral{3F}{\isacharquery}}}}[]

\rail@endbar

\rail@nextplus{2}

\rail@endplus

\rail@bar

\rail@nextbar{1}

\rail@bar

\rail@term{\isa{{\isaliteral{2A}{\isacharasterisk}}}}[]

\rail@nextbar{2}

\rail@term{\isa{{\isaliteral{2B}{\isacharplus}}}}[]

\rail@endbar

\rail@bar

\rail@nextbar{2}

\rail@nont{\isa{atom}}[]

\rail@endbar

\rail@endbar

\rail@end

\rail@begin{6}{\isa{atom}}

\rail@bar

\rail@term{\isa{{\isaliteral{28}{\isacharparenleft}}}}[]

\rail@bar

\rail@nextbar{1}

\rail@nont{\isa{body}}[]

\rail@endbar

\rail@term{\isa{{\isaliteral{29}{\isacharparenright}}}}[]

\rail@nextbar{2}

\rail@nont{\isa{identifier}}[]

\rail@nextbar{3}

\rail@bar

\rail@nextbar{4}

\rail@term{\isa{{\isaliteral{40}{\isacharat}}}}[]

\rail@endbar

\rail@bar

\rail@nont{\isa{string}}[]

\rail@nextbar{4}

\rail@nont{\hyperlink{syntax.antiquotation}{\mbox{\isa{antiquotation}}}}[]

\rail@endbar

\rail@nextbar{5}

\rail@term{\isa{{\isaliteral{5C}{\isacharbackslash}}{\isaliteral{5C}{\isacharbackslash}}}}[]

\rail@endbar

\rail@end

\end{railoutput}

  The lexical syntax of \isa{{\isaliteral{22}{\isachardoublequote}}identifier{\isaliteral{22}{\isachardoublequote}}} coincides with that of

  \hyperlink{syntax.ident}{\mbox{\isa{ident}}} in regular Isabelle syntax, but \isa{string} uses

  single quotes instead of double quotes of the standard \hyperlink{syntax.string}{\mbox{\isa{string}}} category, to avoid extra escapes.

  Each \isa{rule} defines a formal language (with optional name),

  using a notation that is similar to EBNF or regular expressions with

  recursion.  The meaning and visual appearance of these rail language

  elements is illustrated by the following representative examples.

  \begin{itemize}

  \item Empty \verb|()|

  \begin{railoutput}

\rail@begin{1}{}

\rail@end

\end{railoutput}

  \item Nonterminal \verb|A|

  \begin{railoutput}

\rail@begin{1}{}

\rail@nont{\isa{A}}[]

\rail@end

\end{railoutput}

  \item Nonterminal via Isabelle antiquotation

  \verb|@{syntax method}|

  \begin{railoutput}

\rail@begin{1}{}

\rail@nont{\hyperlink{syntax.method}{\mbox{\isa{method}}}}[]

\rail@end

\end{railoutput}

  \item Terminal \verb|'xyz'|

  \begin{railoutput}

\rail@begin{1}{}

\rail@term{\isa{xyz}}[]

\rail@end

\end{railoutput}

  \item Terminal in keyword style \verb|@'xyz'|

  \begin{railoutput}

\rail@begin{1}{}

\rail@term{\isa{\isakeyword{xyz}}}[]

\rail@end

\end{railoutput}

  \item Terminal via Isabelle antiquotation

  \verb|@@{method rule}|

  \begin{railoutput}

\rail@begin{1}{}

\rail@term{\hyperlink{method.rule}{\mbox{\isa{rule}}}}[]

\rail@end

\end{railoutput}

  \item Concatenation \verb|A B C|

  \begin{railoutput}

\rail@begin{1}{}

\rail@nont{\isa{A}}[]

\rail@nont{\isa{B}}[]

\rail@nont{\isa{C}}[]

\rail@end

\end{railoutput}

  \item Linebreak \verb|\\| inside

  concatenation\footnote{Strictly speaking, this is only a single

  backslash, but the enclosing \hyperlink{syntax.string}{\mbox{\isa{string}}} syntax requires a

  second one for escaping.} \verb|A B C \\ D E F|

  \begin{railoutput}

\rail@begin{3}{}

\rail@nont{\isa{A}}[]

\rail@nont{\isa{B}}[]

\rail@nont{\isa{C}}[]

\rail@cr{2}

\rail@nont{\isa{D}}[]

\rail@nont{\isa{E}}[]

\rail@nont{\isa{F}}[]

\rail@end

\end{railoutput}

  \item Variants \verb|A |\verb,|,\verb| B |\verb,|,\verb| C|

  \begin{railoutput}

\rail@begin{3}{}

\rail@bar

\rail@nont{\isa{A}}[]

\rail@nextbar{1}

\rail@nont{\isa{B}}[]

\rail@nextbar{2}

\rail@nont{\isa{C}}[]

\rail@endbar

\rail@end

\end{railoutput}

  \item Option \verb|A ?|

  \begin{railoutput}

\rail@begin{2}{}

\rail@bar

\rail@nextbar{1}

\rail@nont{\isa{A}}[]

\rail@endbar

\rail@end

\end{railoutput}

  \item Repetition \verb|A *|

  \begin{railoutput}

\rail@begin{2}{}

\rail@plus

\rail@nextplus{1}

\rail@cnont{\isa{A}}[]

\rail@endplus

\rail@end

\end{railoutput}

  \item Repetition with separator \verb|A * sep|

  \begin{railoutput}

\rail@begin{3}{}

\rail@bar

\rail@nextbar{1}

\rail@plus

\rail@nont{\isa{A}}[]

\rail@nextplus{2}

\rail@cnont{\isa{sep}}[]

\rail@endplus

\rail@endbar

\rail@end

\end{railoutput}

  \item Strict repetition \verb|A +|

  \begin{railoutput}

\rail@begin{2}{}

\rail@plus

\rail@nont{\isa{A}}[]

\rail@nextplus{1}

\rail@endplus

\rail@end

\end{railoutput}

  \item Strict repetition with separator \verb|A + sep|

  \begin{railoutput}

\rail@begin{2}{}

\rail@plus

\rail@nont{\isa{A}}[]

\rail@nextplus{1}

\rail@cnont{\isa{sep}}[]

\rail@endplus

\rail@end

\end{railoutput}

  \end{itemize}%

\end{isamarkuptext}%

\isamarkuptrue%

%

\isamarkupsection{Draft presentation%

}

\isamarkuptrue%

%

\begin{isamarkuptext}%

\begin{matharray}{rcl}

    \indexdef{}{command}{display\_drafts}\hypertarget{command.display-drafts}{\hyperlink{command.display-drafts}{\mbox{\isa{\isacommand{display{\isaliteral{5F}{\isacharunderscore}}drafts}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}any\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\

    \indexdef{}{command}{print\_drafts}\hypertarget{command.print-drafts}{\hyperlink{command.print-drafts}{\mbox{\isa{\isacommand{print{\isaliteral{5F}{\isacharunderscore}}drafts}}}}}\isa{{\isaliteral{22}{\isachardoublequote}}\isaliteral{5C3C5E7375703E}{}\isactrlsup {\isaliteral{2A}{\isacharasterisk}}{\isaliteral{22}{\isachardoublequote}}} & : & \isa{{\isaliteral{22}{\isachardoublequote}}any\ {\isaliteral{5C3C72696768746172726F773E}{\isasymrightarrow}}{\isaliteral{22}{\isachardoublequote}}} \\

  \end{matharray}

  \begin{railoutput}

\rail@begin{2}{}

\rail@bar

\rail@term{\hyperlink{command.display-drafts}{\mbox{\isa{\isacommand{display{\isaliteral{5F}{\isacharunderscore}}drafts}}}}}[]

\rail@nextbar{1}

\rail@term{\hyperlink{command.print-drafts}{\mbox{\isa{\isacommand{print{\isaliteral{5F}{\isacharunderscore}}drafts}}}}}[]

\rail@endbar

\rail@plus

\rail@nont{\hyperlink{syntax.name}{\mbox{\isa{name}}}}[]

\rail@nextplus{1}

\rail@endplus

\rail@end

\end{railoutput}

  \begin{description}

  \item \hyperlink{command.display-drafts}{\mbox{\isa{\isacommand{display{\isaliteral{5F}{\isacharunderscore}}drafts}}}}~\isa{paths} and \hyperlink{command.print-drafts}{\mbox{\isa{\isacommand{print{\isaliteral{5F}{\isacharunderscore}}drafts}}}}~\isa{paths} perform simple output of a given list

  of raw source files.  Only those symbols that do not require

  additional {\LaTeX} packages are displayed properly, everything else

  is left verbatim.

  \end{description}%

\end{isamarkuptext}%

\isamarkuptrue%

%

\isadelimtheory

%

\endisadelimtheory

%

\isatagtheory

\isacommand{end}\isamarkupfalse%

%

\endisatagtheory

{\isafoldtheory}%

%

\isadelimtheory

%

\endisadelimtheory

\isanewline

\end{isabellebody}%

%%% Local Variables:

%%% mode: latex

%%% TeX-master: "root"

%%% End: