From e6344586ee779ee499bd982628e668116fe5314e Mon Sep 17 00:00:00 2001 From: Brad King Date: Thu, 26 Mar 2020 09:34:23 -0400 Subject: install: Document caveat when EXPORT name matches package name Fixes: #20427 --- Help/command/install.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Help/command/install.rst b/Help/command/install.rst index abf6b17..cf04eda 100644 --- a/Help/command/install.rst +++ b/Help/command/install.rst @@ -644,6 +644,13 @@ present, causes the contents of the properties matching ``(IMPORTED_)?LINK_INTERFACE_LIBRARIES(_)?`` to be exported, when policy :policy:`CMP0022` is ``NEW``. +.. note:: + The installed ``.cmake`` file may come with additional + per-configuration ``-*.cmake`` files to be loaded by + globbing. Do not use an export name that is the same as the package + name in combination with installing a ``-config.cmake`` + file or the latter may be incorrectly matched by the glob and loaded. + When a ``COMPONENT`` option is given, the listed ```` implicitly depends on all components mentioned in the export set. The exported ``.cmake`` file will require each of the exported components to be -- cgit v0.12