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
This commit is contained in:
Brad King
2023-03-03 14:10:37 +00:00
committed by Kitware Robot
2 changed files with 25 additions and 7 deletions
+16 -7
View File
@@ -1,11 +1,20 @@
IMPORTED_CONFIGURATIONS
-----------------------
Configurations provided for an IMPORTED target.
Configurations provided for an :ref:`imported target <Imported targets>`.
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.
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.
+9
View File
@@ -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.