diff options
Diffstat (limited to 'docs/markdown/CMake-module.md')
| -rw-r--r-- | docs/markdown/CMake-module.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/markdown/CMake-module.md b/docs/markdown/CMake-module.md index fc6157e..48c3d75 100644 --- a/docs/markdown/CMake-module.md +++ b/docs/markdown/CMake-module.md @@ -176,6 +176,43 @@ Options that are not set won't affect the generated subproject. So, if for instance, `set_install` was not called then the values extracted from CMake will be used. +### Cross compilation + +*New in 0.56.0* + +Meson will try to automatically guess most of the required CMake toolchain +variables from existing entries in the cross and native files. These variables +will be stored in an automatically generate CMake toolchain file in the build +directory. The remaining variables that can't be guessed can be added by the +user in the `[cmake]` cross/native file section (*new in 0.56.0*). + +Adding a manual CMake toolchain file is also supported with the +`cmake_toolchain_file` setting in the `[properties]` section. Directly setting +a CMake toolchain file with `-DCMAKE_TOOLCHAIN_FILE=/path/to/some/Toolchain.cmake` +in the `meson.build` is **not** supported since the automatically generated +toolchain file is also used by Meson to inject arbitrary code into CMake to +enable the CMake subproject support. + +The closest configuration to only using a manual CMake toolchain file would be +to set these options in the machine file: + +```ini +[properties] + +cmake_toolchain_file = '/path/to/some/Toolchain.cmake' +cmake_defaults = false + +[cmake] + +# No entries in this section +``` + +This will result in a toolchain file with just the bare minimum to enable the +CMake subproject support and `include()` the `cmake_toolchain_file` as the +last instruction. + +For more information see the [cross and native file specification](Machine-files.md). + ## CMake configuration files ### cmake.write_basic_package_version_file() |