Major Section: MISCELLANEOUS
Examples: "Goal" "goal" "Subgoal *1/3''" "subgoal *1/3''" "Subgoal *1/3''"
When hints are given to the theorem prover, a goal-spec is provided to specify the goal to which the hints are to be applied. The hints provided are carried along innocuously until the named goal arises. When it arises, the hints are ``activated'' for that goal and its descendents.
A legal goal specification may be extracted from the theorem prover's output. Certain lines clearly label formulas, as in
Subgoal *1/3.2' (IMPLIES ... ...)and these lines all give rise to goal specifications. In general, these lines all start either with ``Goal'' or ``Subgoal'' or else with those words preceded by a number in square brackets, as in
Subgoal *1/3.2' (IMPLIES ... ...).A goal specification may be obtained by deleting any surrounding whitespace from such a line and embedding the text in string quotation marks. Thus
"Subgoal *1/3.2'"is the goal specifier for the goal above.
As noted, a hint is applied to a goal when the hint's goal
specification matches the name ACL2 assigns to the goal. The
matching algorithm is case-insensitive. Thus, alternative goal
specifications for the goal above are
"subgoal *1/3.2'" and
"SUBGOAL *1/3.2'". The matching algorithm does not tolerate
non-case discrepancies. Thus,
" Subgoal *1/3.2'" are unacceptable.
Sometimes a formula is given two names, e.g.,
Subgoal *1/14.2' (IMPLIES ... ...) Name the formula above *1.1.It is the first name (the one that starts with ``Goal'' or ``Subgoal'') and not the second which constitutes a legal goal-spec. Roughly speaking, when the system prints the line containing the goal specification, it activates any hints that are attached to that goal-spec. Consider the example above. Suppose
Subgoal *1/14.2'could be proved by using a certain lemma instance. Then the appropriate entry in the hints would be:
("Subgoal *1/14.2'" :use ...)This might surprise you because the system appears to do nothing to
*1/14.2'besides push it for a subsequent induction. But actually between the time the system printed the goal-spec line and the time it decides to push the goal, you can think of the system as trying everything it has. So a
usehint activated when
Subgoal *1/14.2'arises is just what you want.
But what if you want to give an
:induct hint? By the time induction
is tried, the formula has been given the name
*1.1. Well, this is
one you just have to remember:
("Subgoal *1/14.2'" :induct ...).When the above hint is activated the
:inductdirective short-circuits the rest of the processing and sends immediately the formula into the pool of goals to prove by induction. The induct hint is attached to the formula in the pool and when the time comes to turn our attention to that goal, the induct advice is followed.