1 (* Copyright (C) 2004-2005, 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/
32 if debug then prerr_endline (Lazy.force s);;
34 exception Ambiguous_input
35 (* the integer is an offset to be added to each location *)
36 exception DisambiguationError of
38 ((Stdpp.location list * string * string) list *
39 (DisambiguateTypes.domain_item * string) list *
40 (Stdpp.location * string) Lazy.t * bool) list list
41 (** parameters are: option name, error message *)
43 let mono_uris_callback ~selection_mode ?ok
44 ?(enable_button_for_non_vars = true) ~title ~msg ~id =
45 if Helm_registry.get_opt_default Helm_registry.get_bool ~default:true
46 "matita.auto_disambiguation"
52 let mono_interp_callback _ _ _ = raise Ambiguous_input
54 let _choose_uris_callback = ref mono_uris_callback
55 let _choose_interp_callback = ref mono_interp_callback
56 let set_choose_uris_callback f = _choose_uris_callback := f
57 let set_choose_interp_callback f = _choose_interp_callback := f
61 let interactive_user_uri_choice = !_choose_uris_callback
63 let interactive_interpretation_choice interp =
64 !_choose_interp_callback interp
66 let input_or_locate_uri ~(title:string) ?id () = None
67 (* Zack: I try to avoid using this callback. I therefore assume that
68 * the presence of an identifier that can't be resolved via "locate"
69 * query is a syntax error *)
72 module Disambiguator = Disambiguate.Make (Callbacks)
74 (* implement module's API *)
76 let only_one_pass = ref false;;
78 let passes () = (* <fresh_instances?, aliases, coercions?> *)
79 if !only_one_pass then
80 [ (true, `Mono, false) ]
82 [ (true, `Mono, false);
83 (true, `Multi, false);
86 (true, `Library, false);
87 (* for demo to reduce the number of interpretations *)
88 (true, `Library, true);
92 let drop_aliases ?(minimize_instances=false) (choices, user_asked) =
93 let module D = DisambiguateTypes in
95 if not minimize_instances then
101 | (D.Symbol (s,n),((descr,_) as ci)) as he::tl when n > 0 ->
105 (D.Symbol (s2,_),(descr2,_)) -> s2 <> s || descr = descr2
109 (D.Symbol (s,0),ci)::(aux tl)
112 | (D.Num n,((descr,_) as ci)) as he::tl when n > 0 ->
115 (function (D.Num _,(descr2,_)) -> descr = descr2 | _ -> true) d
117 (D.Num 0,ci)::(aux tl)
120 | he::tl -> he::(aux tl)
124 (List.map (fun (d, a, b, c, e) -> minimize d, a, b, c, e) choices),
127 let drop_aliases_and_clear_diff (choices, user_asked) =
128 (List.map (fun (_, a, b, c, d) -> [], a, b, c, d) choices),
131 let disambiguate_thing ~passes ~aliases ~universe ~f thing =
132 assert (universe <> None);
133 let library = false, DisambiguateTypes.Environment.empty, None in
134 let multi_aliases = false, DisambiguateTypes.Environment.empty, universe in
135 let mono_aliases = true, aliases, Some DisambiguateTypes.Environment.empty in
138 (function (fresh_instances,env,use_coercions) ->
140 (match env with `Mono -> mono_aliases | `Multi -> multi_aliases |
141 `Library -> library),
142 use_coercions) passes in
143 let try_pass (fresh_instances, (_, aliases, universe), use_coercions) =
144 f ~fresh_instances ~aliases ~universe ~use_coercions thing
146 let set_aliases (instances,(use_mono_aliases,_,_),_) (_, user_asked as res) =
147 if use_mono_aliases then
148 drop_aliases ~minimize_instances:true res (* one shot aliases *)
149 else if user_asked then
150 drop_aliases ~minimize_instances:true res (* one shot aliases *)
152 drop_aliases_and_clear_diff res
154 let rec aux i errors passes =
155 debug_print (lazy ("Pass: " ^ string_of_int i));
159 set_aliases pass (try_pass pass)
160 with Disambiguate.NoWellTypedInterpretation (offset,newerrors) ->
161 raise (DisambiguationError (offset, errors @ [newerrors])))
164 set_aliases hd (try_pass hd)
165 with Disambiguate.NoWellTypedInterpretation (_offset,newerrors) ->
166 aux (i+1) (errors @ [newerrors]) tl)
171 let disambiguate_thing ~passes ~freshen_thing ~context ~metasenv ~subst
172 ~mk_implicit ~string_context_of_context ~initial_ugraph ~hint ~aliases
173 ~universe ~lookup_in_library ~uri ~pp_thing ~domain_of_thing
174 ~interpretate_thing ~refine_thing ~localization_tbl thing
176 let f ~fresh_instances ~aliases ~universe ~use_coercions (txt,len,thing) =
177 let thing = if fresh_instances then freshen_thing thing else thing
179 Disambiguator.disambiguate_thing
180 ~context ~metasenv ~subst ~use_coercions
181 ~mk_implicit ~string_context_of_context
182 ~initial_ugraph ~hint
183 ~aliases ~universe ~lookup_in_library
184 ~uri ~pp_thing ~domain_of_thing ~interpretate_thing ~refine_thing
185 ~localization_tbl (txt,len,thing)
187 disambiguate_thing ~passes ~aliases ~universe ~f thing