diff options
| author | Alexandru Croitor <alexandru.croitor@qt.io> | 2019-06-21 09:47:37 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2019-06-21 15:59:38 (GMT) |
| commit | 96c6bc25845c31da4031f667b583baf6f121a1c2 (patch) | |
| tree | 39e9e2b3a3de2e7a4aa1afe715829d7f98d7cf2b /Help/prop_tgt | |
| parent | 5c7880956f9b3daea561c7bf817b27aa47b53dd0 (diff) | |
| download | CMake-96c6bc25845c31da4031f667b583baf6f121a1c2.zip CMake-96c6bc25845c31da4031f667b583baf6f121a1c2.tar.gz CMake-96c6bc25845c31da4031f667b583baf6f121a1c2.tar.bz2 | |
Help: Improve documentation of IMPORTED_LOCATION property
Mention the usage of a configuration specific
`IMPORTED_LOCATION_<CONFIG>` value even if the `<CONFIG>` is not the
same as the active configuration of the currently built project.
Co-Author: Brad King <brad.king@kitware.com>
Diffstat (limited to 'Help/prop_tgt')
| -rw-r--r-- | Help/prop_tgt/IMPORTED_LOCATION.rst | 15 |
1 files changed, 11 insertions, 4 deletions
diff --git a/Help/prop_tgt/IMPORTED_LOCATION.rst b/Help/prop_tgt/IMPORTED_LOCATION.rst index d674f29..a9123cd 100644 --- a/Help/prop_tgt/IMPORTED_LOCATION.rst +++ b/Help/prop_tgt/IMPORTED_LOCATION.rst @@ -15,7 +15,14 @@ is the location of the ``.dll`` part of the library. For ``UNKNOWN`` libraries this is the location of the file to be linked. Ignored for non-imported targets. -Projects may skip ``IMPORTED_LOCATION`` if the configuration-specific -property :prop_tgt:`IMPORTED_LOCATION_<CONFIG>` is set. To get the location -of an imported target read one of the :prop_tgt:`LOCATION` or -``LOCATION_<CONFIG>`` properties. +The ``IMPORTED_LOCATION`` target property may be overridden for a +given configuration ``<CONFIG>`` by the configuration-specific +:prop_tgt:`IMPORTED_LOCATION_<CONFIG>` target property. Furthermore, +the :prop_tgt:`MAP_IMPORTED_CONFIG_<CONFIG>` target property may be +used to map between a project's configurations and those of an imported +target. If none of these is set then the name of any other configuration +listed in the :prop_tgt:`IMPORTED_CONFIGURATIONS` target property may be +selected and its :prop_tgt:`IMPORTED_LOCATION_<CONFIG>` value used. + +To get the location of an imported target read one of the :prop_tgt:`LOCATION` +or ``LOCATION_<CONFIG>`` properties. |