diff options
| author | Brad King <brad.king@kitware.com> | 2015-07-17 15:10:02 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2015-07-17 15:10:02 (GMT) |
| commit | 0fcbd704f8da5ef3ddbe9964c9affb14fc16d640 (patch) | |
| tree | 8882115e1ab1e833492f6eeeb0649e40dcbc88a8 /Modules | |
| parent | a5412fbab45c9386f95fba3567e38c7b1cf8308d (diff) | |
| download | CMake-0fcbd704f8da5ef3ddbe9964c9affb14fc16d640.zip CMake-0fcbd704f8da5ef3ddbe9964c9affb14fc16d640.tar.gz CMake-0fcbd704f8da5ef3ddbe9964c9affb14fc16d640.tar.bz2 | |
CMakeExpandImportedTargets: Document as deprecated
The module is not needed anymore for try_compile or try_run. It cannot
be used with CMP0022 NEW behavior due to generator expressions in
INTERFACE_LINK_LIBRARIES, so document it as deprecated. Whatever
problems other than try_compile and try_run anyone tried to solve with
this module will have to be addressed another way.
Diffstat (limited to 'Modules')
| -rw-r--r-- | Modules/CMakeExpandImportedTargets.cmake | 16 |
1 files changed, 13 insertions, 3 deletions
diff --git a/Modules/CMakeExpandImportedTargets.cmake b/Modules/CMakeExpandImportedTargets.cmake index 8ac3364..28f2e46 100644 --- a/Modules/CMakeExpandImportedTargets.cmake +++ b/Modules/CMakeExpandImportedTargets.cmake @@ -2,6 +2,19 @@ # CMakeExpandImportedTargets # -------------------------- # +# Deprecated. Do not use. +# +# This module was once needed to expand imported targets to the underlying +# libraries they reference on disk for use with the :command:`try_compile` +# and :command:`try_run` commands. These commands now support imported +# libraries in their ``LINK_LIBRARIES`` options (since CMake 2.8.11 +# for :command:`try_compile` and since CMake 3.2 for :command:`try_run`). +# +# This module does not support the policy :policy:`CMP0022` ``NEW`` +# behavior or use of the :prop_tgt:`INTERFACE_LINK_LIBRARIES` property +# because :manual:`generator expressions <cmake-generator-expressions(7)>` +# cannot be evaluated during configuration. +# # :: # # CMAKE_EXPAND_IMPORTED_TARGETS(<var> LIBRARIES lib1 lib2...libN @@ -14,9 +27,6 @@ # respective configuration of the imported targets if it exists. If no # CONFIGURATION is given, it uses the first configuration from # ${CMAKE_CONFIGURATION_TYPES} if set, otherwise ${CMAKE_BUILD_TYPE}. -# This macro is used by all Check*.cmake files which use try_compile() -# or try_run() and support CMAKE_REQUIRED_LIBRARIES , so that these -# checks support imported targets in CMAKE_REQUIRED_LIBRARIES: # # :: # |