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 exception NoWellTypedInterpretation
29 exception PathNotWellFormed
31 val interpretate_path :
32 context:Cic.name list -> DisambiguateTypes.term ->
35 (** @param multi true if multi aliases are used, false otherwise *)
36 type aliases = bool * DisambiguateTypes.environment
38 module type Disambiguator =
40 (** @param fresh_instances when set to true fresh instances will be generated
41 * for each number _and_ symbol in the disambiguation domain. Instances of the
42 * input AST will be ignored. Defaults to false. *)
43 val disambiguate_term :
44 ?fresh_instances:bool ->
46 context:Cic.context ->
47 metasenv:Cic.metasenv ->
48 ?initial_ugraph:CicUniv.universe_graph ->
49 aliases:aliases -> (* previous interpretation status *)
50 DisambiguateTypes.term ->
51 (DisambiguateTypes.environment * (* new interpretation status *)
52 Cic.metasenv * (* new metasenv *)
54 CicUniv.universe_graph) list * (* disambiguated term *)
55 bool (* has interactive_interpretation_choice been invoked? *)
57 (** @param fresh_instances as per disambiguate_term *)
58 val disambiguate_obj :
59 ?fresh_instances:bool ->
61 aliases:aliases -> (* previous interpretation status *)
62 uri:UriManager.uri option -> (* required only for inductive types *)
64 (DisambiguateTypes.environment * (* new interpretation status *)
65 Cic.metasenv * (* new metasenv *)
67 CicUniv.universe_graph) list * (* disambiguated obj *)
68 bool (* has interactive_interpretation_choice been invoked? *)
71 module Make (C : DisambiguateTypes.Callbacks) : Disambiguator
75 exception Ambiguous_term of string
77 (** disambiguate an _unanmbiguous_ term using dummy callbacks which fail if a
78 * choice from the user is needed to disambiguate the term
79 * @raise Ambiguous_term for ambiguous term *)
80 val disambiguate_string:
82 ?context:Cic.context ->
83 ?metasenv:Cic.metasenv ->
84 ?initial_ugraph:CicUniv.universe_graph ->
85 ?aliases:DisambiguateTypes.environment ->(* previous interpretation status*)
87 (DisambiguateTypes.environment * (* new interpretation status *)
88 Cic.metasenv * (* new metasenv *)
90 CicUniv.universe_graph) list (* disambiguated term *)
93 val dummy_floc: Lexing.position * Lexing.position