(*  Title:      Pure/General/markup.ML

    ID:         $Id$

    Author:     Makarius

Common markup elements.

*)

signature MARKUP =

sig

  type property = string * string

  type T = string * property list

  val get_string: T -> string -> string option

  val get_int: T -> string -> int option

  val none: T

  val properties: (string * string) list -> T -> T

  val nameN: string

  val name: string -> T -> T

  val groupN: string

  val theory_nameN: string

  val idN: string

  val kindN: string

  val internalK: string

  val property_internal: property

  val lineN: string

  val columnN: string

  val offsetN: string

  val end_lineN: string

  val end_columnN: string

  val end_offsetN: string

  val fileN: string

  val position_properties': string list

  val position_properties: string list

  val positionN: string val position: T

  val locationN: string val location: T

  val indentN: string

  val blockN: string val block: int -> T

  val widthN: string

  val breakN: string val break: int -> T

  val fbreakN: string val fbreak: T

  val tclassN: string val tclass: string -> T

  val tyconN: string val tycon: string -> T

  val fixedN: string val fixed: string -> T

  val constN: string val const: string -> T

  val factN: string val fact: string -> T

  val dynamic_factN: string val dynamic_fact: string -> T

  val local_factN: string val local_fact: string -> T

  val tfreeN: string val tfree: T

  val tvarN: string val tvar: T

  val freeN: string val free: T

  val skolemN: string val skolem: T

  val boundN: string val bound: T

  val varN: string val var: T

  val numN: string val num: T

  val xnumN: string val xnum: T

  val xstrN: string val xstr: T

  val literalN: string val literal: T

  val sortN: string val sort: T

  val typN: string val typ: T

  val termN: string val term: T

  val propN: string val prop: T

  val attributeN: string val attribute: string -> T

  val methodN: string val method: string -> T

  val ML_sourceN: string val ML_source: T

  val doc_sourceN: string val doc_source: T

  val keyword_declN: string val keyword_decl: string -> T

  val command_declN: string val command_decl: string -> string -> T

  val keywordN: string val keyword: string -> T

  val commandN: string val command: string -> T

  val identN: string val ident: T

  val stringN: string val string: T

  val altstringN: string val altstring: T

  val verbatimN: string val verbatim: T

  val commentN: string val comment: T

  val controlN: string val control: T

  val malformedN: string val malformed: T

  val tokenN: string val token: T

  val antiqN: string val antiq: T

  val command_spanN: string val command_span: string -> T

  val ignored_spanN: string val ignored_span: T

  val malformed_spanN: string val malformed_span: T

  val promptN: string val prompt: T

  val stateN: string val state: T

  val subgoalN: string val subgoal: T

  val sendbackN: string val sendback: T

  val hiliteN: string val hilite: T

  val unprocessedN: string val unprocessed: T

  val runningN: string val running: T

  val failedN: string val failed: T

  val finishedN: string val finished: T

  val disposedN: string val disposed: T

  val default_output: T -> output * output

  val add_mode: string -> (T -> output * output) -> unit

  val output: T -> output * output

  val enclose: T -> output -> output

  val markup: T -> string -> string

end;

structure Markup: MARKUP =

struct

(* basic markup *)

type property = string * string;

type T = string * property list;

val none = ("", []);

fun properties more_props ((elem, props): T) =

  (elem, fold_rev (AList.update (op =)) more_props props);

fun get_string ((_, props): T) prop = AList.lookup (op =) props prop;

fun get_int m prop = (case get_string m prop of NONE => NONE | SOME s => Int.fromString s);

fun markup_elem elem = (elem, (elem, []): T);

fun markup_string elem prop = (elem, fn s => (elem, [(prop, s)]): T);

fun markup_int elem prop = (elem, fn i => (elem, [(prop, Int.toString i)]): T);

(* name *)

val nameN = "name";

fun name a = properties [(nameN, a)];

val groupN = "group";

val theory_nameN = "theory_name";

(* kind *)

val kindN = "kind";

val internalK = "internal";

val property_internal = (kindN, internalK);

(* position *)

val lineN = "line";

val columnN = "column";

val offsetN = "offset";

val end_lineN = "end_line";

val end_columnN = "end_column";

val end_offsetN = "end_offset";

val fileN = "file";

val idN = "id";

val position_properties' = [end_lineN, end_columnN, end_offsetN, fileN, idN];

val position_properties = [lineN, columnN, offsetN] @ position_properties';

val (positionN, position) = markup_elem "position";

val (locationN, location) = markup_elem "location";

(* pretty printing *)

val indentN = "indent";

val (blockN, block) = markup_int "block" indentN;

val widthN = "width";

val (breakN, break) = markup_int "break" widthN;

val (fbreakN, fbreak) = markup_elem "fbreak";

(* logical entities *)

val (tclassN, tclass) = markup_string "tclass" nameN;

val (tyconN, tycon) = markup_string "tycon" nameN;

val (fixedN, fixed) = markup_string "fixed" nameN;

val (constN, const) = markup_string "const" nameN;

val (factN, fact) = markup_string "fact" nameN;

val (dynamic_factN, dynamic_fact) = markup_string "dynamic_fact" nameN;

val (local_factN, local_fact) = markup_string "local_fact" nameN;

(* inner syntax *)

val (tfreeN, tfree) = markup_elem "tfree";

val (tvarN, tvar) = markup_elem "tvar";

val (freeN, free) = markup_elem "free";

val (skolemN, skolem) = markup_elem "skolem";

val (boundN, bound) = markup_elem "bound";

val (varN, var) = markup_elem "var";

val (numN, num) = markup_elem "num";

val (xnumN, xnum) = markup_elem "xnum";

val (xstrN, xstr) = markup_elem "xstr";

val (literalN, literal) = markup_elem "literal";

val (sortN, sort) = markup_elem "sort";

val (typN, typ) = markup_elem "typ";

val (termN, term) = markup_elem "term";

val (propN, prop) = markup_elem "prop";

val (attributeN, attribute) = markup_string "attribute" nameN;

val (methodN, method) = markup_string "method" nameN;

(* embedded source text *)

val (ML_sourceN, ML_source) = markup_elem "ML_source";

val (doc_sourceN, doc_source) = markup_elem "doc_source";

(* outer syntax *)

val (keyword_declN, keyword_decl) = markup_string "keyword_decl" nameN;

val command_declN = "command_decl";

fun command_decl name kind : T = (command_declN, [(nameN, name), (kindN, kind)]);

val (keywordN, keyword) = markup_string "keyword" nameN;

val (commandN, command) = markup_string "command" nameN;

val (identN, ident) = markup_elem "ident";

val (stringN, string) = markup_elem "string";

val (altstringN, altstring) = markup_elem "altstring";

val (verbatimN, verbatim) = markup_elem "verbatim";

val (commentN, comment) = markup_elem "comment";

val (controlN, control) = markup_elem "control";

val (malformedN, malformed) = markup_elem "malformed";

val (tokenN, token) = markup_elem "token";

val (antiqN, antiq) = markup_elem "antiq";

val (command_spanN, command_span) = markup_string "command_span" nameN;

val (ignored_spanN, ignored_span) = markup_elem "ignored_span";

val (malformed_spanN, malformed_span) = markup_elem "malformed_span";

(* toplevel *)

val (promptN, prompt) = markup_elem "prompt";

val (stateN, state) = markup_elem "state";

val (subgoalN, subgoal) = markup_elem "subgoal";

val (sendbackN, sendback) = markup_elem "sendback";

val (hiliteN, hilite) = markup_elem "hilite";

(* command status *)

val (unprocessedN, unprocessed) = markup_elem "unprocessed";

val (runningN, running) = markup_elem "running";

val (failedN, failed) = markup_elem "failed";

val (finishedN, finished) = markup_elem "finished";

val (disposedN, disposed) = markup_elem "disposed";

(* print mode operations *)

fun default_output (_: T) = ("", "");

local

  val default = {output = default_output};

  val modes = ref (Symtab.make [("", default)]);

in

  fun add_mode name output = CRITICAL (fn () =>

    change modes (Symtab.update_new (name, {output = output})));

  fun get_mode () =

    the_default default (Library.get_first (Symtab.lookup (! modes)) (print_mode_value ()));

end;

fun output ("", _) = ("", "")

  | output m = #output (get_mode ()) m;

val enclose = output #-> Library.enclose;

fun markup m =

  let val (bg, en) = output m

  in Library.enclose (Output.escape bg) (Output.escape en) end;

end;