X-Git-Url: http://demsky.eecs.uci.edu/git/?a=blobdiff_plain;f=docs%2FGettingStarted.html;h=eed4547a7818ef78de98eef2c66f921590e77727;hb=26825a84e97790adaffc55c6101b9fe2524fe1b7;hp=e2b07a68237afb2daf82403ef684b118789ddc0f;hpb=763856526f6d98f8cce313590fb2555628e36f04;p=oota-llvm.git diff --git a/docs/GettingStarted.html b/docs/GettingStarted.html index e2b07a68237..eed4547a781 100644 --- a/docs/GettingStarted.html +++ b/docs/GettingStarted.html @@ -17,37 +17,37 @@
  • Getting Started Quickly (A Summary)
  • Requirements
      -
    1. Hardware -
    2. Software -
    3. Broken versions of GCC and other tools +
    4. Hardware
      5. +
    5. Software
      6. +
    6. Broken versions of GCC and other tools
  • Getting Started with LLVM
      -
    1. Terminology and Notation -
    2. Setting Up Your Environment -
    3. Unpacking the LLVM Archives -
    4. Checkout LLVM from Subversion -
    5. Install the GCC Front End -
    6. Local LLVM Configuration -
    7. Compiling the LLVM Suite Source Code -
    8. Cross-Compiling LLVM -
    9. The Location of LLVM Object Files -
    10. Optional Configuration Items +
    11. Terminology and Notation
      12. +
    12. Setting Up Your Environment
      13. +
    13. Unpacking the LLVM Archives
      14. +
    14. Checkout LLVM from Subversion
      15. +
    15. Install the GCC Front End
      16. +
    16. Local LLVM Configuration
      17. +
    17. Compiling the LLVM Suite Source Code
      18. +
    18. Cross-Compiling LLVM
      19. +
    19. The Location of LLVM Object Files
      20. +
    20. Optional Configuration Items
  • Program layout
      -
    1. llvm/examples -
    2. llvm/include -
    3. llvm/lib -
    4. llvm/projects -
    5. llvm/runtime -
    6. llvm/test -
    7. llvm-test -
    8. llvm/tools -
    9. llvm/utils -
    10. llvm/win32 +
    11. llvm/examples
      12. +
    12. llvm/include
      13. +
    13. llvm/lib
      14. +
    14. llvm/projects
      15. +
    15. llvm/runtime
      16. +
    16. llvm/test
      17. +
    17. llvm-test
      18. +
    18. llvm/tools
      19. +
    19. llvm/utils
      20. +
    20. llvm/win32
  • An Example Using the LLVM Tool Chain @@ -114,7 +114,7 @@ and performance.
  • Read the documentation.
  • Read the documentation.
  • Remember that you were warned twice about reading the documentation.
    • -
  • Install the llvm-gcc4.0 (or llvm-gcc4.2) front end if you intend to compile C or C++: +
  • Install the llvm-gcc4.2 front end if you intend to compile C or C++:
    1. cd where-you-want-the-C-front-end-to-live
    2. gunzip --stdout llvm-gcc.platform.tar.gz | tar -xvf - @@ -236,7 +236,7 @@ software you will need.

      GCC - MacOS X2 + MacOS X2,9 x86 GCC @@ -320,6 +320,11 @@ project.
      3. future. We highly recommend that you rebuild your current binutils with the patch from Binutils bugzilla, if it wasn't already applied. +
    3. XCode 2.5 and gcc 4.0.1 (Apple Build 5370) will trip + internal LLVM assert messages when compiled for Release at optimization + levels greater than 0 (i.e., “-O1” and higher). + Add OPTIMIZE_OPTION="-O0" to the build command line + if compiling for LLVM Release or bootstrapping the LLVM toolchain.
    @@ -338,7 +343,7 @@ on your platform.

    The GCC front end is not very portable at the moment. If you want to get it to work on another platform, you can download a copy of the source and try to compile it on your platform.

    +href="GCCFEBuildInstrs.html">try to compile it on your platform.

    @@ -469,7 +474,6 @@ href="CFEBuildInstrs.html">try to compile it on your platform.

  • date - print the current date/time
  • echo - print to standard output
  • egrep - extended regular expression search utility
    • -
  • etags - C/C++ tag file creator for vim/emacs
  • find - find files/dirs in a file system
  • grep - regular expression search utility
  • gzip* - gzip command for distribution generation
    • @@ -511,14 +515,15 @@ of GCC you are using. problems in the STL that effectively prevent it from compiling LLVM.

    -

    GCC 3.2.2: This version of GCC fails to compile LLVM.

    +

    GCC 3.2.2 and 3.2.3: These versions of GCC fails to compile LLVM with +a bogus template error. This was fixed in later GCCs.

    GCC 3.3.2: This version of GCC suffered from a serious bug which causes it to crash in the "convert_from_eh_region_ranges_1" GCC function.

    Cygwin GCC 3.3.3: The version of GCC 3.3.3 commonly shipped with - Cygwin does not work. Please upgrade + Cygwin does not work. Please upgrade to a newer version if possible.

    SuSE GCC 3.3.3: The version of GCC 3.3.3 shipped with SuSE 9.1 (and possibly others) does not compile LLVM correctly (it appears that exception @@ -533,6 +538,10 @@ the "convert_from_eh_region_ranges_1" GCC function.

    builds with "make ENABLE_OPTIMIZED=1 OPTIMIZE_OPTION=-O2 ..."

    GCC 3.4.x on X86-64/amd64: GCC miscompiles portions of LLVM.

    +

    GCC 3.4.4 (CodeSourcery ARM 2005q3-2): this compiler miscompiles LLVM + when building with optimizations enabled. It appears to work with + "make ENABLE_OPTIMIZED=1 OPTIMIZE_OPTION=-O1" or build a debug + build.

    IA-64 GCC 4.0.0: The IA-64 version of GCC 4.0.0 is known to miscompile LLVM.

    Apple Xcode 2.3: GCC crashes when compiling LLVM at -O3 (which is the @@ -707,6 +716,8 @@ revision), you can checkout it from the 'tags' directory (instead of subdirectories of the 'tags' directory: