diff options
| author | Brad King <brad.king@kitware.com> | 2020-03-26 09:34:23 -0400 |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2020-03-26 09:34:23 -0400 |
| commit | e6344586ee779ee499bd982628e668116fe5314e (patch) | |
| tree | 9bb0966e4f8596d7a688b9508c690f0384bf2ccb | |
| parent | 4b266927c7556f74d11d6f499360d682117e0a60 (diff) | |
| download | cmake-e6344586ee779ee499bd982628e668116fe5314e.tar.gz | |
install: Document caveat when EXPORT name matches package name
Fixes: #20427
| -rw-r--r-- | Help/command/install.rst | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/Help/command/install.rst b/Help/command/install.rst index abf6b175b4..cf04eda56a 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(_<CONFIG>)?`` to be exported, when policy :policy:`CMP0022` is ``NEW``. +.. note:: + The installed ``<export-name>.cmake`` file may come with additional + per-configuration ``<export-name>-*.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 ``<package-name>-config.cmake`` + file or the latter may be incorrectly matched by the glob and loaded. + When a ``COMPONENT`` option is given, the listed ``<component>`` implicitly depends on all components mentioned in the export set. The exported ``<name>.cmake`` file will require each of the exported components to be |