diff options
| author | Khem Raj <raj.khem@gmail.com> | 2016-05-05 09:48:28 -0700 |
|---|---|---|
| committer | Khem Raj <raj.khem@gmail.com> | 2016-05-05 09:48:28 -0700 |
| commit | 67a069317b65fa89d70fe4e9bff235b41bdb102e (patch) | |
| tree | 6789fcf255be8af32e0ff68f6215562798787d21 /README.md | |
| parent | dc4cf180bc8fbabd3b7588e62b3d90e2460fe1b9 (diff) | |
| download | meta-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.md | 25 |
1 files changed, 21 insertions, 4 deletions
| @@ -23,6 +23,23 @@ BBLAYERS ?= " \ | |||
| 23 | " | 23 | " |
| 24 | ``` | 24 | ``` |
| 25 | 25 | ||
| 26 | # Default Compiler Switch | ||
| 27 | |||
| 28 | Note that by default clang will become the system compiler, however if you wish to keep | ||
| 29 | gcc be the default compiler and select clang for some packages only then you should | ||
| 30 | add | ||
| 31 | |||
| 32 | ```python | ||
| 33 | TOOLCHAIN ?= "gcc" | ||
| 34 | ``` | ||
| 35 | |||
| 36 | to local.conf, this would now revert to using gcc as default compiler and then you | ||
| 37 | can select clang for packages of your choices by writing bbappends for them containing | ||
| 38 | |||
| 39 | ```python | ||
| 40 | TOOLCHAIN = "clang" | ||
| 41 | ``` | ||
| 42 | |||
| 26 | # Building | 43 | # Building |
| 27 | 44 | ||
| 28 | Below we build for qemuarm machine as an example | 45 | Below we build for qemuarm machine as an example |
| @@ -38,7 +55,7 @@ $ runqemu qemux86 | |||
| 38 | 55 | ||
| 39 | # Limitations | 56 | # Limitations |
| 40 | 57 | ||
| 41 | Currently only few components do not build with clang, if you have a component to add to that list | 58 | Few components do not build with clang, if you have a component to add to that list |
| 42 | simply create a bbappend under recipes-excluded/nonclangable e.g. | 59 | simply 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 | ||
| 74 | You are encouraged to fork the mirror on [github](https://github.com/kraj/meta-clang/) | 91 | You are encouraged to fork the mirror on [github](https://github.com/kraj/meta-clang/) |
| 75 | to share your patches, this is preferred for patch sets consisting of more than | 92 | to share your patches, this is preferred for patch sets consisting of more than |
| 76 | one patch. Other services like gitorious, repo.or.cz or self hosted setups are | 93 | one patch. Other services like gitorious, repo.or.cz or self hosted setups are |
| 77 | of course accepted as well, 'git fetch <remote>' works the same on all of them. | 94 | of course accepted as well, 'git fetch <remote>' works the same on all of them. |
| 78 | We recommend github because it is free, easy to use, has been proven to be reliable | 95 | We recommend github because it is free, easy to use, has been proven to be reliable |
| 79 | and has a really good web GUI. | 96 | and has a really good web GUI. |
| 80 | 97 | ||
| 81 | Layer Maintainer: [Khem Raj](<mailto:raj.khem@gmail.com>) | 98 | Layer Maintainer: [Khem Raj](<mailto:raj.khem@gmail.com>) |
