summaryrefslogtreecommitdiffstats
path: root/Help/command
diff options
context:
space:
mode:
authorMatt McCormick <matt.mccormick@kitware.com>2015-01-02 03:30:08 (GMT)
committerBrad King <brad.king@kitware.com>2015-01-26 15:05:26 (GMT)
commite2b1f0583f7293bce280dfab397e96acf8a5b26e (patch)
treed3bbabefbf6fb944f4f2ada8fd3a0765a7964879 /Help/command
parent07cbe3640e3afc879a07b6510de4c6e437f43f3e (diff)
downloadCMake-e2b1f0583f7293bce280dfab397e96acf8a5b26e.zip
CMake-e2b1f0583f7293bce280dfab397e96acf8a5b26e.tar.gz
CMake-e2b1f0583f7293bce280dfab397e96acf8a5b26e.tar.bz2
try_run: Add support for LINK_LIBRARIES option.
Most functionality is already implemented in Source/cmCoreTryCompile.{h,cxx}. Document and improve argument parsing. This functionality is already being used by a number of modules, like CheckCSourceCompiles.cmake, but it is not documented.
Diffstat (limited to 'Help/command')
-rw-r--r--Help/command/try_run.rst9
1 files changed, 8 insertions, 1 deletions
diff --git a/Help/command/try_run.rst b/Help/command/try_run.rst
index 9a17ad9..b8ea0fe 100644
--- a/Help/command/try_run.rst
+++ b/Help/command/try_run.rst
@@ -6,8 +6,9 @@ Try compiling and then running some code.
::
try_run(RUN_RESULT_VAR COMPILE_RESULT_VAR
- bindir srcfile [CMAKE_FLAGS <Flags>]
+ bindir srcfile [CMAKE_FLAGS <flags>]
[COMPILE_DEFINITIONS <flags>]
+ [LINK_LIBRARIES <libs>]
[COMPILE_OUTPUT_VARIABLE comp]
[RUN_OUTPUT_VARIABLE run]
[OUTPUT_VARIABLE var]
@@ -22,6 +23,12 @@ where the output from the compile step goes. RUN_OUTPUT_VARIABLE
specifies the variable where the output from the running executable
goes.
+The srcfile signature also accepts a LINK_LIBRARIES argument which may
+contain a list of libraries or IMPORTED targets which will be linked
+to in the generated project. If LINK_LIBRARIES is specified as a
+parameter to try_run, then any LINK_LIBRARIES passed as
+CMAKE_FLAGS will be ignored.
+
For compatibility reasons OUTPUT_VARIABLE is still supported, which
gives you the output from the compile and run step combined.