* 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 subterm.
+(** 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
+ ?equality:(Cic.term -> Cic.term -> bool) -> term:Cic.term -> Cic.term list ->
+ Cic.term
-(** select all subterms of a given term matching a given pattern (i.e. subtrees
-* rooted at pattern's holes. The first component is the context the term lives
-* in). raise Bad_pattern (pattern_entry, term_entry) *)
-val select: term:Cic.term -> pattern:Cic.term -> (Cic.context * Cic.term) 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
+(** 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 ->
+ conjecture:Cic.conjecture ->
+ pattern:ProofEngineTypes.pattern ->
+ [ `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