diff options
| author | Brad King <brad.king@kitware.com> | 2023-12-15 14:34:09 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2023-12-15 14:34:20 (GMT) |
| commit | 6ba3bb0563ca72fa6fa7bc705bdf38187e3fa485 (patch) | |
| tree | b44461db107bee8b705602e2316721113d1451cc /Help/command | |
| parent | 6a67f71b57cef80f51bd225049198e80f325846b (diff) | |
| parent | 88863d83d62b7668047ee78a3ada841364e119a0 (diff) | |
| download | CMake-6ba3bb0563ca72fa6fa7bc705bdf38187e3fa485.zip CMake-6ba3bb0563ca72fa6fa7bc705bdf38187e3fa485.tar.gz CMake-6ba3bb0563ca72fa6fa7bc705bdf38187e3fa485.tar.bz2 | |
Merge topic 'cmake-test-launcher'
88863d83d6 fileapi: Add test launcher to codemodel-v2
1ec0372ed4 add_test: Optionally use a launcher for tests running in-project targets
478a5f4e04 fileapi: Make launcher attribute 'arguments' optional
b44e38a397 cmFileAPICodemodel: Add missing std::move()
Acked-by: Kitware Robot <kwrobot@kitware.com>
Tested-by: buildbot <buildbot@kitware.com>
Merge-request: !8963
Diffstat (limited to 'Help/command')
| -rw-r--r-- | Help/command/add_test.rst | 28 |
1 files changed, 25 insertions, 3 deletions
diff --git a/Help/command/add_test.rst b/Help/command/add_test.rst index 02dd3986..37b9563 100644 --- a/Help/command/add_test.rst +++ b/Help/command/add_test.rst @@ -27,9 +27,31 @@ directory the test is created in. ``add_test`` options are: ``COMMAND`` - Specify the test command-line. If ``<command>`` specifies an executable - target created by :command:`add_executable`, it will automatically be - replaced by the location of the executable created at build time. + Specify the test command-line. + + If ``<command>`` specifies an executable target created by + :command:`add_executable`: + + * It will automatically be replaced by the location of the executable + created at build time. + + * .. versionadded:: 3.3 + + The target's :prop_tgt:`CROSSCOMPILING_EMULATOR`, if set, will be + used to run the command on the host:: + + <emulator> <command> + + * .. versionadded:: 3.29 + + The target's :prop_tgt:`TEST_LAUNCHER`, if set, will be + used to launch the command:: + + <launcher> <command> + + If the :prop_tgt:`CROSSCOMPILING_EMULATOR` is also set, both are used:: + + <launcher> <emulator> <command> The command may be specified using :manual:`generator expressions <cmake-generator-expressions(7)>`. |