# ACL2 Version 6.3 Installation Guide

### NOTE: From time to time we may provide so-called incremental releases of ACL2. Please follow the recent changes to this page link on the ACL2 home page for more information.

# Easy Install for Unix-like Systems

Here, "Unix-like Systems" includes Unix, GNU-Linux, and MacOS X.

NOTE: A quicker and even easier install may be possible, by instead obtaining a pre-built binary distribution if one is available for your platform. Otherwise:

1. Fetch acl2.tar.gz into a new directory, say `acl2/v6-3/`.
2. Execute the following to create directory `acl2-sources/`:
   `tar xfz acl2.tar.gz`
3. We strongly suggest that you fetch ACL2 community books, for example as a tarball from the Google Code website, into your new `acl2-sources/` directory; then execute the following in `acl2-sources/` to create directory `books/`:
   `tar xfz books-6.3.tar.gz`
4. Obtain a Common Lisp implementation if you don't already have one.
5. Build by connecting to your `acl2-sources/` directory and typing the following, which may take a few minutes to complete. Note: You will need Gnu make. We have seen problems with Version 3.81 of that utility, so if you encounter errors, please consider our instructions for downloading and installing GNU make version 3.80. (That said, in builds with Allegro Common Lisp we have seen problems certifying books with GNU make version 3.80 that seemed to be solved with version 3.81.)

       make LISP=<path_to_your_lisp_executable>

6. OPTIONAL: Download gzipped tarfiles for workshops books and/or nonstd books from the Google Code website into the `books/` directory (but first create `books/` if you skipped that step). Further instructions are here.
7. Certify books (but first create `books/` if you skipped that step), for example as follows.

       make regression
       (time nice make -j 8 ACL2=/u/smith/bin/acl2 regression) >& make-regression.log

   The resulting log file, `make-regression.log`, should contain no occurrences of the string ``CERTIFICATION FAILED''; a normal exit (status 0) should guarantee this. If you want additional explanation and further options, see the documentation for BOOKS-CERTIFICATION.

You now have an ACL2 executable called `saved_acl2` (from step 5) and access to certified community books (from step 7). Enjoy!

THE ABOVE INSTRUCTIONS MAY BE ALL THAT YOU NEED. Otherwise, read on....

# More Information

- REQUIREMENTS
  - Performance comparisons
  - Obtaining Common Lisp
- OBTAINING AND INSTALLING ACL2
  - Pre-built Binary Distributions
  - Obtaining the Sources
  - Creating or Obtaining an Executable Image
  - Running Without Building an Executable Image
  - Summary of Distribution
- USING ACL2
  - Invoking ACL2
    - When ACL2 Starts Up
  - Testing ACL2
  - Certifying ACL2 Books
  - Documentation
- MISCELLANEOUS INFORMATION
  - Problems
  - Reasoning about the Real Numbers
  - Links and Mailing Lists
  - Export/Re-Export Limitations
  - License and Copyright