diff options
| author | Craig Scott <craig.scott@crascit.com> | 2019-07-03 09:00:58 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2019-07-03 09:01:13 (GMT) |
| commit | 1cc8f85e1a167b786ecd2acb13c1455c9ecd5f61 (patch) | |
| tree | 5e618bfa669f8f8fae6daad37138081c0f3d3892 | |
| parent | f219b48d8afdaf1b72065158e00b3f42383cbb16 (diff) | |
| parent | 16434fe303a6bd8394a07177e3cef928b446f918 (diff) | |
| download | CMake-1cc8f85e1a167b786ecd2acb13c1455c9ecd5f61.zip CMake-1cc8f85e1a167b786ecd2acb13c1455c9ecd5f61.tar.gz CMake-1cc8f85e1a167b786ecd2acb13c1455c9ecd5f61.tar.bz2 | |
Merge topic 'doc-toolchain-file-CMAKE_SOURCE_DIR'
16434fe303 Help: Discourage using CMAKE_SOURCE_DIR in toolchain files
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !3495
| -rw-r--r-- | Help/manual/cmake-toolchains.7.rst | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/Help/manual/cmake-toolchains.7.rst b/Help/manual/cmake-toolchains.7.rst index df4531b..7435d9a 100644 --- a/Help/manual/cmake-toolchains.7.rst +++ b/Help/manual/cmake-toolchains.7.rst @@ -101,6 +101,14 @@ values for the compilers. The :variable:`CMAKE_CROSSCOMPILING` variable is set to true when CMake is cross-compiling. +Note that using the :variable:`CMAKE_SOURCE_DIR` or :variable:`CMAKE_BINARY_DIR` +variables inside a toolchain file is typically undesirable. The toolchain +file is used in contexts where these variables have different values when used +in different places (e.g. as part of a call to :command:`try_compile`). In most +cases, where there is a need to evaluate paths inside a toolchain file, the more +appropriate variable to use would be :variable:`CMAKE_CURRENT_LIST_DIR`, since +it always has an unambiguous, predictable value. + Cross Compiling for Linux ------------------------- |