diff --git a/docs/GCCFEBuildInstrs.html b/docs/GCCFEBuildInstrs.html index 80863f6b626..097bd3de6a2 100644 --- a/docs/GCCFEBuildInstrs.html +++ b/docs/GCCFEBuildInstrs.html @@ -29,29 +29,20 @@
-

This section describes how to acquire and build llvm-gcc 4.0 and 4.2, which are -based on the GCC 4.0.1/4.2.1 front-ends respectively. Both front-ends support C, -C++, Objective-C and Objective-C++. The 4.2 front-end also supports Ada and -Fortran to some extent. Note that the instructions for building these front-ends -are completely different (and much easier!) than those for building llvm-gcc3 in -the past.

+

This section describes how to acquire and build llvm-gcc 4.2, which is based +on the GCC 4.2.1 front-end. Supported languages are Ada, C, C++, Fortran, +Objective-C and Objective-C++. Note that the instructions for building these +front-ends are completely different (and much easier!) than those for building +llvm-gcc3 in the past.

    -
  1. Retrieve the appropriate llvm-gcc4.x-y.z.source.tar.gz archive from the +

  2. Retrieve the appropriate llvm-gcc-4.2-x.y.source.tar.gz archive from the llvm web site.

    It is also possible to download the sources of the llvm-gcc front end - from a read-only mirror using subversion. To check out the 4.0 code + from a read-only mirror using subversion. To check out the 4.2 code for first time use:

    -
    -
    -svn co http://llvm.org/svn/llvm-project/llvm-gcc-4.0/trunk dst-directory
    -
    -
    - -

    To check out the 4.2 code use:

    -
     svn co http://llvm.org/svn/llvm-project/llvm-gcc-4.2/trunk dst-directory
    @@ -93,19 +84,17 @@ top-level README.LLVM file, adding ",ada" to EXTRALANGS, for example:
       
  3. The build requires having a compiler that supports Ada, C and C++. The Ada front-end is written in Ada so an Ada compiler is needed to build it. Compilers known to work with the - LLVM 2.2 release + LLVM 2.3 release are gcc-4.2 and the - 2005 GNAT GPL Edition. - LLVM from subversion - also works with the - 2006 and 2007 GNAT GPL Editions. + 2005, 2006 and 2007 versions of the + GNAT GPL Edition. The LLVM parts of llvm-gcc are written in C++ so a C++ compiler is needed to build them. The rest of gcc is written in C. Some linux distributions provide a version of gcc that supports all three languages (the Ada part often comes as an add-on package to the rest of gcc). Otherwise it is possible to combine two versions of gcc, one that supports Ada and C (such as the - 2005 GNAT GPL Edition) + 2007 GNAT GPL Edition) and another which supports C++, see below.

  4. Because the Ada front-end is experimental, it is wise to build the compiler with checking enabled. This causes it to run much slower, but @@ -121,9 +110,9 @@ top-level README.LLVM file, adding ",ada" to EXTRALANGS, for example: and unpack it:

    -
    wget http://llvm.org/releases/2.2/llvm-2.2.tar.gz
    -tar xzf llvm-2.2.tar.gz
    -mv llvm-2.2 llvm
    +
    wget http://llvm.org/releases/2.3/llvm-2.3.tar.gz
    +tar xzf llvm-2.3.tar.gz
    +mv llvm-2.3 llvm

    or check out the @@ -139,9 +128,9 @@ mv llvm-2.2 llvm

  5. and unpack it:

    -
    wget http://llvm.org/releases/2.2/llvm-gcc4.2-2.2.source.tar.gz
    -tar xzf llvm-gcc4.2-2.2.source.tar.gz
    -mv llvm-gcc4.2-2.2.source llvm-gcc-4.2
    +
    wget http://llvm.org/releases/2.3/llvm-gcc-4.2-2.3.source.tar.gz
    +tar xzf llvm-gcc-4.2-2.3.source.tar.gz
    +mv llvm-gcc4.2-2.3.source llvm-gcc-4.2

    or check out the @@ -186,7 +175,7 @@ cd llvm-objects

  6. Install LLVM (optional):

    -
    make install
    +
    make ENABLE_OPTIMIZED=0 install
  7. @@ -203,12 +192,12 @@ cd llvm-gcc-4.2-objects
  8. Configure llvm-gcc (here it is configured to install into /usr/local). The --enable-checking flag turns on sanity checks inside the compiler. - If you omit it then LLVM must be built with make ENABLE_OPTIMIZED=1. + If you omit it then LLVM should be built with make ENABLE_OPTIMIZED=1. Additional languages can be appended to the --enable-languages switch, for example --enable-languages=ada,c,c++.

    -
    ../llvm-gcc-4.2/configure --prefix=/usr/local --enable-languages=ada,c --enable-checking --enable-llvm=$PWD/../llvm-objects --disable-shared --disable-bootstrap --disable-multilib
    +
    ../llvm-gcc-4.2/configure --prefix=/usr/local --enable-languages=ada,c --enable-checking --enable-llvm=$PWD/../llvm-objects --disable-bootstrap --disable-multilib

    If you have a multi-compiler setup, then you can configure like this:

    @@ -217,7 +206,7 @@ cd llvm-gcc-4.2-objects
     export CC=PATH_TO_C_AND_ADA_COMPILER
     export CXX=PATH_TO_C++_COMPILER
    -../llvm-gcc-4.2/configure --prefix=/usr/local --enable-languages=ada,c --enable-checking --enable-llvm=$PWD/../llvm-objects --disable-shared --disable-bootstrap --disable-multilib
    +../llvm-gcc-4.2/configure --prefix=/usr/local --enable-languages=ada,c --enable-checking --enable-llvm=$PWD/../llvm-objects --disable-bootstrap --disable-multilib