The ACL2 theorem proving environment consists of two parts: The ACL2 System and The ACL2 Books. This repository contains both.
The included version of the ACL2 System is the latest, under-development version of the ACL2 Theorem Prover. It is updated only by the ACL2 authors, Matt Kaufmann and J Moore.
WARNING: On rare occasions development versions of ACL2 may be incomplete, fragile, or unable to pass the usual regression tests. You may choose to download an official ACL2 release as described on the ACL2 Home Page or below in this README.
The books/ directory of this repository comprises the Community Books,
which are the canonical collection of open-source libraries for the ACL2
System. As the name suggests, they are updated by the ACL2 community.
-
The Combined ACL2 + Books Manual is updated frequently to track the latest changes to this repository.
-
If you are instead using official, released Version 8.6 of ACL2, see the Version 8.6 Manual instead.
Each of these manuals can be downloaded for offline use by clicking the download button on the right hand side of the upper toolbar while browsing the manual.
While active development of ACL2 occurs at the a
8000
cl2/acl2 repo on
GitHub, stable releases are officially distributed from the
acl2-devel/acl2-devel fork, which exists for that purpose.
You can download a gzipped tarfile or zip file for the latest release, which includes the ACL2 system and the community books, from the releases page on GitHub.
Alternatively you can obtain a copy of the latest release using
git. For example, do the following in a fresh directory
(note the "." at the end).
git clone -b 8.6 https://github.com/acl2-devel/acl2-devel .
The new directory /path/to/somewhere/acl2/ will now contain a copy of
ACL2 Version 8.6. Please see the ACL2 home page, specifically
its installation instructions, for how to build an
executable and certify books in your new directory.
To check out the latest development version of the repository using
git, you can (for example) do the following in a fresh directory
(note the "." at the end):
git clone https://github.com/acl2/acl2 .
See the documentation for how to contribute.
We encourage users of ACL2 to join our mailing lists and take advantage of other ACL2 Community resources.
Everyone can contribute documentation and advice to our wiki and discuss problems and feature requests.
If you would like to contribute to this repository, see the documentation topic git-quick-start. Please note the guidelines for book development.