From 0565262be35423b60a69b5df32c4ca485e976b12 Mon Sep 17 00:00:00 2001 From: Nirbheek Chauhan Date: Sat, 26 May 2018 00:10:32 +0530 Subject: Add documentation for Builtin options and bitcode Also add a test that ensures that new base options and compiler options are always documented. --- docs/markdown/snippets/bitcode_support.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 docs/markdown/snippets/bitcode_support.md (limited to 'docs/markdown/snippets') diff --git a/docs/markdown/snippets/bitcode_support.md b/docs/markdown/snippets/bitcode_support.md new file mode 100644 index 0000000..a0d7ad9 --- /dev/null +++ b/docs/markdown/snippets/bitcode_support.md @@ -0,0 +1,15 @@ +## New base build option for LLVM (Apple) bitcode support + +When building with clang on macOS, you can now build your static and shared +binaries with embedded bitcode by enabling the `b_bitcode` [base +option](Builtin-options.md#Base_options) by passing `-Db_bitcode=true` to +Meson. + +This is better than passing the options manually in the environment since Meson +will automatically disable conflicting options such as `b_asneeded`, and will +disable bitcode support on targets that don't support it such as +`shared_module()`. + +Since this requires support in the linker, it is currently only enabled when +using Apple ld. In the future it can be extended to clang on other platforms +too. -- cgit v1.1