helm/software/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 = false;;
  31 let debug_print s =
  32  if debug then prerr_endline (Lazy.force s);;
  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
  55   [ (true, `Mono, false);
  56     (true, `Multi, false);
  57     (true, `Mono, true);
  58     (true, `Multi, true);
  59   ]
  60 ;;
  61
  62 let drop_aliases ?(minimize_instances=false) ~description_of_alias
  63  (choices, user_asked)
  64 =
  65  let module D = DisambiguateTypes in
  66  let compare ci1 ci2 = description_of_alias ci1 = description_of_alias ci2 in
  67  let minimize d =
  68   if not minimize_instances then
  69    d
  70   else
  71    let rec aux =
  72     function
  73        [] -> []
  74      | (D.Symbol (s,n),ci1) as he::tl when n > 0 ->
  75          if
  76           List.for_all
  77            (function
  78                (D.Symbol (s2,_),ci2) -> s2 <> s || compare ci1 ci2
  79              | _ -> true
  80            ) d
  81          then
  82           (D.Symbol (s,0),ci1)::(aux tl)
  83          else
  84           he::(aux tl)
  85      | (D.Num n,ci1) as he::tl when n > 0 ->
  86          if
  87           List.for_all
  88            (function (D.Num _,ci2) -> compare ci1 ci2 | _ -> true) d
  89          then
  90           (D.Num 0,ci1)::(aux tl)
  91          else
  92           he::(aux tl)
  93       | he::tl -> he::(aux tl)
  94    in
  95     aux d
  96  in
  97   (List.map (fun (d, a, b, c, e) -> minimize d, a, b, c, e) choices),
  98   user_asked
  99
 100 let drop_aliases_and_clear_diff (choices, user_asked) =
 101   (List.map (fun (_, a, b, c, d) -> [], a, b, c, d) choices),
 102   user_asked
 103
 104 let disambiguate_thing ~description_of_alias ~passes ~aliases ~universe ~f thing
 105 =
 106   assert (universe <> None);
 107   let library = false, DisambiguateTypes.Environment.empty, None in
 108   let multi_aliases = false, DisambiguateTypes.Environment.empty, universe in
 109   let mono_aliases = true, aliases, Some DisambiguateTypes.Environment.empty in
 110   let passes =
 111     List.map
 112      (function (fresh_instances,env,use_coercions) ->
 113        fresh_instances,
 114        (match env with `Mono -> mono_aliases | `Multi -> multi_aliases |
 115        `Library -> library),
 116        use_coercions) passes in
 117   let try_pass (fresh_instances, (_, aliases, universe), use_coercions) =
 118     f ~fresh_instances ~aliases ~universe ~use_coercions thing
 119   in
 120   let set_aliases (instances,(use_mono_aliases,_,_),_) (_, user_asked as res) =
 121    if use_mono_aliases then
 122     drop_aliases ~minimize_instances:true ~description_of_alias res (* one shot aliases *)
 123    else if user_asked then
 124     drop_aliases ~minimize_instances:true ~description_of_alias res (* one shot aliases *)
 125    else
 126     drop_aliases_and_clear_diff res
 127   in
 128   let rec aux i errors passes =
 129   debug_print (lazy ("Pass: " ^ string_of_int i));
 130    match passes with
 131       [ pass ] ->
 132         (try
 133           set_aliases pass (try_pass pass)
 134          with Disambiguate.NoWellTypedInterpretation (offset,newerrors) ->
 135           raise (DisambiguationError (offset, errors @ [newerrors])))
 136     | hd :: tl ->
 137         (try
 138           set_aliases hd (try_pass hd)
 139         with Disambiguate.NoWellTypedInterpretation (_offset,newerrors) ->
 140          aux (i+1) (errors @ [newerrors]) tl)
 141     | [] -> assert false
 142   in
 143    aux 1 [] passes
 144
 145 let disambiguate_thing ~passes ~freshen_thing ~context ~metasenv ~subst
 146   ~string_context_of_context ~initial_ugraph ~expty ~mk_implicit
 147   ~description_of_alias ~aliases ~universe ~lookup_in_library ~uri ~pp_thing
 148   ~domain_of_thing ~interpretate_thing ~refine_thing ~mk_localization_tbl thing
 149  =
 150   let f ~fresh_instances ~aliases ~universe ~use_coercions (txt,len,thing) =
 151     let thing = if fresh_instances then freshen_thing thing else thing in
 152      Disambiguate.disambiguate_thing
 153       ~context ~metasenv ~subst ~use_coercions ~string_context_of_context
 154       ~initial_ugraph ~expty ~mk_implicit ~description_of_alias
 155       ~aliases ~universe ~lookup_in_library
 156       ~uri ~pp_thing ~domain_of_thing ~interpretate_thing ~refine_thing
 157       ~mk_localization_tbl (txt,len,thing)
 158   in
 159   disambiguate_thing ~description_of_alias ~passes ~aliases ~universe ~f thing