X-Git-Url: http://matita.cs.unibo.it/gitweb/?a=blobdiff_plain;f=helm%2Focaml%2Ftactics%2FproofEngineHelpers.mli;h=e28e1425d8fd69270ba896bcf1c703a1cc2f0b58;hb=4167cea65ca58897d1a3dbb81ff95de5074700cc;hp=f71574aef4bf67d560b8df8a0a6bee6b7e469f9f;hpb=961a5b5095b72f566fd1412267ef68a820d5aa3d;p=helm.git

diff --git a/helm/ocaml/tactics/proofEngineHelpers.mli b/helm/ocaml/tactics/proofEngineHelpers.mli
index f71574aef..e28e1425d 100644
--- a/helm/ocaml/tactics/proofEngineHelpers.mli
+++ b/helm/ocaml/tactics/proofEngineHelpers.mli
@@ -23,7 +23,7 @@
  * http://cs.unibo.it/helm/.
  *)
 
-exception Bad_pattern of string
+exception Bad_pattern of string Lazy.t
 
 (* Returns the first meta whose number is above the *)
 (* number of the higher meta.                       *)
@@ -68,7 +68,10 @@ val pattern_of:
 * subterms of the conclusion with their context. Note: in the result the list
 * of hypotheses * has an entry for each entry in the context and in the same
 * order. Of course the list of terms (with their context) associated to one
-* hypothesis may be empty. *)
+* hypothesis may be empty. 
+*
+* @raise Bad_pattern
+* *)
 val select:
  metasenv:Cic.metasenv ->
  ugraph:CicUniv.universe_graph ->
@@ -80,18 +83,34 @@ val select:
   ] option list *
   (Cic.context * Cic.term) list
 
-(** locate_in_conjecture what where
-* [what] must be a physical pointer to a subterm of [where]
-* It returns the context of [what] in [where] *)
-val locate_in_conjecture: Cic.term -> Cic.conjecture -> Cic.context
+(** locate_in_term equality what where context
+* [what] must match a subterm of [where] according to [equality]
+* It returns the matched terms together with their contexts in [where]
+* [equality] defaults to physical equality
+* [context] must be the context of [where]
+*)
+val locate_in_term:
+ ?equality:(Cic.context -> Cic.term -> Cic.term -> bool) ->
+  Cic.term -> where:Cic.term -> Cic.context -> (Cic.context * Cic.term) list
 
-(* saturate_term newmeta metasenv context ty                                  *)
-(* Given a type [ty] (a backbone), it returns its head and a new metasenv in  *)
-(* which there is new a META for each hypothesis, a list of arguments for the *)
-(* new applications and the index of the last new META introduced. The nth    *)
-(* argument in the list of arguments is just the nth new META.                *)
+(** locate_in_conjecture equality what where context
+* [what] must match a subterm of [where] according to [equality]
+* It returns the matched terms together with their contexts in [where]
+* [equality] defaults to physical equality
+* [context] must be the context of [where]
+*)
+val locate_in_conjecture:
+ ?equality:(Cic.context -> Cic.term -> Cic.term -> bool) ->
+  Cic.term -> Cic.conjecture -> (Cic.context * Cic.term) list
+
+(* saturate_term newmeta metasenv context ty goal_arity                       *)
+(* Given a type [ty] (a backbone), it returns its suffix of length            *)
+(* [goal_arity] head and a new metasenv in which there is new a META for each *)
+(* hypothesis, a list of arguments for the new applications and the index of  *)
+(* the last new META introduced. The nth argument in the list of arguments is *)
+(* just the nth new META.                                                     *)
 val saturate_term:
- int -> Cic.metasenv -> Cic.context -> Cic.term ->
+ int -> Cic.metasenv -> Cic.context -> Cic.term -> int ->
   Cic.term * Cic.metasenv * Cic.term list * int
 
 (* returns the index and the type of a premise in a context *)