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/
30 exception Ambiguous_input
32 type choose_uris_callback =
33 id:string -> UriManager.uri list -> UriManager.uri list
35 type choose_interp_callback = (string * string) list list -> int list
37 let mono_uris_callback ~id =
38 if Helm_registry.get_bool "matita.auto_disambiguation" then
43 let mono_interp_callback _ = raise Ambiguous_input
45 let _choose_uris_callback = ref mono_uris_callback
46 let _choose_interp_callback = ref mono_interp_callback
47 let set_choose_uris_callback f = _choose_uris_callback := f
48 let set_choose_interp_callback f = _choose_interp_callback := f
52 let interactive_user_uri_choice ~selection_mode ?ok
53 ?(enable_button_for_non_vars = true) ~title ~msg ~id uris =
54 !_choose_uris_callback ~id uris
56 let interactive_interpretation_choice interp =
57 !_choose_interp_callback interp
59 let input_or_locate_uri ~(title:string) ?id =
60 (* Zack: I try to avoid using this callback. I therefore assume that
61 * the presence of an identifier that can't be resolved via "locate"
62 * query is a syntax error *)
63 let msg = match id with Some id -> id | _ -> "_" in
64 raise (Unbound_identifier msg)
67 module Disambiguator = Disambiguate.Make (Callbacks)
69 (* implement module's API *)
71 let disambiguate_thing ~aliases ~universe
72 ~(f:?fresh_instances:bool ->
73 aliases:DisambiguateTypes.environment ->
74 universe:DisambiguateTypes.multiple_environment option ->
76 ~(set_aliases: DisambiguateTypes.environment -> 'b -> 'b)
79 assert (universe <> None);
80 let library = false, DisambiguateTypes.Environment.empty, None in
81 let multi_aliases=false, DisambiguateTypes.Environment.empty, universe in
82 let mono_aliases = true, aliases, None in
83 let passes = (* <fresh_instances?, aliases, coercions?> *)
84 [ (false, mono_aliases, false);
85 (false, multi_aliases, false);
86 (true, mono_aliases, false);
87 (true, multi_aliases, false);
88 (true, mono_aliases, true);
89 (true, multi_aliases, true);
90 (true, library, true);
93 let try_pass (fresh_instances, (_, aliases, universe), use_coercions) =
94 CoercDb.use_coercions := use_coercions;
95 f ~fresh_instances ~aliases ~universe thing
97 let set_aliases (instances,(use_mono_aliases,_,_),_) (_, user_asked as res) =
98 if use_mono_aliases && not instances then
100 else if user_asked then
101 res (* one shot aliases *)
103 set_aliases aliases res
107 | [ pass ] -> set_aliases pass (try_pass pass)
110 set_aliases hd (try_pass hd)
111 with Disambiguate.NoWellTypedInterpretation -> aux tl)
114 let saved_use_coercions = !CoercDb.use_coercions in
116 let res = aux passes in
117 CoercDb.use_coercions := saved_use_coercions;
120 CoercDb.use_coercions := saved_use_coercions;
123 let disambiguate_thing =
124 let profiler = CicUtil.profile "disambiguate_thing" in
125 fun ~aliases ~universe
126 ~(f:?fresh_instances:bool ->
127 aliases:DisambiguateTypes.environment ->
128 universe:DisambiguateTypes.multiple_environment option ->
130 ~(set_aliases: DisambiguateTypes.environment -> 'b -> 'b)
132 -> profiler.CicUtil.profile
133 (disambiguate_thing ~aliases ~universe ~f ~set_aliases) thing
135 let disambiguate_thing ~aliases ~universe
136 ~(f:?fresh_instances:bool ->
137 aliases:DisambiguateTypes.environment ->
138 universe:DisambiguateTypes.multiple_environment option ->
140 ~(set_aliases: DisambiguateTypes.environment -> 'b -> 'b)
143 Obj.magic disambiguate_thing ~aliases ~universe ~f ~set_aliases thing
145 let set_aliases aliases (choices, user_asked) =
146 (List.map (fun (_, a, b, c) -> aliases, a, b, c) choices),
149 let disambiguate_term ?fresh_instances ~dbd ~context ~metasenv ?initial_ugraph
150 ~aliases ~universe term
152 assert (fresh_instances = None);
154 Disambiguator.disambiguate_term ~dbd ~context ~metasenv ?initial_ugraph
156 disambiguate_thing ~aliases ~universe ~f ~set_aliases term
158 let disambiguate_obj ?fresh_instances ~dbd ~aliases ~universe ~uri obj =
159 assert (fresh_instances = None);
160 let f = Disambiguator.disambiguate_obj ~dbd ~uri in
161 disambiguate_thing ~aliases ~universe ~f ~set_aliases obj