diff options
| author | Brad King <brad.king@kitware.com> | 2022-07-08 13:05:43 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2022-07-08 13:05:51 (GMT) |
| commit | 983a5b1a7e5ae11f996e05af158036574d4c70bf (patch) | |
| tree | a3dbe38bc78bca0bf977abadc3904be453bf3f6c | |
| parent | cf043b91509a5139d6dc1b779406ff48f0790e03 (diff) | |
| parent | 52164be69156b16ea7592b8b46820c80d9a70be9 (diff) | |
| download | CMake-983a5b1a7e5ae11f996e05af158036574d4c70bf.zip CMake-983a5b1a7e5ae11f996e05af158036574d4c70bf.tar.gz CMake-983a5b1a7e5ae11f996e05af158036574d4c70bf.tar.bz2 | |
Merge topic 'install-destination-docs'
52164be691 Help: Clarify behavior of install(TARGETS) for DLLs
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !7457
| -rw-r--r-- | Help/command/install.rst | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/Help/command/install.rst b/Help/command/install.rst index beb2157..5aa3a4b 100644 --- a/Help/command/install.rst +++ b/Help/command/install.rst @@ -229,9 +229,7 @@ that may be installed: For each of these arguments given, the arguments following them only apply to the target or file type specified in the argument. If none is given, the -installation properties apply to all target types. If only one is given then -only targets of that type will be installed (which can be used to install -just a DLL or just an import library.) +installation properties apply to all target types. For regular executables, static libraries and shared libraries, the ``DESTINATION`` argument is not required. For these target types, when @@ -245,6 +243,14 @@ Apple bundles and frameworks. A destination can be omitted for interface and object libraries, but they are handled differently (see the discussion of this topic toward the end of this section). +For shared libraries on DLL platforms, if neither ``RUNTIME`` nor ``ARCHIVE`` +destinations are specified, both the ``RUNTIME`` and ``ARCHIVE`` components are +installed to their default destinations. If either a ``RUNTIME`` or ``ARCHIVE`` +destination is specified, the component is installed to that destination, and +the other component is not installed. If both ``RUNTIME`` and ``ARCHIVE`` +destinations are specified, then both components are installed to their +respective destinations. + The following table shows the target types with their associated variables and built-in defaults that apply when no destination is given: |