diff options
Diffstat (limited to 'share/cmake-3.18/Help/policy/CMP0056.rst')
-rw-r--r-- | share/cmake-3.18/Help/policy/CMP0056.rst | 34 |
1 files changed, 0 insertions, 34 deletions
diff --git a/share/cmake-3.18/Help/policy/CMP0056.rst b/share/cmake-3.18/Help/policy/CMP0056.rst deleted file mode 100644 index 834da84..0000000 --- a/share/cmake-3.18/Help/policy/CMP0056.rst +++ /dev/null @@ -1,34 +0,0 @@ -CMP0056 -------- - -Honor link flags in :command:`try_compile` source-file signature. - -The :command:`try_compile` command source-file signature generates a -``CMakeLists.txt`` file to build the source file into an executable. -In order to compile the source the same way as it might be compiled -by the calling project, the generated project sets the value of the -:variable:`CMAKE_<LANG>_FLAGS` variable to that in the calling project. -The value of the :variable:`CMAKE_EXE_LINKER_FLAGS` variable may be -needed in some cases too, but CMake 3.1 and lower did not set it in -the generated project. CMake 3.2 and above prefer to set it so that -linker flags are honored as well as compiler flags. This policy -provides compatibility with the pre-3.2 behavior. - -The ``OLD`` behavior for this policy is to not set the value of the -:variable:`CMAKE_EXE_LINKER_FLAGS` variable in the generated test -project. The ``NEW`` behavior for this policy is to set the value of -the :variable:`CMAKE_EXE_LINKER_FLAGS` variable in the test project -to the same as it is in the calling project. - -If the project code does not set the policy explicitly, users may -set it on the command line by defining the -:variable:`CMAKE_POLICY_DEFAULT_CMP0056 <CMAKE_POLICY_DEFAULT_CMP<NNNN>>` -variable in the cache. - -This policy was introduced in CMake version 3.2. Unlike most policies, -CMake version |release| does *not* warn by default when this policy -is not set and simply uses ``OLD`` behavior. See documentation of the -:variable:`CMAKE_POLICY_WARNING_CMP0056 <CMAKE_POLICY_WARNING_CMP<NNNN>>` -variable to control the warning. - -.. include:: DEPRECATED.txt |