28 lines
1.3 KiB
ReStructuredText
28 lines
1.3 KiB
ReStructuredText
LOCATION
|
|
--------
|
|
|
|
Read-only location of a target on disk.
|
|
|
|
For an imported target, this read-only property returns the value of
|
|
the LOCATION_<CONFIG> property for an unspecified configuration
|
|
<CONFIG> provided by the target.
|
|
|
|
For a non-imported target, this property is provided for compatibility
|
|
with CMake 2.4 and below. It was meant to get the location of an
|
|
executable target's output file for use in add_custom_command. The
|
|
path may contain a build-system-specific portion that is replaced at
|
|
build time with the configuration getting built (such as
|
|
"$(ConfigurationName)" in VS). In CMake 2.6 and above
|
|
add_custom_command automatically recognizes a target name in its
|
|
COMMAND and DEPENDS options and computes the target location. In
|
|
CMake 2.8.4 and above add_custom_command recognizes generator
|
|
expressions to refer to target locations anywhere in the command.
|
|
Therefore this property is not needed for creating custom commands.
|
|
|
|
Do not set properties that affect the location of a target after
|
|
reading this property. These include properties whose names match
|
|
"(RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?",
|
|
"(IMPLIB_)?(PREFIX|SUFFIX)", or "LINKER_LANGUAGE". Failure to follow
|
|
this rule is not diagnosed and leaves the location of the target
|
|
undefined.
|