Major Section: OTHER
Below, when we talk about ``an event A'', we mean an event whose name is
A.
When event A is used in a proof performed to admit event B that you
submit to ACL2, we say that A is a ``proof-supporter'' of B. ACL2
stores an association list such that for every event B with at least one
proof-supporter, B is associated with a list of all of its
proof-supporters, sorted by symbol-<. The following form evaluates to
that alist, which is called the ``proof-supporters-alist''.
(global-val 'proof-supporters-alist (w state))By ``used in a proof'' above, we mean: applied as a rule or supplied explicitly via hints of type
:use, :by, or
:clause-processor. That is, the events ``used in a proof'' for
admitting an event E are those listed in the summary printed at the
conclusion of admitting E.
Note that if proofs are skipped when admitting event E, say because the
last admission of E was done by include-book (or certify-book,
which ends with an include-book), then there will be no entry in that
alist for E. (An exception is made however for encapsulate
events, where proof-supporters are remembered from the first pass; see
below.) So if you want the proof-supporters-alist to include supporters for
events in a book, use ld rather than include-book or
certify-book to process the events in that book. If however you are
interested in the proof-supporters FROM a book that support a later event,
then it is fine to include that book.
The case for encapsulate is slightly tricky. Consider an example of
the following form.
A ; event preceding the encapsulate (encapsulate () B (local C) ; uses A and B in a proof D ; uses C in a proof )At the conclusion of this
encapsulate event, the proof-supporters-alist
associates D with A and B, but not C (which has disappeared,
since it is local).Note that this sort of ``transitive closure'' operation is only performed
when necessary due to the disappearance of local events. For
example, if we replace (local C) above by just C, then D is
associated in the proof-supporters-alist only with C, not with A or
B. If you want the transitive closure of the relation computed by the
proof-supporters-alist, you have to compute it yourself. (This was a
deliberate design decision, in order to avoid slowing down event processing.)
However, there is help available on how to do such a computation:
A community book, books/misc/dead-events.lisp, does such a transitive
closure, and moreover uses that information to find ``dead events'' relative
to a list of ``desired'' events. For example, suppose you use LD to
process the events, with proofs, in a book intended to prove theorems
MAIN-1 and MAIN-2. (Remember, certify-book will not save such
information.) Suppose furthermore that the book begins with some
include-book forms followed by (deflabel book-start). You could
evaluate this form:
(dead-events '(main-1 main-2) :start 'book-start)The result is a list of events that you probably can delete from the book without causing any proofs to fail. See the
dead-events.lisp book for
further documentation.You might also find the code in the above book to be helpful for writing your own utilities based on the proof-supporters-alist.