1 (* Copyright (C) 2004, HELM Team.
3 * This file is part of HELM, an Hypertextual, Electronic
4 * Library of Mathematics, developed at the Computer Science
5 * Department, University of Bologna, Italy.
7 * HELM is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version 2
10 * of the License, or (at your option) any later version.
12 * HELM is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with HELM; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place - Suite 330, Boston,
22 * For details, see the HELM World-Wide-Web page,
23 * http://helm.cs.unibo.it/
26 (** {2 Disambiguation interface} *)
28 (* the integer is an offset to be added to each location *)
29 (* list of located error messages, each list is a tuple:
30 * - environment in string form
34 * - significancy of the error message, if false the error is likely to be
35 * useless for the final user ... *)
36 exception NoWellTypedInterpretation of
38 ((Stdpp.location list * string * string) list *
39 (DisambiguateTypes.domain_item * DisambiguateTypes.codomain_item) list *
40 Stdpp.location option * string Lazy.t * bool) list
41 exception PathNotWellFormed
43 val interpretate_path :
44 context:Cic.name list -> CicNotationPt.term -> Cic.term
46 type 'a disambiguator_input = string * int * 'a
48 type domain = domain_tree list
50 Node of Stdpp.location list * DisambiguateTypes.domain_item * domain
51 type ('a,'m) test_result =
53 | Ko of Stdpp.location option * string Lazy.t
54 | Uncertain of Stdpp.location option * string Lazy.t
55 exception Try_again of string Lazy.t
57 val domain_of_ast_term: context:Cic.name list -> CicNotationPt.term -> domain
59 module type Disambiguator =
61 val disambiguate_thing:
65 initial_ugraph:'ugraph ->
66 hint: ('metasenv -> 'raw_thing -> 'raw_thing) *
67 (('refined_thing,'metasenv) test_result -> 'ugraph ->
68 ('refined_thing,'metasenv) test_result * 'ugraph) ->
69 aliases:DisambiguateTypes.codomain_item DisambiguateTypes.Environment.t ->
70 universe:DisambiguateTypes.codomain_item list
71 DisambiguateTypes.Environment.t option ->
73 pp_thing:('ast_thing -> string) ->
74 domain_of_thing:(context:'context -> 'ast_thing -> domain) ->
75 interpretate_thing:(context:'context ->
76 env:DisambiguateTypes.codomain_item
77 DisambiguateTypes.Environment.t ->
81 localization_tbl:'cichash -> 'raw_thing) ->
82 refine_thing:('metasenv ->
86 'ugraph -> localization_tbl:'cichash -> ('refined_thing,
87 'metasenv) test_result * 'ugraph) ->
88 localization_tbl:'cichash ->
89 string * int * 'ast_thing ->
90 ((DisambiguateTypes.Environment.key * DisambiguateTypes.codomain_item)
91 list * 'metasenv * 'refined_thing * 'ugraph)
94 (** @param fresh_instances when set to true fresh instances will be generated
95 * for each number _and_ symbol in the disambiguation domain. Instances of the
96 * input AST will be ignored. Defaults to false. *)
97 val disambiguate_term :
98 ?fresh_instances:bool ->
100 context:Cic.context ->
101 metasenv:Cic.metasenv -> ?goal:int ->
102 ?initial_ugraph:CicUniv.universe_graph ->
103 aliases:DisambiguateTypes.environment ->(* previous interpretation status *)
104 universe:DisambiguateTypes.multiple_environment option ->
105 CicNotationPt.term disambiguator_input ->
106 ((DisambiguateTypes.domain_item * DisambiguateTypes.codomain_item) list *
107 Cic.metasenv * (* new metasenv *)
109 CicUniv.universe_graph) list * (* disambiguated term *)
110 bool (* has interactive_interpretation_choice been invoked? *)
112 (** @param fresh_instances as per disambiguate_term *)
113 val disambiguate_obj :
114 ?fresh_instances:bool ->
116 aliases:DisambiguateTypes.environment ->(* previous interpretation status *)
117 universe:DisambiguateTypes.multiple_environment option ->
118 uri:UriManager.uri option -> (* required only for inductive types *)
119 CicNotationPt.term CicNotationPt.obj disambiguator_input ->
120 ((DisambiguateTypes.domain_item * DisambiguateTypes.codomain_item) list *
121 Cic.metasenv * (* new metasenv *)
123 CicUniv.universe_graph) list * (* disambiguated obj *)
124 bool (* has interactive_interpretation_choice been invoked? *)
128 module Make (C : DisambiguateTypes.Callbacks) : Disambiguator