ACL2 Version 6.3 Installation Guide: Miscellaneous Information

# Miscellaneous Information

[Back to main page of Installation Guide.]

Table of Contents

- Problems
- Reasoning about the Real Numbers
- Links and Mailing Lists
- Export/Re-Export Limitations
- License and Copyright

Please let us know if there is other information that you would find of use in this guide.

### Problems

If you are having problems using the `make' utility, be sure that you are using 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.

Building ACL2 may fail with 32-bit SBCL because of insufficient heap memory. Harsh Raju Chamarthi points out that a fix is to run SBCL with an increased heap size limit, like this:

    make LISP="/sbcl --core /sbcl.core --dynamic-space-size 1024"

He adds that this issue occurred while building ACL2 4.0 with SBCL v1.0.40 on linux, and the default heap size for SBCL on a standard 32-bit linux is 512MB, while for SBCL (64-bit executable) on a 64-bit linux, the default is usually 8GB.

### Reasoning about the Real Numbers

ACL2 supports rational numbers but not real numbers. However, starting with Version 2.5, a variant of ACL2 called "ACL2(r)" supports the real numbers by way of non-standard analysis. ACL2(r) was conceived and first implemented by Ruben Gamboa in his Ph.D. dissertation work, supervised by Bob Boyer with active participation by Matt Kaufmann. See the documentation topic `REAL` for information about this extension and how to build it, and a warning about its experimental nature.

If you care to use ACL2(r), we strongly suggest that you first download the non-standard analysis community books (gzipped tar file) from the Google Code acl2-books project website, and save to the `books/` subdirectory of your copy of the ACL2 distribution, say, dir/acl2-sources/books/. Then extract to create subdirectory `nonstd/`:

    tar xvfz nonstd-6.3.tar.gz

Next build an executable image and certify books. First, connect to your dir`/acl2-sources/` directory and execute
`cd acl2-sources`
`make large-acl2r LISP=`xxx
where xxx is the command to run your local Common Lisp.

By default, if no `LISP=`xxx is specified, `LISP=ccl` is used. On our hosts, `ccl` is the name of Clozure Common Lisp (CCL), which can be obtained as explained in the Requirements document.

This will create executable `saved_acl2r` in the dir`/acl2-sources` directory (notice the trailing `r` in the executable filename).

Finally, to certify books under directory dir/acl2-sources/books/nonstd/`with ACL2(r), stand in the` dir`/acl2-sources/` directory and execute the following command.

    make regression-nonstd ACL2=dir/acl2-sources/saved_acl2r

### Links and Mailing Lists

There are three mailing lists for ACL2 users. You can post messages to these lists only if you are a member.

- `acl2-help@utlists.utexas.edu`
  ACL2 help list, for questions about using ACL2 (recommended for new users)
- `acl2@utlists.utexas.edu`
  General ACL2 list for users and others interested in ACL2
- `acl2-books@googlegroups.com`
  Mailing list for discussion of cutting-edge developments in ACL2 and the ACL2 Community Books

You may subscribe to or unsubscribe from these lists, or view their archives, at:

- (acl2-help list) `https://utlists.utexas.edu/sympa/info/acl2-help`
- (acl2 list) `https://utlists.utexas.edu/sympa/info/acl2`
- (acl2-books Google Group list) `https://groups.google.com/forum/#!forum/acl2-books`

Finally, please report bugs in ACL2 to Matt Kaufmann and J Strother Moore.

### Export/Re-Export Limitations

ACL2 may be exported to any countries except those subject to embargoes under various laws administered by the Office of Foreign Assets Control ("OFAC") of the U. S. Department of the Treasury.

### License and Copyright

ACL2 Version 6.3 -- A Computational Logic for Applicative Common Lisp
Copyright (C) 2013, Regents of the University of Texas

This version of ACL2 is a descendent of ACL2 Version 1.9, Copyright (C) 1997 Computational Logic, Inc.

This program is free software; you can redistribute it and/or modify it under the terms of the LICENSE file distributed with ACL2.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the LICENSE for more details.

Matt Kaufmann (Kaufmann@cs.utexas.edu)
J Strother Moore (Moore@cs.utexas.edu)
Department of Computer Sciences
University of Texas at Austin
Austin, TX 78712-1188 U.S.A.

[Back to Installation Guide.]