fix typo in llvm generator tool README
[dragonfly.git] / tools / tools / llvm_generator / README
blob50416a3d73855d3b8b7e73bc5db227015b5aaf76
1 This tool generates llvm + clang makefile from the vendor CMake files.
3 How to regenerate makefiles using llvm38 as an example:
5   1) > (cd /usr/dports/devel/llvm38 && make clean && make patch)
6   2) > make LLVMVER=38 LLVMFULLVER=3.8.0
7   3) > make install
9 How to add additional targets to clang:
11   A) set CLANG_EXTRA_TARGETS variable /etc/make.conf
12   B) valid value is any combination of
13      "AArch64", "AMDGPU", "ARM", "Mips", "PowerPC"
14   C) e.g. "CLANG_EXTRA_TARGETS= AArch64 ARM"
16 To build DragonFly's base LLVM
18   1) > (cd /usr/dports/devel/llvm38 && make clean && make patch)
19   2) > (cd /usr/obj/dports/devel/llvm38/llvm-3.8.0.src && \
20         patch < /usr/src/tools/tools/llvm_generator/patches/*)
21   3) > (cd /usr/src/contrib && \
22         ln -s /usr/obj/dports/devel/llvm38/llvm-3.8.0.src llvm)
23   4) > (cd /usr/src/llvm_clang && make)
24   5) > mkdir /usr/libexec/clang /usr/libdata/clang
25      > (cd /usr/src/llvm_clang && make install)
27 After installing the base clang, it can be used with CCVER and
28 WORLD_CCVER set in the environment or /etc/make.conf, e.g.
30   > env CCVER=clang cc --version
31   clang version 3.8.0 (tags/RELEASE_380/final)
32   Target: x86_64-pc-dragonfly
33   Thread model: posix
34   InstalledDir: /usr/libexec/clang