X-Git-Url: http://plrg.eecs.uci.edu/git/?a=blobdiff_plain;f=docs%2FGettingStarted.html;h=8bb1ac41e4fd443959a017d6f4532ce00b7676f2;hb=0dd27da1841ca50d00aad3465f4f9b6a646fd64e;hp=e9a03a22fd7557a1fa3336510bba83a20528afde;hpb=c40eb5e0d23113fec92a39682e7ae3ca720f7e87;p=oota-llvm.git diff --git a/docs/GettingStarted.html b/docs/GettingStarted.html index e9a03a22fd7..8bb1ac41e4f 100644 --- a/docs/GettingStarted.html +++ b/docs/GettingStarted.html @@ -17,44 +17,42 @@
  • Getting Started Quickly (A Summary)
  • Requirements
      -
    1. Hardware -
    2. Software -
    3. Broken versions of GCC +
    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 CVS -
    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. CVS directories -
    2. llvm/examples -
    3. llvm/include -
    4. llvm/lib -
    5. llvm/projects -
    6. llvm/runtime -
    7. llvm/test -
    8. llvm-test -
    9. llvm/tools -
    10. llvm/utils -
    11. llvm/win32 +
    12. llvm/examples
      13. +
    13. llvm/include
      14. +
    14. llvm/lib
      15. +
    15. llvm/projects
      16. +
    16. llvm/runtime
      17. +
    17. llvm/test
      18. +
    18. llvm-test
      19. +
    19. llvm/tools
      20. +
    20. llvm/utils
      21. +
    21. llvm/win32
  • An Example Using the LLVM Tool Chain
    1. Example with llvm-gcc4
      2. -
    2. Example with llvm-gcc3
  • Common Problems
  • Links @@ -84,14 +82,14 @@ basic information.

    First, LLVM comes in two pieces. The first piece is the LLVM suite. This contains all of the tools, libraries, and header files needed to use the low -level virtual machine. It contains an assembler, disassembler, bytecode -analyzer and bytecode optimizer. It also contains a test suite that can be +level virtual machine. It contains an assembler, disassembler, bitcode +analyzer and bitcode optimizer. It also contains a test suite that can be used to test the LLVM tools and the GCC front end.

    The second piece is the GCC front end. This component provides a version of -GCC that compiles C and C++ code into LLVM bytecode. Currently, the GCC front -end is a modified version of GCC 3.4 (we track the GCC 3.4 development). Once -compiled into LLVM bytecode, a program can be manipulated with the LLVM tools +GCC that compiles C and C++ code into LLVM bitcode. Currently, the GCC front +end uses the GCC parser to convert code to LLVM. Once +compiled into LLVM bitcode, a program can be manipulated with the LLVM tools from the LLVM suite.

    @@ -116,19 +114,20 @@ and performance.

  • Read the documentation.
  • Read the documentation.
  • Remember that you were warned twice about reading the documentation.
    • -
  • Install the GCC front end if you intend to compile C or C++: +
  • Install the llvm-gcc-4.2 front end if you intend to compile C or C++ + (see Install the GCC Front End for details):
    1. cd where-you-want-the-C-front-end-to-live
      2. -
    2. gunzip --stdout cfrontend.platform.tar.gz | tar -xvf - -
      3. -
    3. cd cfrontend/platform
      - ./fixheaders
      4. -
    4. Add the cfrontend's "bin" directory to your PATH variable.
      5. +
    5. gunzip --stdout llvm-gcc-4.2-version-platform.tar.gz | tar -xvf -
      6. +
    6. install-binutils-binary-from-MinGW (Windows only)
      7. +
    7. Note: If the binary extension is ".bz" use bunzip2 instead of gunzip.
      8. +
    8. Note: On Windows, use 7-Zip or a similar archiving tool.
      9. +
    9. Add llvm-gcc's "bin" directory to your PATH environment variable.
  • Get the LLVM Source Code