diff options
| author | Brad King <brad.king@kitware.com> | 2020-10-19 14:23:44 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2020-10-19 14:23:50 (GMT) |
| commit | 860e40de6bbe77c7ce42fb2a8cf2c93baa45302b (patch) | |
| tree | 1c47944a166b880832b157244ac3383a2e6209f5 /Help/policy | |
| parent | fd0aab88d561b9c323e3ffcd763df6f2b1d254f5 (diff) | |
| parent | 5c3a91c8080f0b12e07865e01f5dfdd76867ca09 (diff) | |
| download | CMake-860e40de6bbe77c7ce42fb2a8cf2c93baa45302b.zip CMake-860e40de6bbe77c7ce42fb2a8cf2c93baa45302b.tar.gz CMake-860e40de6bbe77c7ce42fb2a8cf2c93baa45302b.tar.bz2 | |
Merge topic 'doc-CMP0111'
5c3a91c808 CMP0111: Clarify that the new error is on a missing property setting
Acked-by: Kitware Robot <kwrobot@kitware.com>
Acked-by: Alex Reinking <alex_reinking@berkeley.edu>
Merge-request: !5385
Diffstat (limited to 'Help/policy')
| -rw-r--r-- | Help/policy/CMP0111.rst | 13 |
1 files changed, 10 insertions, 3 deletions
diff --git a/Help/policy/CMP0111.rst b/Help/policy/CMP0111.rst index 37e5ad5..e327583 100644 --- a/Help/policy/CMP0111.rst +++ b/Help/policy/CMP0111.rst @@ -3,10 +3,17 @@ CMP0111 .. versionadded:: 3.19 -An imported target with a missing location fails during generation. +An imported target missing its location property fails during generation. -Prior to this the location would be generated as ``<TARGET_NAME>-NOTFOUND``, -which would result in build failures. +:ref:`Imported Targets` for library files and executables require that +their location on disk is specified in a target property such as +:prop_tgt:`IMPORTED_LOCATION`, :prop_tgt:`IMPORTED_IMPLIB`, or a +per-configuration equivalent. If a needed location property is not set, +CMake 3.18 and below generate the string ``<TARGET_NAME>-NOTFOUND`` in +its place, which results in failures of the corresponding rules at build +time. CMake 3.19 and above prefer instead to raise an error during +generation. This policy provides compatibility for projects that have +not been updated to expect the new behavior. The ``OLD`` behavior of this policy is to generate the location of an imported unknown, static or shared library target as ``<TARGET_NAME>-NOTFOUND`` if not |