summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2023-07-18 15:11:14 (GMT)
committerBrad King <brad.king@kitware.com>2023-07-18 15:11:14 (GMT)
commit38737e39707d83a4c105da1f3a369080e9b69a0f (patch)
tree6321b0dec43905989d36f3b7407146c03c93cd78
parent59ed19304b9ea0cf89811e2ecec58cda75f3aa3c (diff)
downloadCMake-38737e39707d83a4c105da1f3a369080e9b69a0f.zip
CMake-38737e39707d83a4c105da1f3a369080e9b69a0f.tar.gz
CMake-38737e39707d83a4c105da1f3a369080e9b69a0f.tar.bz2
Help: Mention imported config mapping in export() and install() docs
Suggest the `CMAKE_MAP_IMPORTED_CONFIG_<CONFIG>` variable for mapping configurations of dependent projects to configurations exported by these commands. Issue: #25096
-rw-r--r--Help/command/export.rst4
-rw-r--r--Help/command/install.rst2
2 files changed, 6 insertions, 0 deletions
diff --git a/Help/command/export.rst b/Help/command/export.rst
index 0f79f63..2e14a10 100644
--- a/Help/command/export.rst
+++ b/Help/command/export.rst
@@ -78,6 +78,10 @@ to automatically export the same targets from the build tree as
transitive usage requirements of other targets that link to the
object libraries in their implementation.
+This command exports all :ref:`build configurations` from the build tree.
+See the :variable:`CMAKE_MAP_IMPORTED_CONFIG_<CONFIG>` variable to map
+configurations of dependent projects to the exported configurations.
+
Exporting Targets to Android.mk
"""""""""""""""""""""""""""""""
diff --git a/Help/command/install.rst b/Help/command/install.rst
index d5092ae..b56f20c 100644
--- a/Help/command/install.rst
+++ b/Help/command/install.rst
@@ -835,6 +835,8 @@ the ``FILE`` option must be a file name with the ``.cmake`` extension.
If a ``CONFIGURATIONS`` option is given then the file will only be installed
when one of the named configurations is installed. Additionally, the
generated import file will reference only the matching target
+configurations. See the :variable:`CMAKE_MAP_IMPORTED_CONFIG_<CONFIG>`
+variable to map configurations of dependent projects to the installed
configurations. The ``EXPORT_LINK_INTERFACE_LIBRARIES`` keyword, if
present, causes the contents of the properties matching
``(IMPORTED_)?LINK_INTERFACE_LIBRARIES(_<CONFIG>)?`` to be exported, when