diff options
| author | Brad King <brad.king@kitware.com> | 2023-03-03 14:10:37 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2023-03-03 14:10:54 (GMT) |
| commit | 10f318326fef873928311d5964a12db4f8a10d82 (patch) | |
| tree | 25b0a802f1f628ef9759e42a33fdcdeeb4a3d525 | |
| parent | c465e0e3bb3b653b23caf6fbb5c9b31dbf8dd55d (diff) | |
| parent | 8adcb739567aae6be3a501cb1bf2856e2db25c79 (diff) | |
| download | CMake-10f318326fef873928311d5964a12db4f8a10d82.zip CMake-10f318326fef873928311d5964a12db4f8a10d82.tar.gz CMake-10f318326fef873928311d5964a12db4f8a10d82.tar.bz2 | |
Merge topic 'doc-IMPORTED_CONFIGURATIONS'
8adcb73956 Help:IMPORTED_CONFIGURATIONS: Mention relation to IMPORTED_LOCATION
e1032a22eb Help:IMPORTED_IMPLIB: Mention IMPORTED_IMPLIB_<CONFIG> variant
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !8281
| -rw-r--r-- | Help/prop_tgt/IMPORTED_CONFIGURATIONS.rst | 25 | ||||
| -rw-r--r-- | Help/prop_tgt/IMPORTED_IMPLIB.rst | 9 |
2 files changed, 26 insertions, 8 deletions
diff --git a/Help/prop_tgt/IMPORTED_CONFIGURATIONS.rst b/Help/prop_tgt/IMPORTED_CONFIGURATIONS.rst index 6de1baa..8605548 100644 --- a/Help/prop_tgt/IMPORTED_CONFIGURATIONS.rst +++ b/Help/prop_tgt/IMPORTED_CONFIGURATIONS.rst @@ -1,11 +1,20 @@ IMPORTED_CONFIGURATIONS ----------------------- -Configurations provided for an IMPORTED target. - -Set this to the list of configuration names available for an IMPORTED -target. The names correspond to configurations defined in the project -from which the target is imported. If the importing project uses a -different set of configurations the names may be mapped using the -MAP_IMPORTED_CONFIG_<CONFIG> property. Ignored for non-imported -targets. +Configurations provided for an :ref:`imported target <Imported targets>`. + +Set this to the list of configuration names available for an imported +target. For each configuration named, the imported target's artifacts +must be specified in other target properties: + +* :prop_tgt:`IMPORTED_LOCATION_<CONFIG>`, or +* :prop_tgt:`IMPORTED_IMPLIB_<CONFIG>` (on DLL platforms), or +* :prop_tgt:`IMPORTED_OBJECTS_<CONFIG>` (for :ref:`Object Libraries`), or +* :prop_tgt:`IMPORTED_LIBNAME_<CONFIG>` (for :ref:`Interface Libraries`). + +The configuration names correspond to those defined in the project from +which the target is imported. If the importing project uses a different +set of configurations, the names may be mapped using the +:prop_tgt:`MAP_IMPORTED_CONFIG_<CONFIG>` target property. + +The ``IMPORTED_CONFIGURATIONS`` property is ignored for non-imported targets. diff --git a/Help/prop_tgt/IMPORTED_IMPLIB.rst b/Help/prop_tgt/IMPORTED_IMPLIB.rst index 77549f3..e67acba 100644 --- a/Help/prop_tgt/IMPORTED_IMPLIB.rst +++ b/Help/prop_tgt/IMPORTED_IMPLIB.rst @@ -12,4 +12,13 @@ This property may be set: the :prop_tgt:`ENABLE_EXPORTS` target property). For frameworks this is the location of the ``.tbd`` file symlink just inside the framework folder. +The ``IMPORTED_IMPLIB`` target property may be overridden for a +given configuration ``<CONFIG>`` by the configuration-specific +:prop_tgt:`IMPORTED_IMPLIB_<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_IMPLIB_<CONFIG>` value used. + This property is ignored for non-imported targets. |