version 0.7.1

[helm.git] / helm / ocaml / tactics / proofEngineHelpers.mli

diff --git a/helm/ocaml/tactics/proofEngineHelpers.mli b/helm/ocaml/tactics/proofEngineHelpers.mli
index 5cf58999cfb8dd11a16e68ee1f6dcdb70ac08f46..b77fd88ac7e4a36b31cc276124bc049c6f5ddacf 100644 (file)
--- a/helm/ocaml/tactics/proofEngineHelpers.mli
+++ b/helm/ocaml/tactics/proofEngineHelpers.mli
@@ -23,6 +23,8 @@
  * http://cs.unibo.it/helm/.
  *)
 
+exception Bad_pattern of string
+
 (* Returns the first meta whose number is above the *)
 (* number of the higher meta.                       *)
 val new_meta_of_proof : proof:ProofEngineTypes.proof -> int
@@ -41,10 +43,48 @@ val subst_meta_and_metasenv_in_proof :
 val compare_metasenvs :
   oldmetasenv:Cic.metasenv -> newmetasenv:Cic.metasenv -> int list
 
-(** Finds the _pointers_ to subterms that are alpha-equivalent to wanted in t.
- * wanted is properly lifted when binders are crossed *)
-val find_subterms : 
-  eq:(Cic.term -> Cic.term -> bool) ->
-  wanted:Cic.term -> Cic.term -> 
-    Cic.term list
 
+(** { Patterns }
+ * A pattern is a Cic term in which Cic.Implicit terms annotated with `Hole
+ * appears *)
+
+(** create a pattern from a term and a list of subterms.
+* the pattern is granted to have a ? for every subterm that has no selected
+* subterms
+* @param equality equality function used while walking the term. Defaults to
+* physical equality (==) *)
+val pattern_of:
+ ?equality:(Cic.term -> Cic.term -> bool) -> term:Cic.term -> Cic.term list ->
+   Cic.term
+
+
+(** select metasenv conjecture pattern
+* select all subterms of [conjecture] matching [pattern].
+* It returns the set of matched terms (that can be compared using physical
+* equality to the subterms of [conjecture]) together with their contexts.
+* The representation of the set mimics the conjecture type (but for the id):
+* a list of (possibly removed) hypothesis (without their names) together with
+* the list of its matched subterms (and their contexts) + the list of matched
+* 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. *)
+val select:
+ metasenv:Cic.metasenv ->
+ ugraph:CicUniv.universe_graph ->
+ conjecture:Cic.conjecture ->
+ pattern:ProofEngineTypes.pattern ->
+  Cic.substitution * Cic.metasenv * CicUniv.universe_graph *
+  [ `Decl of (Cic.context * Cic.term) list
+  | `Def of (Cic.context * Cic.term) list * (Cic.context * Cic.term) list option
+  ] option list *
+  (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.                *)
+val saturate_term:
+ int -> Cic.metasenv -> Cic.context -> Cic.term ->
+  Cic.term * Cic.metasenv * Cic.term list * int