# HG changeset patch
# User wenzelm
# Date 1404240231 -7200
# Node ID fa14d60a8cca6ba6c70327d71c2d943cb43907d2
# Parent  c3b5cb53ea794caaec6b316c6e31b1935bb54a51
more on ML options;
suppress somewhat old Pretty.margin_default;

diff -r c3b5cb53ea79 -r fa14d60a8cca src/Doc/Isar_Ref/Inner_Syntax.thy
--- a/src/Doc/Isar_Ref/Inner_Syntax.thy	Tue Jul 01 17:59:56 2014 +0200
+++ b/src/Doc/Isar_Ref/Inner_Syntax.thy	Tue Jul 01 20:43:51 2014 +0200
@@ -315,35 +315,6 @@
 *}
 
 
-subsection {* Printing limits *}
-
-text {*
-  \begin{mldecls}
-    @{index_ML Pretty.margin_default: "int Unsynchronized.ref"} \\
-  \end{mldecls}
-
-  \begin{tabular}{rcll}
-    @{attribute_def ML_print_depth} & : & @{text attribute} & default 10 \\ %FIXME move?
-  \end{tabular}
-
-  \begin{description}
-
-  \item @{ML Pretty.margin_default} indicates the global default for
-  the right margin of the built-in pretty printer, with initial value
-  76.  Note that user-interfaces typically control margins
-  automatically when resizing windows, or even bypass the formatting
-  engine of Isabelle/ML altogether and do it within the front end via
-  Isabelle/Scala.
-
-  \item @{attribute ML_print_depth} limits the printing depth of the
-  ML toplevel pretty printer; the precise effect depends on the ML
-  compiler and run-time system.  Typically the limit should be less
-  than 10.  Bigger values such as 100--1000 are useful for debugging.
-
-  \end{description}
-*}
-
-
 section {* Mixfix annotations \label{sec:mixfix} *}
 
 text {* Mixfix annotations specify concrete \emph{inner syntax} of
diff -r c3b5cb53ea79 -r fa14d60a8cca src/Doc/Isar_Ref/Spec.thy
--- a/src/Doc/Isar_Ref/Spec.thy	Tue Jul 01 17:59:56 2014 +0200
+++ b/src/Doc/Isar_Ref/Spec.thy	Tue Jul 01 20:43:51 2014 +0200
@@ -1010,6 +1010,11 @@
     @{command_def "local_setup"} & : & @{text "local_theory \<rightarrow> local_theory"} \\
     @{command_def "attribute_setup"} & : & @{text "theory \<rightarrow> theory"} \\
   \end{matharray}
+  \begin{tabular}{rcll}
+    @{attribute_def ML_print_depth} & : & @{text attribute} & default 10 \\
+    @{attribute_def ML_source_trace} & : & @{text attribute} & default @{text false} \\
+    @{attribute_def ML_exception_trace} & : & @{text attribute} & default @{text false} \\
+  \end{tabular}
 
   @{rail \<open>
     (@@{command SML_file} | @@{command ML_file}) @{syntax name}
@@ -1091,6 +1096,33 @@
           let val context' = context
           in context' end)) *}
 
+text {*
+  \begin{description}
+
+  \item @{attribute ML_print_depth} controls the printing depth of the ML
+  toplevel pretty printer; the precise effect depends on the ML compiler and
+  run-time system. Typically the limit should be less than 10. Bigger values
+  such as 100--1000 are occasionally useful for debugging.
+
+  \item @{attribute ML_source_trace} indicates whether the source text that
+  is given to the ML compiler should be output: it shows the raw Standard ML
+  after expansion of Isabelle/ML antiquotations.
+
+  \item @{attribute ML_exception_trace} indicates whether the ML run-time
+  system should print a detailed stack trace on exceptions. The result is
+  dependent on the particular ML compiler version. Note that after Poly/ML
+  5.3 some optimizations in the run-time systems may hinder exception
+  traces.
+
+  The boundary for the exception trace is the current Isar command
+  transactions. It is occasionally better to insert the combinator @{ML
+  Runtime.exn_trace} into ML code for debugging
+  \cite{isabelle-implementation}, closer to the point where it actually
+  happens.
+
+  \end{description}
+*}
+
 
 section {* Primitive specification elements *}