summaryrefslogtreecommitdiffstats
path: root/Help/command
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2021-11-03 19:51:35 (GMT)
committerBrad King <brad.king@kitware.com>2021-11-03 20:17:17 (GMT)
commit001870d451d965a2cc4a30a89ed23e69bcd70b5e (patch)
tree32c62766da2d780c8a86c6fc2bf8b3a25cbb6521 /Help/command
parentf65cebf51a2cf3af2017fd9b03c685c77da00c74 (diff)
downloadCMake-001870d451d965a2cc4a30a89ed23e69bcd70b5e.zip
CMake-001870d451d965a2cc4a30a89ed23e69bcd70b5e.tar.gz
CMake-001870d451d965a2cc4a30a89ed23e69bcd70b5e.tar.bz2
Help: Clarify TARGET_RUNTIME_DLLS behavior on imported targets
This generator expression does not report the locations of `.dll` files on imported targets with the `UNKNWON` type, since their `IMPORTED_LOCATION` refers to the import library and not the DLL. Fixes: #22845
Diffstat (limited to 'Help/command')
-rw-r--r--Help/command/add_library.rst5
1 files changed, 4 insertions, 1 deletions
diff --git a/Help/command/add_library.rst b/Help/command/add_library.rst
index dfc6500..1235155 100644
--- a/Help/command/add_library.rst
+++ b/Help/command/add_library.rst
@@ -166,6 +166,8 @@ itself and is not included as a target in the generated buildsystem.
call are ``PRIVATE`` to the interface library and do not appear in its
:prop_tgt:`INTERFACE_SOURCES` target property.
+.. _`add_library imported libraries`:
+
Imported Libraries
^^^^^^^^^^^^^^^^^^
@@ -205,7 +207,8 @@ The ``<type>`` must be one of:
:prop_tgt:`IMPORTED_IMPLIB_<CONFIG>`) specifies the location of the
DLL import library file (``.lib`` or ``.dll.a``) on disk, and the
``IMPORTED_LOCATION`` is the location of the ``.dll`` runtime
- library (and is optional).
+ library (and is optional, but needed by the :genex:`TARGET_RUNTIME_DLLS`
+ generator expression).
Additional usage requirements may be specified in ``INTERFACE_*`` properties.