summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorKhem Raj <raj.khem@gmail.com>2016-05-05 09:48:28 -0700
committerKhem Raj <raj.khem@gmail.com>2016-05-05 09:48:28 -0700
commit67a069317b65fa89d70fe4e9bff235b41bdb102e (patch)
tree6789fcf255be8af32e0ff68f6215562798787d21 /README.md
parentdc4cf180bc8fbabd3b7588e62b3d90e2460fe1b9 (diff)
downloadmeta-clang-67a069317b65fa89d70fe4e9bff235b41bdb102e.tar.gz
README: Document default compiler switch behavior
Signed-off-by: Khem Raj <raj.khem@gmail.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md25
1 files changed, 21 insertions, 4 deletions
diff --git a/README.md b/README.md
index 21886f4..d3976f2 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,23 @@ BBLAYERS ?= " \
23 " 23 "
24``` 24```
25 25
26# Default Compiler Switch
27
28Note that by default clang will become the system compiler, however if you wish to keep
29gcc be the default compiler and select clang for some packages only then you should
30add
31
32```python
33TOOLCHAIN ?= "gcc"
34```
35
36to local.conf, this would now revert to using gcc as default compiler and then you
37can select clang for packages of your choices by writing bbappends for them containing
38
39```python
40TOOLCHAIN = "clang"
41```
42
26# Building 43# Building
27 44
28Below we build for qemuarm machine as an example 45Below we build for qemuarm machine as an example
@@ -38,7 +55,7 @@ $ runqemu qemux86
38 55
39# Limitations 56# Limitations
40 57
41Currently only few components do not build with clang, if you have a component to add to that list 58Few components do not build with clang, if you have a component to add to that list
42simply create a bbappend under recipes-excluded/nonclangable e.g. 59simply create a bbappend under recipes-excluded/nonclangable e.g.
43 60
44```shell 61```shell
@@ -72,10 +89,10 @@ When sending single patches, please use something like:
72'git send-email -M -1 --to openembedded-devel@lists.openembedded.org --subject-prefix=meta-clang][PATCH' 89'git send-email -M -1 --to openembedded-devel@lists.openembedded.org --subject-prefix=meta-clang][PATCH'
73 90
74You are encouraged to fork the mirror on [github](https://github.com/kraj/meta-clang/) 91You are encouraged to fork the mirror on [github](https://github.com/kraj/meta-clang/)
75to share your patches, this is preferred for patch sets consisting of more than 92to share your patches, this is preferred for patch sets consisting of more than
76one patch. Other services like gitorious, repo.or.cz or self hosted setups are 93one patch. Other services like gitorious, repo.or.cz or self hosted setups are
77of course accepted as well, 'git fetch <remote>' works the same on all of them. 94of course accepted as well, 'git fetch <remote>' works the same on all of them.
78We recommend github because it is free, easy to use, has been proven to be reliable 95We recommend github because it is free, easy to use, has been proven to be reliable
79and has a really good web GUI. 96and has a really good web GUI.
80 97
81Layer Maintainer: [Khem Raj](<mailto:raj.khem@gmail.com>) 98Layer Maintainer: [Khem Raj](<mailto:raj.khem@gmail.com>)