comparison docs/GettingStartedVS.rst @ 100:7d135dc70f03 LLVM 3.9

LLVM 3.9
author Miyagi Mitsuki <e135756@ie.u-ryukyu.ac.jp>
date Tue, 26 Jan 2016 22:53:40 +0900
parents 60c9769439b8
children 1172e4bd9c6f
comparison
equal deleted inserted replaced
96:6418606d0ead 100:7d135dc70f03
10 ======== 10 ========
11 Welcome to LLVM on Windows! This document only covers LLVM on Windows using 11 Welcome to LLVM on Windows! This document only covers LLVM on Windows using
12 Visual Studio, not mingw or cygwin. In order to get started, you first need to 12 Visual Studio, not mingw or cygwin. In order to get started, you first need to
13 know some basic information. 13 know some basic information.
14 14
15 There are many different projects that compose LLVM. The first is the LLVM 15 There are many different projects that compose LLVM. The first piece is the
16 suite. This contains all of the tools, libraries, and header files needed to 16 LLVM suite. This contains all of the tools, libraries, and header files needed
17 use LLVM. It contains an assembler, disassembler, 17 to use LLVM. It contains an assembler, disassembler, bitcode analyzer and
18 bitcode analyzer and bitcode optimizer. It also contains a test suite that can 18 bitcode optimizer. It also contains basic regression tests that can be used to
19 be used to test the LLVM tools. 19 test the LLVM tools and the Clang front end.
20 20
21 Another useful project on Windows is `Clang <http://clang.llvm.org/>`_. 21 The second piece is the `Clang <http://clang.llvm.org/>`_ front end. This
22 Clang is a C family ([Objective]C/C++) compiler. Clang mostly works on 22 component compiles C, C++, Objective C, and Objective C++ code into LLVM
23 Windows, but does not currently understand all of the Microsoft extensions 23 bitcode. Clang typically uses LLVM libraries to optimize the bitcode and emit
24 to C and C++. Because of this, clang cannot parse the C++ standard library 24 machine code. LLVM fully supports the COFF object file format, which is
25 included with Visual Studio, nor parts of the Windows Platform SDK. However, 25 compatible with all other existing Windows toolchains.
26 most standard C programs do compile. Clang can be used to emit bitcode, 26
27 directly emit object files or even linked executables using Visual Studio's 27 The last major part of LLVM, the execution Test Suite, does not run on Windows,
28 ``link.exe``. 28 and this document does not discuss it.
29
30 The large LLVM test suite cannot be run on the Visual Studio port at this
31 time.
32
33 Most of the tools build and work. ``bugpoint`` does build, but does
34 not work.
35 29
36 Additional information about the LLVM directory structure and tool chain 30 Additional information about the LLVM directory structure and tool chain
37 can be found on the main :doc:`GettingStarted` page. 31 can be found on the main :doc:`GettingStarted` page.
38 32
39 33