1LOCATION
2--------
3
4Read-only location of a target on disk.
5
6For an imported target, this read-only property returns the value of
7the ``LOCATION_<CONFIG>`` property for an unspecified configuration
8``<CONFIG>`` provided by the target.
9
10For a non-imported target, this property is provided for compatibility
11with CMake 2.4 and below.  It was meant to get the location of an
12executable target's output file for use in :command:`add_custom_command`.  The
13path may contain a build-system-specific portion that is replaced at
14build time with the configuration getting built (such as
15``$(ConfigurationName)`` in VS).  In CMake 2.6 and above
16:command:`add_custom_command` automatically recognizes a target name in its
17``COMMAND`` and ``DEPENDS`` options and computes the target location.  In
18CMake 2.8.4 and above :command:`add_custom_command` recognizes
19:manual:`generator expressions <cmake-generator-expressions(7)>`
20to refer to target locations anywhere in the command.
21Therefore this property is not needed for creating custom commands.
22
23Do not set properties that affect the location of a target after
24reading this property.  These include properties whose names match
25``(RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?``,
26``(IMPLIB_)?(PREFIX|SUFFIX)``, or "LINKER_LANGUAGE".  Failure to follow
27this rule is not diagnosed and leaves the location of the target
28undefined.
29