Q.MATCH_ASSUM_RENAME_TAC : term quotation -> tactic

- STRUCTURE
- SYNOPSIS
- Replaces selected terms with new variables by matching a pattern against an assumption.
- DESCRIPTION
- When applied to the goal (asl, w), the tactic Q.MATCH_ASSUM_RENAME_TAC q parses the quotation q in the context of the goal, producing a term to use as a pattern. The tactic then attempts a (first order) match of the pattern against each term in asl, stopping on the first matching assumption a.
For each variable v in the pattern, there will be an instantiation term t, such that the substitution

produces a. The effect of the tactic is to then replace each t with the corresponding v, yielding a new goal. Note that underscores within a pattern, though strictly speaking variables, are not included in this reverse instantiation.pattern[v1 |-> t1, v2 |-> t2, ...]

- FAILURE
- MATCH_ASSUM_RENAME_TAC fails if the pattern provided does not match any assumption, or if variables from the goal are used in the pattern in ways that make the pattern fail to type-check.
- EXAMPLE
- If the current goal isthen applying the tactic Q.MATCH_ASSUM_RENAME_TAC `_ = Pair c1 c2` results in the goal
(f x = Pair C'' C0') ?- (f C'' = f C0')

(f x = Pair c1 c2) ?- (f c1 = f c2)

- COMMENTS
- This tactic improves on the following tedious workflow: Q.PAT_ASSUM pat MP_TAC, Q.MATCH_ABBREV_TAC `pat ==> X`, Q.UNABBREV_TAC `X`, markerLib.RM_ALL_ABBREVS_TAC, STRIP_TAC.
- SEEALSO

HOL Kananaskis-14