1
0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-15 20:46:37 +08:00

Help: Clarify the effect of EXCLUDE_FROM_ALL on target installation

This commit is contained in:
Arcturus
2020-06-01 21:25:43 +01:00
committed by Brad King
parent a09195e7bf
commit e262123fee

View File

@@ -13,9 +13,9 @@ included in the "all" target of its ancestor directories unless the
With ``EXCLUDE_FROM_ALL`` set to false or not set at all, the target
will be brought up to date as part of doing a ``make install`` or its
equivalent for the CMake generator being used. If a target has
``EXCLUDE_FROM_ALL`` set to true, then any attempt to install that
target has undefined behavior. Note that such a target can still safely
be listed in an :command:`install(TARGETS)` command as long as the install
components the target belongs to are not part of the set of components
that anything tries to install.
equivalent for the CMake generator being used.
If a target has ``EXCLUDE_FROM_ALL`` set to true, it may still be listed
in an :command:`install(TARGETS)` command, but the user is responsible for
ensuring that the target's build artifacts are not missing or outdated when
an install is performed.