diff --git a/examples/technical_report/Isabelle_DOF-Manual/03_GuidedTour.thy b/examples/technical_report/Isabelle_DOF-Manual/03_GuidedTour.thy index 39b1496e..2e3230bf 100755 --- a/examples/technical_report/Isabelle_DOF-Manual/03_GuidedTour.thy +++ b/examples/technical_report/Isabelle_DOF-Manual/03_GuidedTour.thy @@ -531,19 +531,27 @@ be printed with different prefixes according to their uniqueness. \ subsection*[cartouches::example]\Caveat: Lexical Conventions of Cartouches, Strings, Names, ... \ -text\WARNING: The embedding of strings, terms, names \<^etc> as parts of commands, anti-quotations, -is unfortunately not always so consistent as one might expect. This can be a nuisance for +text\WARNING: The embedding of strings, terms, names \<^etc>, as parts of commands, anti-quotations, +terms, \<^etc>, is unfortunately not always so consistent as one might expect, when it comes +to variants that should be lexically equivalent in principle. This can be a nuisance for users, but is again a consequence that we build on existing technology that has been developed over decades. - -At times, that causes idiosyncrasy like in: +\ +text\At times, this causes idiosyncrasies like the ones cited in the following incomplete list: \<^item> text-antiquotations - \<^theory_text>\ \\<^thm>"normally_behaved_distance_function_def"\\ and \<^theory_text>\\@{thm "srac\<^sub>1_def"}\\ (while - \<^theory_text>\ @{thm \srac\<^sub>1_def\}\ fails ...) -\<^item> commands \<^theory_text>\thm fundamental_theorem_of_calculus\ and \<^theory_text>\thm "fundamental_theorem_of_calculus"\ - or \<^theory_text>\lemma "H"\ and \<^theory_text>\lemma \H\\ and \<^theory_text>\lemma H\ -\<^item> string expressions \''abc'' @ ''cd''\ and equivalent \\abc\ @ \cd\\; - but \\A \ B\\ and not \''A \ B''\ \ + \<^theory_text>\text\\<^latex>\\isasymopen\textbf{thm}"normally\_behaved\_def"\isasymclose\break\ + versus \<^theory_text>\text\\<^latex>\\isasymopen @\{\textbf{thm} "srac$_1$\_def"\}\isasymclose\break\ + (while \<^theory_text>\text\\<^latex>\\isasymopen @\{\textbf{thm} \isasymopen srac$_1$\_def \isasymclose\}\isasymclose\ fails) +\<^item> commands \<^theory_text>\thm fundamental_theorem_of_calculus\ and + \<^theory_text>\thm\\<^latex>\"fundamental\_theorem\_of\_calculus"\ + or \<^theory_text>\lemma\ latex>\"H"\ and \<^theory_text>\lemma \H\\ and \<^theory_text>\lemma H\ +\<^item> string expressions \<^theory_text>\term\\<^latex>\\isasymopen ''abc'' @ ''cd''\isasymclose \ and equivalent + \<^theory_text>\term\\<^latex>\\isasymopen \isasymopen abc\isasymclose\ @ \isasymopen cd\isasymclose\isasymclose\; + but + \<^theory_text>\term\\<^latex>\\isasymopen\isasymopen A \isasymlongrightarrow\ B\isasymclose\isasymclose\ \ + not equivalent \<^theory_text>\term\\<^latex>\\isasymopen''A \isasymlongrightarrow\ B''\isasymclose\ (fails). +\ + text\We advise users to experiment with different notation variants.\ section*[cenelec_onto::example]\Writing Certification Documents (CENELEC\_50128)\