Help: Describe IMPORTED_{LOCATION,IMPLIB}_<CONFIG> in more detail

Also link to `IMPORTED_CONFIGURATIONS` and `MAP_IMPORTED_CONFIG_<CONFIG>`.

Closes: #28076
This commit is contained in:
Brad King
2026-09-09 14:20:22 -04:00
parent 20c30149e0
commit 3b34605661
4 changed files with 26 additions and 8 deletions
+2 -1
View File
@@ -1,7 +1,8 @@
IMPORTED_IMPLIB
---------------
Full path to the import library for an ``IMPORTED`` target.
Full path to the import library for an
:ref:`IMPORTED <Imported Targets>` target.
This property may be set:
+11 -3
View File
@@ -1,7 +1,15 @@
IMPORTED_IMPLIB_<CONFIG>
------------------------
<CONFIG>-specific version of :prop_tgt:`IMPORTED_IMPLIB` property.
Full path to the ``<CONFIG>``-specific import library for an
:ref:`IMPORTED <Imported Targets>` target. This is the
``<CONFIG>``-specific version of the :prop_tgt:`IMPORTED_IMPLIB`
property.
Configuration names correspond to those provided by the project from
which the target is imported.
The ``<CONFIG>`` name corresponds to that provided by the project from
which the target is imported. 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.
Each ``<CONFIG>`` for which this property is set should also be
listed in the :prop_tgt:`IMPORTED_CONFIGURATIONS` target property.
+2 -1
View File
@@ -1,7 +1,8 @@
IMPORTED_LOCATION
-----------------
Full path to the main file on disk for an ``IMPORTED`` target.
Full path to the main file on disk for an
:ref:`IMPORTED <Imported Targets>` target.
Set this to the location of an ``IMPORTED`` target file on disk. For
executables this is the location of the executable file. For ``STATIC``
+11 -3
View File
@@ -1,7 +1,15 @@
IMPORTED_LOCATION_<CONFIG>
--------------------------
<CONFIG>-specific version of :prop_tgt:`IMPORTED_LOCATION` property.
Full path to the ``<CONFIG>``-specific main file on disk for an
:ref:`IMPORTED <Imported Targets>` target. This is the
``<CONFIG>``-specific version of the :prop_tgt:`IMPORTED_LOCATION`
property.
Configuration names correspond to those provided by the project from
which the target is imported.
The ``<CONFIG>`` name corresponds to that provided by the project from
which the target is imported. 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.
Each ``<CONFIG>`` for which this property is set should also be
listed in the :prop_tgt:`IMPORTED_CONFIGURATIONS` target property.