Procházet zdrojové kódy

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 <[email protected]>
Merge-request: !8281
Brad King před 2 roky
rodič
revize
10f318326f

+ 17 - 8
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.

+ 9 - 0
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.