2013-10-15 19:17:36 +04:00
|
|
|
utility_source
|
|
|
|
--------------
|
|
|
|
|
2013-10-21 19:50:47 +04:00
|
|
|
Disallowed. See CMake Policy :policy:`CMP0034`.
|
|
|
|
|
2013-10-15 19:17:36 +04:00
|
|
|
Specify the source tree of a third-party utility.
|
|
|
|
|
|
|
|
::
|
|
|
|
|
|
|
|
utility_source(cache_entry executable_name
|
|
|
|
path_to_source [file1 file2 ...])
|
|
|
|
|
|
|
|
When a third-party utility's source is included in the distribution,
|
|
|
|
this command specifies its location and name. The cache entry will
|
2015-06-05 00:51:22 +03:00
|
|
|
not be set unless the ``path_to_source`` and all listed files exist. It
|
2013-10-15 19:17:36 +04:00
|
|
|
is assumed that the source tree of the utility will have been built
|
|
|
|
before it is needed.
|
|
|
|
|
2015-06-05 00:51:22 +03:00
|
|
|
When cross compiling CMake will print a warning if a ``utility_source()``
|
2013-10-15 19:17:36 +04:00
|
|
|
command is executed, because in many cases it is used to build an
|
|
|
|
executable which is executed later on. This doesn't work when cross
|
|
|
|
compiling, since the executable can run only on their target platform.
|
|
|
|
So in this case the cache entry has to be adjusted manually so it
|
|
|
|
points to an executable which is runnable on the build host.
|