# HG changeset patch
# User wenzelm
# Date 1741734762 -3600
# Node ID ff385454adaaeadcdb538ac97369ddb42163f6a4
# Parent  5a4ed4c2c72b0f857539aa6a155fa8247e02a02a
more on nested syntax structure;

diff -r 5a4ed4c2c72b -r ff385454adaa src/Doc/JEdit/JEdit.thy
--- a/src/Doc/JEdit/JEdit.thy	Tue Mar 11 23:27:54 2025 +0100
+++ b/src/Doc/JEdit/JEdit.thy	Wed Mar 12 00:12:42 2025 +0100
@@ -1209,7 +1209,7 @@
 \<close>
 
 
-section \<open>Tooltips and hyperlinks \label{sec:tooltips-hyperlinks}\<close>
+section \<open>Tooltips, hyperlinks, and syntax structure \label{sec:tooltips-hyperlinks}\<close>
 
 text \<open>
   Formally processed text (prover input or output) contains rich markup that
@@ -1255,6 +1255,29 @@
   document processing of the editor session and thus prevents further
   exploration: the chain of hyperlinks may end in some source file of the
   underlying logic image, or within the ML bootstrap sources of Isabelle/Pure.
+
+  \<^medskip>
+  Hyperlinks refer to atomic entities of formal syntax, but it is also
+  possible to visualize nested syntax structure, according to formal markup by
+  the prover. This information is derived from by pretty-printing blocks
+  within mixfix annotations: it is automatic for \<^theory_text>\<open>infix\<close> and \<^theory_text>\<open>binder\<close>, but
+  needs to be specified explicitly for free-form mixfix syntax (by the authors
+  of the theory library). \Figref{fig:syntax-structure} illustrates the result
+  for nested \<^theory_text>\<open>infix\<close>-expressions in Isabelle/HOL.
+
+  \begin{figure}[!htb]
+  \begin{center}
+  \includegraphics[scale=0.333]{popup3} \\[1ex]
+  \includegraphics[scale=0.333]{popup4}
+  \end{center}
+  \caption{Visualized markup for nested infix expressions}
+  \label{fig:syntax-structure}
+  \end{figure}
+
+  Instead of exploring formal syntax via the mouse, it is also possible to use
+  the keyboard action @{action_def "isabelle.select-structure"} (\<^verbatim>\<open>C+7\<close>). It
+  extends the editor selection by adding the enclosing syntax structure.
+  Repeated invocation of this action extends the selection incrementally.
 \<close>
 
 
diff -r 5a4ed4c2c72b -r ff385454adaa src/Doc/JEdit/document/popup3.png
Binary file src/Doc/JEdit/document/popup3.png has changed
diff -r 5a4ed4c2c72b -r ff385454adaa src/Doc/JEdit/document/popup4.png
Binary file src/Doc/JEdit/document/popup4.png has changed
diff -r 5a4ed4c2c72b -r ff385454adaa src/Doc/ROOT
--- a/src/Doc/ROOT	Tue Mar 11 23:27:54 2025 +0100
+++ b/src/Doc/ROOT	Wed Mar 12 00:12:42 2025 +0100
@@ -226,6 +226,8 @@
     "output.png"
     "popup1.png"
     "popup2.png"
+    "popup3.png"
+    "popup4.png"
     "query.png"
     "root.tex"
     "scope1.png"