1CMP0056 2------- 3 4.. versionadded:: 3.2 5 6Honor link flags in :command:`try_compile` source-file signature. 7 8The :command:`try_compile` command source-file signature generates a 9``CMakeLists.txt`` file to build the source file into an executable. 10In order to compile the source the same way as it might be compiled 11by the calling project, the generated project sets the value of the 12:variable:`CMAKE_<LANG>_FLAGS` variable to that in the calling project. 13The value of the :variable:`CMAKE_EXE_LINKER_FLAGS` variable may be 14needed in some cases too, but CMake 3.1 and lower did not set it in 15the generated project. CMake 3.2 and above prefer to set it so that 16linker flags are honored as well as compiler flags. This policy 17provides compatibility with the pre-3.2 behavior. 18 19The ``OLD`` behavior for this policy is to not set the value of the 20:variable:`CMAKE_EXE_LINKER_FLAGS` variable in the generated test 21project. The ``NEW`` behavior for this policy is to set the value of 22the :variable:`CMAKE_EXE_LINKER_FLAGS` variable in the test project 23to the same as it is in the calling project. 24 25If the project code does not set the policy explicitly, users may 26set it on the command line by defining the 27:variable:`CMAKE_POLICY_DEFAULT_CMP0056 <CMAKE_POLICY_DEFAULT_CMP<NNNN>>` 28variable in the cache. 29 30This policy was introduced in CMake version 3.2. Unlike most policies, 31CMake version |release| does *not* warn by default when this policy 32is not set and simply uses ``OLD`` behavior. See documentation of the 33:variable:`CMAKE_POLICY_WARNING_CMP0056 <CMAKE_POLICY_WARNING_CMP<NNNN>>` 34variable to control the warning. 35 36.. include:: DEPRECATED.txt 37