Author: baldrick
Date: Tue Feb 12 15:22:58 2008
New Revision: 47027
URL: http://llvm.org/viewvc/llvm-project?rev=47027view=rev
Log:
Add instructions for building Ada and Fortran.
Adjust mentions of gcc4 to be 4.0/4.2 agnostic.
This file should probably be renamed tor
GCCFEBuildInstrs.html...
Modified:
llvm/trunk/docs/CFEBuildInstrs.html
Modified: llvm/trunk/docs/CFEBuildInstrs.html
URL:
http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CFEBuildInstrs.html?rev=47027r1=47026r2=47027view=diff
==
--- llvm/trunk/docs/CFEBuildInstrs.html (original)
+++ llvm/trunk/docs/CFEBuildInstrs.html Tue Feb 12 15:22:58 2008
@@ -9,11 +9,11 @@
body
div class=doc_title
- Building the LLVM C/C++ Front-End
+ Building the LLVM GCC Front-End
/div
ol
- lia href=#instructionsBuilding llvm-gcc 4 from Source/a/li
+ lia href=#instructionsBuilding llvm-gcc from Source/a/li
lia href=#licenseLicense Information/a/li
/ol
@@ -23,25 +23,26 @@
!-- ***
--
div class=doc_section
- a name=instructionsBuilding llvm-gcc 4 from Source/a
+ a name=instructionsBuilding llvm-gcc from Source/a
/div
!-- ***
--
div class=doc_text
-pThis section describes how to aquire and build llvm-gcc4, which is based on
-the GCC 4.0.1 front-end. This front-end supports C, C++, Objective-C, and
-Objective-C++. Note that the instructions for building this front-end are
-completely different (and much easier!) than those for building llvm-gcc3 in
+pThis 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./p
ol
- lipRetrieve the appropriate llvm-gcc4-x.y.source.tar.gz archive from the
+ lipRetrieve the appropriate llvm-gcc4.x-y.z.source.tar.gz archive from
the
a href=http://llvm.org/releases/;llvm web site/a./p
- pIt is also possible to download the sources of the llvm-gcc4 front end
- from a read-only mirror using subversion. To check out the code the
- first time use:/p
+ pIt 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
+ for first time use:/p
div class=doc_code
pre
@@ -49,6 +50,14 @@
/pre
/div
+pTo check out the 4.2 code use:/p
+
+div class=doc_code
+pre
+svn co http://llvm.org/svn/llvm-project/llvm-gcc-4.2/trunk idst-directory/i
+/pre
+/div
+
pAfter that, the code can be be updated in the destination directory
using:/p
@@ -59,10 +68,174 @@
pThe mirror is brought up to date every evening./p/li
liFollow the directions in the top-level ttREADME.LLVM/tt file for
- up-to-date instructions on how to build llvm-gcc4./li
+ up-to-date instructions on how to build llvm-gcc. See below for building
+ with support for Ada or Fortran.
+/ol
+
+/div
+
+!-- ***
--
+div class=doc_section
+ a name=licenseBuilding the Ada front-end/a
+/div
+
+div class=doc_text
+pBuilding with support for Ada amounts to following the directions in the
+top-level ttREADME.LLVM/tt file, adding ,ada to EXTRALANGS, for example:
+ttEXTRALANGS=,ada/tt/p
+
+pThere are some complications however:/p
+
+ol
+ liThe only platform for which the Ada front-end is known to build is
+ 32 bit intel x86 running linux. It is unlikely to build for other
+ systems without some work./li
+ liThe 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. 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
+ a href=http://libre.adacore.com/;GNAT GPL Edition/a) and another
+ which supports C++, see below./li
+/ol
+
+pSupposing appropriate compilers are available, llvm-gcc with Ada support can
+ be built using the following recipe:/p
+
+ol
+ liDownload the a href=http://llvm.org/releases/download.html;LLVM
source/a
+ and unpack it:
+
+div class=doc_code
+prewget http://llvm.org/releases/2.2/llvm-2.2.tar.gz
+tar xzf llvm-2.2.tar.gz
+mv llvm-2.2 llvm/pre
+/div
+
+ or a