matitaB/components/disambiguation/multiPassDisambiguator.ml

   1 (* Copyright (C) 2004-2005, HELM Team.
   2  *
   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.
   6  *
   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.
  11  *
  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.
  16  *
  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,
  20  * MA  02111-1307, USA.
  21  *
  22  * For details, see the HELM World-Wide-Web page,
  23  * http://helm.cs.unibo.it/
  24  *)
  25
  26 (* $Id$ *)
  27
  28 open Printf
  29
  30 let debug = ref false;;
  31 let debug_print s =
  32  if !debug then prerr_endline (Lazy.force s) else ();;
  33
  34 exception DisambiguationError of
  35  int *
  36  ((Stdpp.location list * string * string) list *
  37   (DisambiguateTypes.domain_item * string) list *
  38   (Stdpp.location * string) Lazy.t * bool) list list
  39   (** parameters are: option name, error message *)
  40
  41 (* implement module's API *)
  42
  43 let only_one_pass = ref false;;
  44 let use_library = ref false;;
  45
  46 let passes () = (* <fresh_instances?, aliases, coercions?> *)
  47  if !only_one_pass then
  48   [ (true, `Mono, false) ]
  49  else if !use_library then
  50   [ (true, `Library, false);
  51       (* for demo to reduce the number of interpretations *)
  52     (true, `Library, true);
  53   ]
  54  else if !debug then
  55   [ (true, `Multi, true); ]
  56  else
  57   [ (true, `Mono, false);
  58     (true, `Multi, false);
  59     (true, `Mono, true);
  60     (true, `Multi, true);
  61   ]
  62 ;;
  63
  64 let drop_aliases ?(minimize_instances=false) ~description_of_alias
  65  (choices, user_asked)
  66 =
  67  let module D = DisambiguateTypes in
  68  let compare ci1 ci2 = description_of_alias ci1 = description_of_alias ci2 in
  69  let minimize d =
  70   if not minimize_instances then
  71    d
  72   else
  73    let rec aux =
  74     function
  75        [] -> []
  76      | (D.Symbol (s,n),ci1) as he::tl when n <> None ->
  77          if
  78           List.for_all
  79            (function
  80                (D.Symbol (s2,_),ci2) -> s2 <> s || compare ci1 ci2
  81              | _ -> true
  82            ) d
  83          then
  84           (D.Symbol (s,None),ci1)::(aux tl)
  85          else
  86           he::(aux tl)
  87      | (D.Num n,ci1) as he::tl when n <> None ->
  88          if
  89           List.for_all
  90            (function (D.Num _,ci2) -> compare ci1 ci2 | _ -> true) d
  91          then
  92           (D.Num None,ci1)::(aux tl)
  93          else
  94           he::(aux tl)
  95       | he::tl -> he::(aux tl)
  96    in
  97     aux d
  98  in
  99   (List.map (fun (d, a, b, c, e) -> minimize d, a, b, c, e) choices),
 100   user_asked
 101
 102 let drop_aliases_and_clear_diff (choices, user_asked) =
 103   (List.map (fun (_, a, b, c, d) -> [], a, b, c, d) choices),
 104   user_asked
 105
 106 let disambiguate_thing ~description_of_alias ~passes ~aliases ~universe ~visit ~f thing
 107 =
 108   let library = false, DisambiguateTypes.Environment.empty,
 109                 DisambiguateTypes.Environment.empty in
 110   let multi_aliases = false, DisambiguateTypes.Environment.empty, universe in
 111   let mono_aliases = true, aliases, DisambiguateTypes.Environment.empty in
 112   let passes =
 113     List.map
 114      (function (fresh_instances,env,use_coercions) ->
 115        fresh_instances,
 116        (match env with `Mono -> mono_aliases | `Multi -> multi_aliases |
 117        `Library -> library),
 118        use_coercions) passes in
 119   let try_pass (fresh_instances, (_, aliases, universe), use_coercions) =
 120     f ~fresh_instances ~aliases ~universe ~use_coercions thing
 121   in
 122   let set_aliases (instances,(use_mono_aliases,_,_),_) (_, user_asked as res) =
 123    if use_mono_aliases then
 124     drop_aliases ~minimize_instances:true ~description_of_alias res (* one shot aliases *)
 125    else if user_asked then
 126     drop_aliases ~minimize_instances:true ~description_of_alias res (* one shot aliases *)
 127    else
 128     drop_aliases_and_clear_diff res
 129   in
 130   let rec aux i errors passes =
 131   debug_print (lazy ("Pass: " ^ string_of_int i));
 132    match passes with
 133       [ pass ] ->
 134         (try
 135           set_aliases pass (try_pass pass)
 136          with Disambiguate.NoWellTypedInterpretation (offset,newerrors) ->
 137           raise (DisambiguationError (offset, errors @ [newerrors])))
 138     | hd :: tl ->
 139         (try
 140           set_aliases hd (try_pass hd)
 141         with Disambiguate.NoWellTypedInterpretation (_offset,newerrors) ->
 142          aux (i+1) (errors @ [newerrors]) tl)
 143     | [] -> assert false
 144   in
 145    aux 1 [] passes
 146 ;;
 147
 148 let disambiguate_thing ~passes ~freshen_thing ~context ~metasenv ~subst
 149   ~string_context_of_context ~initial_ugraph ~expty ~mk_implicit
 150   ~description_of_alias ~fix_instance ~aliases ~universe ~lookup_in_library
 151   ~uri ~pp_thing ~pp_term ~domain_of_thing ~interpretate_thing ~refine_thing ~visit
 152   ~mk_localization_tbl thing
 153  =
 154   let f ~fresh_instances ~aliases ~universe ~use_coercions (txt,len,thing) =
 155     let thing = if fresh_instances then freshen_thing thing else thing in
 156      Disambiguate.disambiguate_thing
 157       ~context ~metasenv ~subst ~use_coercions ~string_context_of_context
 158       ~initial_ugraph ~expty ~mk_implicit ~description_of_alias ~fix_instance
 159       ~aliases ~universe ~lookup_in_library
 160       ~uri ~pp_thing ~domain_of_thing ~interpretate_thing ~refine_thing ~visit
 161       ~mk_localization_tbl ~pp_term (txt,len,thing)
 162   in
 163   disambiguate_thing ~description_of_alias ~passes ~aliases
 164    ~universe ~visit ~f thing