libcxx: Add settings to build with libcxx as default C++ standard library

Signed-off-by: Robin Lee <cheeselee@fedoraproject>

1 files changed, 23 insertions, 1 deletions

diff --git a/README.md b/README.md
index d63060d..986f77c 100644
--- a/README.md
+++ b/README.md
@@ -39,6 +39,22 @@ you can select clang per package too by writing bbappends for them containing
 TOOLCHAIN = "clang"
 ```
 
+# Default C++ Standard Library Switch
+
+Note that by default libstdc++ will remain the default C++ standard library, however if you wish
+libc++ to be the default one then set
+
+```python
+TARGET_CXXFLAGS_append_toolchain-clang ?= " -stdlib=libc++ "
+```
+
+in local.conf.
+You can select libc++ per package too by writing bbappends for them containing
+
+```python
+TARGET_CXXFLAGS_append_toolchain-clang = " -stdlib=libc++ "
+```
+
 # Building
 
 Below we build for qemuarm machine as an example
@@ -61,7 +77,13 @@ simply add it to conf/nonclangable.inc e.g.
 TOOLCHAIN_pn-<recipe> = "gcc"
 ```
 
-and OE will start using gcc to cross compile that recipe,
+and OE will start using gcc to cross compile that recipe.
+
+And if a component does not build with libc++, you can add it to conf/nonclangable.inc e.g.
+
+```shell
+TARGET_CXXFLAGS_remove_pn-<recipe>_toolchain-clang = " -stdlib=libc++ "
+```
 
 # Dependencies