User manual for the ACL2 Theorem Prover and
the ACL2 Community Books
ACL2 is an
interactive theorem prover. It combines a Lisp-based programming language for
developing formal models of systems with a reasoning engine that can prove
properties about these models. It has been used to formally verify
many interesting systems in
academia and industry.
The ACL2 Community
Books are the canonical set of open-source libraries ("books") for
ACL2. They include lemma libraries for reasoning in many domains, macro
libraries for more quickly writing and documenting code, interfacing tools for
connecting ACL2 to other systems, productivity tools for better proof
automation and debugging, and specialty libraries for areas like hardware-verification.
This manual was generated on February 4, 2023 22:07:19. It covers
both ACL2 and the Community Books. It is derived by combining
- the documentation for the ACL2 system itself—mostly written by Matt
Kaufmann and J Moore
- the documentation for many Community Books—contributed by numerous
members of the ACL2 community
Besides just importing the documentation, we also rearrange the topic
hierarchy to try to provide a coherent organization.
This manual is very much a work in progress. If you would like to
contribute to its development, please join the acl2 project on GitHub!
- Information about options for downloading and viewing the ACL2
documentation, contributing documentation, and the available tools for
documenting your own books.
- Books are files of ACL2 events—they are the main
way to split up large ACL2 developments into separate modules.
- Recursion and Induction
- Libraries related to representing and processing Boolean functions,
geared toward large-scale automatic reasoning, e.g., via SAT solving and AIG or
- Tools for debugging failed or slow proofs, or misbehaving
- The projects directory of the Community Books contains a variety
of projects that have been carried out with ACL2.
- Standard libraries for ACL2.
- Tools, utilities, and strategies for dealing with particular kinds
- Generally useful macros for writing more concise code, and frameworks
for quickly introducing concepts like typed structures, typed lists, defining
functions with type signatures, and automating other common tasks.
- Documentation for the ACL2 Theorem Prover.
- Libraries and tools for doing basic file
i/o, using raw Common Lisp
libraries, working with the operating
system, and interfacing with other
- Libraries for working with hardware description languages, modeling
- Software verification projects, tools, etc.
- Tools for developing and running tests.
- Math-related libraries: arithmetic, algebra, bit-vectors.