File: installation.html

package info (click to toggle)
acl2 7.2dfsg-3
  • links: PTS
  • area: main
  • in suites: stretch
  • size: 198,968 kB
  • ctags: 182,300
  • sloc: lisp: 2,415,261; ansic: 5,675; perl: 5,577; xml: 3,576; sh: 3,255; cpp: 2,835; makefile: 2,440; ruby: 2,402; python: 778; ml: 763; yacc: 709; csh: 355; php: 171; lex: 162; tcl: 44; java: 24; asm: 23; haskell: 17
file content (133 lines) | stat: -rw-r--r-- 5,484 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
<HTML>
<HEAD><TITLE>ACL2 Version 7.2 Installation Guide</TITLE></HEAD>

<BODY TEXT="#000000" BGCOLOR="#FFFFFF" STYLE="font-family:'Verdana'">

<H1><A NAME="top"><a href="http://www.cs.utexas.edu/users/moore/acl2/v7-2/index.html">ACL2</a> Version 7.2 Installation Guide</A></H1>

<H3>NOTE: From time to time we may provide so-called <i>incremental
releases</i> of ACL2.  Please follow the <a
href="http://www.cs.utexas.edu/users/moore/acl2/v7-2/HTML/new.html">recent changes
to this page</a> link on the <a
href="http://www.cs.utexas.edu/users/moore/acl2/">ACL2 home page</a> for more
information.</H3>

<hr size=3 noshade>

<H1>Easy Install for Unix-like Systems</H1>

Here, "Unix-like Systems" includes Unix, GNU-Linux, and MacOS X.  Note
that a quicker and even easier install may be possible, by instead
obtaining
a <a href="obtaining-and-installing.html#Shortcuts">pre-built binary
distribution</a> if one is available for your platform.  Otherwise,
you can follow the directions below, which start by fetching a file
hosted at <a href="https://github.com/acl2/acl2/">the github ACL2
System and Books website</a>.  The result is a directory containing
not only the ACL2 system but, in the <code>books/</code> subdirectory,
the <i><a href="http://www.cs.utexas.edu/users/moore/acl2/current/combined-manual/?topic=ACL2____COMMUNITY-BOOKS">community
books</a></i> (libraries).  The ACL2 <i>system</i> is developed at the
University of Texas at Austin
and <a href="obtaining-and-installing.html#Summary">can also be
obtained or explored separately</a>.

<ol>

<li>Fetch a <a href="https://github.com/acl2-devel/acl2-devel/releases/download/7.2/acl2-7.2.tar.gz">gzipped tar file from GitHub</a> containing ACL2 Version 7.2 and the
  corresponding Community Books, which will download
  file <code>acl2-7.2.tar.gz</code> onto your system.  Put that file
  in a directory whose pathname does not contain whitespace.</li>

<li>Execute the following to create
  subdirectory <code>acl2-7.2/</code>.  (These installation
  instructions assume that you don't rename the new subdirectory,
  though you are welcome to do so.)<br>
<code>tar xfz acl2-7.2.tar.gz</code></li>

<li><a href="requirements.html">Obtain a Common Lisp implementation</a> if you don't
already have one.</li>

<li>Build by connecting to the new <code>acl2-7.2/</code> directory
and typing the following, which may take a few minutes to complete.
<font color="red">Note:</font> You will need Gnu make.  We have seen
problems on some Linux systems with Version 3.81 of that utility, so
if you encounter errors, please consider
our <a href="installing-make.html">instructions for downloading and
installing GNU make version 3.80</a>.
<pre>
make LISP=&lt;path_to_your_lisp_executable&gt;
</pre></li>

This will create a script in your <code>acl2-7.2</code>
directory for running ACL2, named <code>saved_acl2</code>.

<li><A NAME="certify-books">Certify books, for example with
<pre>
make certify-books
</pre>
or something fancier such as the following:
<pre>
(time nice make -j 8 ACL2=/u/smith/bin/acl2 certify-books) >& make-certify-books.log
</pre>
This may take up to several hours.  The resulting log
file, <code>make-certify-books.log</code>, 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 <A HREF="http://www.cs.utexas.edu/users/moore/acl2/v7-2/combined-manual/index.html?topic=ACL2____BOOKS-CERTIFICATION">BOOKS-CERTIFICATION</A>.

</ol>

You now have an ACL2 executable called <code>saved_acl2</code> (from step 4)
and access to certified community books (from step 5).  Enjoy!

<hr size=3 noshade>

<b><font size="+2" color="ff0000">THE ABOVE INSTRUCTIONS MAY BE ALL THAT YOU
NEED.</font></b> Otherwise, read on....

<hr size=3 noshade>

<p>

<H1>More Information</H1>

<UL>
<LI><A HREF="requirements.html">REQUIREMENTS</A>
<UL>
  <LI><A HREF="requirements.html#Performance">Performance comparisons</A>
  <LI><A HREF="requirements.html#Obtaining-Lisp">Obtaining Common Lisp</A>
</UL>
<LI><A HREF="obtaining-and-installing.html">OBTAINING AND INSTALLING ACL2</A>
<UL>
  <LI><A HREF="obtaining-and-installing.html#Shortcuts">Pre-built Binary Distributions</A>
  <LI><A HREF="obtaining-and-installing.html#Sources">Obtaining the Sources</A>
  <LI><A HREF="obtaining-and-installing.html#Create-Image">Creating or Obtaining an Executable Image</A>
  <LI><A HREF="obtaining-and-installing.html#Running">Running Without Building an Executable Image</A>
  <LI><A HREF="obtaining-and-installing.html#Summary">Summary of Distribution</A>
</UL>
<LI><A HREF="using.html">USING ACL2</A>
<UL>
  <LI><A HREF="using.html#Invoking">Invoking ACL2</A>
  <UL>
    <LI><A HREF="using.html#Starting">When ACL2 Starts Up</A>
  </UL>
  <LI><A HREF="using.html#Testing">Testing ACL2</A>
  <LI><A HREF="using.html#Certifying">Certifying ACL2 Books</A>
  <LI><A HREF="using.html#Documentation">Documentation</A>
  <LI><A HREF="using.html#Emacs">Emacs</A>
</UL>
<LI><A HREF="misc.html#Miscellaneous">MISCELLANEOUS INFORMATION</A>
<UL>
  <LI><A HREF="misc.html#Problems">Problems</A>
  <LI><A HREF="misc.html#ACL2r">Reasoning about the Real Numbers</A>
  <LI><A HREF="misc.html#Addresses">Links and Mailing Lists</A>
  <LI><A HREF="misc.html#Export">Export/Re-Export Limitations</A>
  <LI><A HREF="misc.html#License-and-Copyright">License and Copyright</A>
</UL>
</UL>
<P>


</BODY>
</HTML>