summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2020-08-04 13:26:01 (GMT)
committerBrad King <brad.king@kitware.com>2020-08-04 13:29:42 (GMT)
commit1f1feb72f8b275208a1bb75b728d092d7943229e (patch)
tree4bb60e58fa6fd69e9437a4f3f69d38e00eaf46d4 /Help
parent5becf28f9230eb70e4181b4aa669297781e7f6b1 (diff)
downloadCMake-1f1feb72f8b275208a1bb75b728d092d7943229e.zip
CMake-1f1feb72f8b275208a1bb75b728d092d7943229e.tar.gz
CMake-1f1feb72f8b275208a1bb75b728d092d7943229e.tar.bz2
Help: Document in add_library that IMPORTED_IMPLIB is for DLL import libs
Fixes: #21053
Diffstat (limited to 'Help')
-rw-r--r--Help/command/add_library.rst7
1 files changed, 6 insertions, 1 deletions
diff --git a/Help/command/add_library.rst b/Help/command/add_library.rst
index ed8447e..52536bb 100644
--- a/Help/command/add_library.rst
+++ b/Help/command/add_library.rst
@@ -144,7 +144,12 @@ The ``<type>`` must be one of:
References a library file located outside the project. The
:prop_tgt:`IMPORTED_LOCATION` target property (or its per-configuration
variant :prop_tgt:`IMPORTED_LOCATION_<CONFIG>`) specifies the
- location of the main library file on disk.
+ location of the main library file on disk. In the case of a ``SHARED``
+ library on Windows, the :prop_tgt:`IMPORTED_IMPLIB` target property
+ (or its per-configuration variant :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).
Additional usage requirements may be specified in ``INTERFACE_*`` properties.
An ``UNKNOWN`` library type is typically only used in the implementation of