+ <dl compact>
+ <dt> <A href="http://gcc.gnu.org">GCC</A>
+ <dd>
+ The GNU Compiler Collection must be installed with C and C++ language
+ support. GCC 3.2.x works, and GCC 3.x is generally supported.
+
+ <p>
+ Note that we currently do not support any other C++ compiler.
+ </p>
+
+ <dt> <A href="http://savannah.gnu.org/projects/make">GNU Make</A>
+ <dd>
+ The LLVM build system relies upon GNU Make extensions. Therefore, you
+ will need GNU Make (sometimes known as gmake) to build LLVM.
+ <p>
+
+ <dt> <A href="http://www.gnu.org/software/flex">Flex</A>
+ and
+ <A href="http://www.gnu.org/software/bison/bison.html">Bison</A>
+ <dd>
+ The LLVM source code is built using flex and bison. You will not be
+ able to configure and compile LLVM without them.
+ <p>
+
+ <dt> <A href="http://savannah.gnu.org/projects/m4">GNU M4</A>
+ <dd>
+ If you are installing Bison on your machine for the first time, you
+ will need GNU M4 (version 1.4 or higher).
+ </dl>
+
+ <p>
+ There are some additional tools that you may want to have when working with
+ LLVM:
+ </p>
+
+ <ul>
+ <li><A href="http://www.gnu.org/software/autoconf">GNU Autoconf</A>
+ <li><A href="http://savannah.gnu.org/projects/m4">GNU M4</A>
+ <p>
+ If you want to make changes to the configure scripts, you will need
+ GNU autoconf (2.53 or higher), and consequently, GNU M4 (version 1.4
+ or higher).
+ </p>
+
+ <li><A href="http://www.codesourcery.com/qm/qmtest">QMTest</A>
+ <li><A href="http://www.python.org">Python</A>
+ <p>
+ In order to run the tests in the LLVM test suite, you will need QMTest and
+ a version of the Python interpreter that works with QMTest.
+ </ul>
+
+
+ <p>The remainder of this guide is meant to get you up and running with
+ LLVM and to give you some basic information about the LLVM environment.
+ The <a href"#quickstart">next section</a> gives a short summary for those
+ who are already familiar with the system and want to get started as quickly
+ as possible. A <a href="#starting">complete guide to installation</a> is
+ provided in the subsequent section.
+
+ <p>The later sections of this guide describe the <a
+ href="#layout">general layout</a> of the the LLVM source-tree, a <a
+ href="#tutorial">simple example</a> using the LLVM tool chain, and <a
+ href="#links">links</a> to find more information about LLVM or to get
+ help via e-mail.
+
+ <!--=====================================================================-->
+ <center>
+ <h2><a name="quickstart"><b>Getting Started Quickly (A Summary)</b></a></h2>
+ </center>
+ <hr>
+ <!--=====================================================================-->
+
+ Here's the short story for getting up and running quickly with LLVM:
+ <ol>
+ <li>Install the GCC front end:
+ <ol>
+ <li><tt>cd <i>where-you-want-the-C-front-end-to-live</i></tt>
+ <li><tt>gunzip --stdout cfrontend.<i>platform</i>.tar.gz | tar -xvf
+ -</tt>
+ </ol>
+
+ <p>
+
+ <li>Get the Source Code
+ <ul>
+ <li>With the distributed files:
+ <ol>
+ <li><tt>cd <i>where-you-want-llvm-to-live</i></tt>
+ <li><tt>gunzip --stdout llvm.tar.gz | tar -xvf -</tt>
+ <li><tt>cd llvm</tt>
+ </ol>
+
+ <p>
+
+ <li>With anonymous CVS access:
+ <ol>
+ <li>Find the path to the CVS repository containing LLVM (we'll
+ call this <i>CVSROOTDIR</i>).
+ <li><tt>cd <i>where-you-want-llvm-to-live</i></tt>
+ <li><tt>cvs -d <i>CVSROOTDIR</i> checkout llvm</tt>
+ <li><tt>cd llvm</tt>
+ </ol>
+ </ul>
+ </ul>
+
+ <p>
+
+ <li>Configure the LLVM Build Environment
+ <ol>
+ <li>Change directory to where you want to store the LLVM object
+ files and run <tt>configure</tt> to configure the Makefiles and
+ header files for the default platform.
+ Useful options include:
+ <ul>
+ <li><tt>--with-llvmgccdir=<i>directory</i></tt>
+ <br>
+ Specify where the LLVM GCC frontend is installed.
+ <p>
+
+ <li><tt>--enable-spec2000=<i>directory</i></tt>
+ <br>
+ Enable the SPEC2000 benchmarks for testing. The SPEC2000
+ benchmarks should be available in <tt><i>directory</i></tt>.
+ </ul>
+ </ol>
+
+ <p>
+
+ <li>Build the LLVM Suite
+ <ol>
+ <li>Set your LLVM_LIB_SEARCH_PATH environment variable.
+ <li><tt>gmake -k |& tee gnumake.out
+ # this is csh or tcsh syntax</tt>
+ </ol>
+
+ <p>
+
+ </ol>
+
+ <p>See <a href="#environment">Setting Up Your Environment</a> on tips to
+ simplify working with the LLVM front-end and compiled tools. See the
+ next section for other useful details in working with LLVM,
+ or go straight to <a href="#layout">Program Layout</a> to learn about the
+ layout of the source code tree.
+
+ <!--=====================================================================-->
+ <center>
+ <h2><a name="starting"><b>Getting Started with LLVM</b></a></h2>
+ </center>
+ <hr>
+ <!--=====================================================================-->