1 (* Title: Pure/General/markup.ML
4 Common markup elements.
9 val parse_int: string -> int
10 val print_int: int -> string
11 type T = string * Properties.T
13 val is_empty: T -> bool
14 val properties: Properties.T -> T -> T
16 val name: string -> T -> T
18 val bindingN: string val binding: string -> T
19 val entityN: string val entity: string -> T
26 val end_columnN: string
27 val end_offsetN: string
30 val position_properties': string list
31 val position_properties: string list
32 val positionN: string val position: T
34 val blockN: string val block: int -> T
36 val breakN: string val break: int -> T
37 val fbreakN: string val fbreak: T
38 val hiddenN: string val hidden: T
39 val tclassN: string val tclass: string -> T
40 val tyconN: string val tycon: string -> T
41 val fixed_declN: string val fixed_decl: string -> T
42 val fixedN: string val fixed: string -> T
43 val const_declN: string val const_decl: string -> T
44 val constN: string val const: string -> T
45 val fact_declN: string val fact_decl: string -> T
46 val factN: string val fact: string -> T
47 val dynamic_factN: string val dynamic_fact: string -> T
48 val local_fact_declN: string val local_fact_decl: string -> T
49 val local_factN: string val local_fact: string -> T
50 val tfreeN: string val tfree: T
51 val tvarN: string val tvar: T
52 val freeN: string val free: T
53 val skolemN: string val skolem: T
54 val boundN: string val bound: T
55 val varN: string val var: T
56 val numeralN: string val numeral: T
57 val literalN: string val literal: T
58 val inner_stringN: string val inner_string: T
59 val inner_commentN: string val inner_comment: T
60 val token_rangeN: string val token_range: T
61 val sortN: string val sort: T
62 val typN: string val typ: T
63 val termN: string val term: T
64 val propN: string val prop: T
65 val attributeN: string val attribute: string -> T
66 val methodN: string val method: string -> T
67 val ML_keywordN: string val ML_keyword: T
68 val ML_delimiterN: string val ML_delimiter: T
69 val ML_identN: string val ML_ident: T
70 val ML_tvarN: string val ML_tvar: T
71 val ML_numeralN: string val ML_numeral: T
72 val ML_charN: string val ML_char: T
73 val ML_stringN: string val ML_string: T
74 val ML_commentN: string val ML_comment: T
75 val ML_malformedN: string val ML_malformed: T
76 val ML_defN: string val ML_def: T
77 val ML_openN: string val ML_open: T
78 val ML_structN: string val ML_struct: T
79 val ML_refN: string val ML_ref: T
80 val ML_typingN: string val ML_typing: T
81 val ML_sourceN: string val ML_source: T
82 val doc_sourceN: string val doc_source: T
83 val antiqN: string val antiq: T
84 val ML_antiqN: string val ML_antiq: string -> T
85 val doc_antiqN: string val doc_antiq: string -> T
86 val keyword_declN: string val keyword_decl: string -> T
87 val command_declN: string val command_decl: string -> string -> T
88 val keywordN: string val keyword: T
89 val operatorN: string val operator: T
90 val commandN: string val command: T
91 val identN: string val ident: T
92 val stringN: string val string: T
93 val altstringN: string val altstring: T
94 val verbatimN: string val verbatim: T
95 val commentN: string val comment: T
96 val controlN: string val control: T
97 val malformedN: string val malformed: T
98 val tokenN: string val token: Properties.T -> T
99 val command_spanN: string val command_span: string -> T
100 val ignored_spanN: string val ignored_span: T
101 val malformed_spanN: string val malformed_span: T
102 val timing: timing -> T
103 val subgoalsN: string
104 val proof_stateN: string val proof_state: int -> T
105 val stateN: string val state: T
106 val subgoalN: string val subgoal: T
107 val sendbackN: string val sendback: T
108 val hiliteN: string val hilite: T
110 val forkedN: string val forked: T
111 val joinedN: string val joined: T
112 val failedN: string val failed: T
113 val finishedN: string val finished: T
116 val assignN: string val assign: int -> T
117 val editN: string val edit: int -> int -> T
119 val promptN: string val prompt: T
120 val readyN: string val ready: T
121 val reportN: string val report: T
122 val no_reportN: string val no_report: T
123 val badN: string val bad: T
124 val no_output: Output.output * Output.output
125 val default_output: T -> Output.output * Output.output
126 val add_mode: string -> (T -> Output.output * Output.output) -> unit
127 val output: T -> Output.output * Output.output
128 val enclose: T -> Output.output -> Output.output
129 val markup: T -> string -> string
132 structure Markup: MARKUP =
135 (** markup elements **)
140 (case Int.fromString s of
142 | NONE => raise Fail ("Bad integer: " ^ quote s));
144 val print_int = signed_string_of_int;
149 type T = string * Properties.T;
151 val empty = ("", []);
153 fun is_empty ("", _) = true
154 | is_empty _ = false;
157 fun properties more_props ((elem, props): T) =
158 (elem, fold_rev Properties.put more_props props);
160 fun markup_elem elem = (elem, (elem, []): T);
161 fun markup_string elem prop = (elem, fn s => (elem, [(prop, s)]): T);
162 fun markup_int elem prop = (elem, fn i => (elem, [(prop, print_int i)]): T);
165 (* misc properties *)
168 fun name a = properties [(nameN, a)];
173 (* formal entities *)
175 val (bindingN, binding) = markup_string "binding" nameN;
176 val (entityN, entity) = markup_string "entity" nameN;
185 val columnN = "column";
186 val offsetN = "offset";
187 val end_lineN = "end_line";
188 val end_columnN = "end_column";
189 val end_offsetN = "end_offset";
193 val position_properties' = [end_lineN, end_columnN, end_offsetN, fileN, idN];
194 val position_properties = [lineN, columnN, offsetN] @ position_properties';
196 val (positionN, position) = markup_elem "position";
199 (* pretty printing *)
201 val indentN = "indent";
202 val (blockN, block) = markup_int "block" indentN;
204 val widthN = "width";
205 val (breakN, break) = markup_int "break" widthN;
207 val (fbreakN, fbreak) = markup_elem "fbreak";
212 val (hiddenN, hidden) = markup_elem "hidden";
215 (* logical entities *)
217 val (tclassN, tclass) = markup_string "tclass" nameN;
218 val (tyconN, tycon) = markup_string "tycon" nameN;
219 val (fixed_declN, fixed_decl) = markup_string "fixed_decl" nameN;
220 val (fixedN, fixed) = markup_string "fixed" nameN;
221 val (const_declN, const_decl) = markup_string "const_decl" nameN;
222 val (constN, const) = markup_string "const" nameN;
223 val (fact_declN, fact_decl) = markup_string "fact_decl" nameN;
224 val (factN, fact) = markup_string "fact" nameN;
225 val (dynamic_factN, dynamic_fact) = markup_string "dynamic_fact" nameN;
226 val (local_fact_declN, local_fact_decl) = markup_string "local_fact_decl" nameN;
227 val (local_factN, local_fact) = markup_string "local_fact" nameN;
232 val (tfreeN, tfree) = markup_elem "tfree";
233 val (tvarN, tvar) = markup_elem "tvar";
234 val (freeN, free) = markup_elem "free";
235 val (skolemN, skolem) = markup_elem "skolem";
236 val (boundN, bound) = markup_elem "bound";
237 val (varN, var) = markup_elem "var";
238 val (numeralN, numeral) = markup_elem "numeral";
239 val (literalN, literal) = markup_elem "literal";
240 val (inner_stringN, inner_string) = markup_elem "inner_string";
241 val (inner_commentN, inner_comment) = markup_elem "inner_comment";
243 val (token_rangeN, token_range) = markup_elem "token_range";
245 val (sortN, sort) = markup_elem "sort";
246 val (typN, typ) = markup_elem "typ";
247 val (termN, term) = markup_elem "term";
248 val (propN, prop) = markup_elem "prop";
250 val (attributeN, attribute) = markup_string "attribute" nameN;
251 val (methodN, method) = markup_string "method" nameN;
256 val (ML_keywordN, ML_keyword) = markup_elem "ML_keyword";
257 val (ML_delimiterN, ML_delimiter) = markup_elem "ML_delimiter";
258 val (ML_identN, ML_ident) = markup_elem "ML_ident";
259 val (ML_tvarN, ML_tvar) = markup_elem "ML_tvar";
260 val (ML_numeralN, ML_numeral) = markup_elem "ML_numeral";
261 val (ML_charN, ML_char) = markup_elem "ML_char";
262 val (ML_stringN, ML_string) = markup_elem "ML_string";
263 val (ML_commentN, ML_comment) = markup_elem "ML_comment";
264 val (ML_malformedN, ML_malformed) = markup_elem "ML_malformed";
266 val (ML_defN, ML_def) = markup_elem "ML_def";
267 val (ML_openN, ML_open) = markup_elem "ML_open";
268 val (ML_structN, ML_struct) = markup_elem "ML_struct";
269 val (ML_refN, ML_ref) = markup_elem "ML_ref";
270 val (ML_typingN, ML_typing) = markup_elem "ML_typing";
273 (* embedded source text *)
275 val (ML_sourceN, ML_source) = markup_elem "ML_source";
276 val (doc_sourceN, doc_source) = markup_elem "doc_source";
278 val (antiqN, antiq) = markup_elem "antiq";
279 val (ML_antiqN, ML_antiq) = markup_string "ML_antiq" nameN;
280 val (doc_antiqN, doc_antiq) = markup_string "doc_antiq" nameN;
285 val (keyword_declN, keyword_decl) = markup_string "keyword_decl" nameN;
287 val command_declN = "command_decl";
288 fun command_decl name kind : T = (command_declN, [(nameN, name), (kindN, kind)]);
290 val (keywordN, keyword) = markup_elem "keyword";
291 val (operatorN, operator) = markup_elem "operator";
292 val (commandN, command) = markup_elem "command";
293 val (identN, ident) = markup_elem "ident";
294 val (stringN, string) = markup_elem "string";
295 val (altstringN, altstring) = markup_elem "altstring";
296 val (verbatimN, verbatim) = markup_elem "verbatim";
297 val (commentN, comment) = markup_elem "comment";
298 val (controlN, control) = markup_elem "control";
299 val (malformedN, malformed) = markup_elem "malformed";
301 val tokenN = "token";
302 fun token props = (tokenN, props);
304 val (command_spanN, command_span) = markup_string "command_span" nameN;
305 val (ignored_spanN, ignored_span) = markup_elem "ignored_span";
306 val (malformed_spanN, malformed_span) = markup_elem "malformed_span";
311 fun timing ({elapsed, cpu, gc, ...}: timing) =
313 [("elapsed", Time.toString elapsed), ("cpu", Time.toString cpu), ("gc", Time.toString gc)]);
315 val subgoalsN = "subgoals";
316 val (proof_stateN, proof_state) = markup_int "proof_state" subgoalsN;
318 val (stateN, state) = markup_elem "state";
319 val (subgoalN, subgoal) = markup_elem "subgoal";
320 val (sendbackN, sendback) = markup_elem "sendback";
321 val (hiliteN, hilite) = markup_elem "hilite";
328 val (forkedN, forked) = markup_elem "forked";
329 val (joinedN, joined) = markup_elem "joined";
331 val (failedN, failed) = markup_elem "failed";
332 val (finishedN, finished) = markup_elem "finished";
335 (* interactive documents *)
337 val versionN = "version";
339 val (assignN, assign) = markup_int "assign" versionN;
342 fun edit cmd_id exec_id : T = (editN, [(idN, print_int cmd_id), (execN, print_int exec_id)]);
347 val serialN = "serial";
349 val (promptN, prompt) = markup_elem "prompt";
350 val (readyN, ready) = markup_elem "ready";
352 val (reportN, report) = markup_elem "report";
353 val (no_reportN, no_report) = markup_elem "no_report";
355 val (badN, bad) = markup_elem "bad";
359 (** print mode operations **)
361 val no_output = ("", "");
362 fun default_output (_: T) = no_output;
365 val default = {output = default_output};
366 val modes = Unsynchronized.ref (Symtab.make [("", default)]);
368 fun add_mode name output = CRITICAL (fn () =>
369 Unsynchronized.change modes (Symtab.update_new (name, {output = output})));
371 the_default default (Library.get_first (Symtab.lookup (! modes)) (print_mode_value ()));
374 fun output m = if is_empty m then no_output else #output (get_mode ()) m;
376 val enclose = output #-> Library.enclose;
379 let val (bg, en) = output m
380 in Library.enclose (Output.escape bg) (Output.escape en) end;