diff --git a/docs/GettingStarted.html b/docs/GettingStarted.html index 54bd289f2da..c9aa30422ad 100644 --- a/docs/GettingStarted.html +++ b/docs/GettingStarted.html @@ -624,12 +624,23 @@ revision), you can specify a label. The following releases have the following label:

+

If you would like to get the LLVM test suite (a separate package as of 1.4), +you get it from the CVS repository:

+
+  cd llvm/projects
+  cvs -z3 -d :pserver:anon@llvm-cvs.cs.uiuc.edu:/var/cvs/llvm co llvm-test
+
+

By placing it in the llvm/projects, it will be automatically +conifgured by the LLVM configure script as well as automatically updated when +you run cvs update.

+

If you would like to get the GCC front end source code, you can also get it from the CVS repository:

@@ -703,10 +714,10 @@ not for the faint of heart, so be forewarned.

Once checked out from the CVS repository, the LLVM suite source code must be -configured via the configure script. This script sets variables in -llvm/Makefile.config and llvm/include/Config/config.h. It -also populates OBJ_ROOT with the Makefiles needed to begin building -LLVM.

+configured via the configure script. This script sets variables in the +various *.in files, most notably llvm/Makefile.config and +llvm/include/Config/config.h. It also populates OBJ_ROOT with +the Makefiles needed to begin building LLVM.

The following environment variables are used by the configure script to configure the build system:

@@ -732,47 +743,40 @@ script to configure the build system:

The following options can be used to set or enable LLVM specific options:

-
--with-llvmgccdir=LLVMGCCDIR +
--with-llvmgccdir=LLVMGCCDIR
Path to the location where the LLVM GCC front end binaries and associated libraries were installed. This must be specified as an absolute pathname.

-

--enable-optimized + +
--with-tclinclude
+
Path to the tcl include directory under which the tclsh can be + found. Use this if you have multiple tcl installations on your machine and you + want to use a specific one (8.x) for LLVM. LLVM only uses tcl for running the + dejagnu based test suite in llvm/test. If you don't specify this + option, the LLVM configure script will search for tcl 8.4 and 8.3 releases. +
+
--enable-optimized
Enables optimized compilation by default (debugging symbols are removed and GCC optimization flags are enabled). The default is to use an unoptimized build (also known as a debug build).

-

--enable-jit + +
--enable-jit
Compile the Just In Time (JIT) compiler functionality. This is not available on all platforms. The default is dependent on platform, so it is best to explicitly enable it if you want it.

-

--enable-spec2000 -
--enable-spec2000=<directory> -
- Enable the use of SPEC2000 when testing LLVM. This is disabled by default - (unless configure finds SPEC2000 installed). By specifying - directory, you can tell configure where to find the SPEC2000 - benchmarks. If directory is left unspecified, configure - uses the default value - /home/vadve/shared/benchmarks/speccpu2000/benchspec. -

-

--enable-spec95 -
--enable-spec95=<directory> -
- Enable the use of SPEC95 when testing LLVM. It is similar to the - --enable-spec2000 option. -

-

--enable-povray -
--enable-povray=<directory> -
- Enable the use of Povray as an external test. Versions of Povray written - in C should work. This option is similar to the --enable-spec2000 - option. +
+
--enable-doxygen
+
Look for the doxygen program and enable construction of doxygen based + documentation from the source code. This is disabled by default because + generating the documentation can take a long time and producess 100s of + megabytes of output.

To configure LLVM, follow these steps:

@@ -785,13 +789,13 @@ script to configure the build system:

  • Run the configure script located in the LLVM source tree:
    - SRC_ROOT/configure + SRC_ROOT/configure --prefix=/install/path [other options]

    In addition to running configure, you must set the -LLVM_LIB_SEARCH_PATH environment variable in your startup scripts. -This environment variable is used to locate "system" libraries like +LLVM_LIB_SEARCH_PATH environment variable in your startup shell +scripts. This environment variable is used to locate "system" libraries like "-lc" and "-lm" when linking. This variable should be set to the absolute path of the bytecode-libs subdirectory of the GCC front end, or LLVMGCCDIR/bytecode-libs. For example, one might set @@ -862,7 +866,7 @@ source code:

    generated C/C++ files, libraries, and executables.

    -

    gmake distclean +
    gmake dist-clean
    Removes everything that gmake clean does, but also removes files generated by configure. It attempts to return the source tree to the @@ -871,11 +875,12 @@ source code:

    gmake install
    - Installs LLVM libraries and tools in a heirarchy under $PREFIX, specified with - ./configure --prefix=[dir], defaults to /usr/local. + Installs LLVM header files, libraries, tools and documentation in a heirarchy + under $PREFIX, specified with ./configure --prefix=[dir], which + defaults to /usr/local.

    -

    gmake -C runtime install +
    gmake -C runtime install-bytecode
    Assuming you built LLVM into $OBJDIR, when this command is run, it will install bytecode libraries into the GCC front end's bytecode library @@ -884,6 +889,10 @@ source code:

    +

    Please see the Makefile Guide for further +details on these make targets and descriptions of other targets +available.

    +

    It is also possible to override default values from configure by declaring variables on the command line. The following are some examples:

    @@ -902,6 +911,11 @@ declaring variables on the command line. The following are some examples:

    Print what gmake is doing on standard output.

    + +

    gmake TOOL_VERBOSE=1
    +
    Ask each tool invoked by the makefiles to print out what it is doing on + the standard output. This also implies VERBOSE=1 so the makefile +

    Every directory in the LLVM object tree includes a Makefile to build @@ -943,9 +957,9 @@ named after the build type:

    Tools -
    OBJ_ROOT/tools/Debug +
    OBJ_ROOT/Debug/bin
    Libraries -
    OBJ_ROOT/lib/Debug +
    OBJ_ROOT/Debug/lib

    @@ -953,9 +967,9 @@ named after the build type:

    Tools -
    OBJ_ROOT/tools/Release +
    OBJ_ROOT/Release/bin
    Libraries -
    OBJ_ROOT/lib/Release +
    OBJ_ROOT/Release/lib

    @@ -963,9 +977,9 @@ named after the build type:

    Tools -
    OBJ_ROOT/tools/Profile +
    OBJ_ROOT/Profile/bin
    Libraries -
    OBJ_ROOT/lib/Profile +
    OBJ_ROOT/Profile/lib
    @@ -980,7 +994,8 @@ named after the build type:

    If you're running on a linux system that supports the "binfmt_misc" + href="http://www.tat.physik.uni-tuebingen.de/~rguenth/linux/binfmt_misc.html"> + binfmt_misc" module, and you have root access on the system, you can set your system up to execute LLVM bytecode files directly. To do this, use commands like this (the first command may not be required if you are already using the module):