From 38737e39707d83a4c105da1f3a369080e9b69a0f Mon Sep 17 00:00:00 2001 From: Brad King Date: Tue, 18 Jul 2023 11:11:14 -0400 Subject: Help: Mention imported config mapping in export() and install() docs Suggest the `CMAKE_MAP_IMPORTED_CONFIG_` variable for mapping configurations of dependent projects to configurations exported by these commands. Issue: #25096 --- Help/command/export.rst | 4 ++++ Help/command/install.rst | 2 ++ 2 files changed, 6 insertions(+) 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_` 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_` +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(_)?`` to be exported, when -- cgit v0.12