summaryrefslogtreecommitdiffstats
path: root/Help/envvar/CMAKE_TEST_LAUNCHER.rst
diff options
context:
space:
mode:
authorRalf Habacker <ralf.habacker@freenet.de>2023-11-11 16:33:39 (GMT)
committerBrad King <brad.king@kitware.com>2023-12-13 15:20:43 (GMT)
commit1ec0372ed4b450e242fdb8f6a7d2862baa61b501 (patch)
tree2ae040a6f48ea682b62f72b56b593b72f3f286c5 /Help/envvar/CMAKE_TEST_LAUNCHER.rst
parent478a5f4e044d253971e71a41ad6fc6b8aa4e1c07 (diff)
downloadCMake-1ec0372ed4b450e242fdb8f6a7d2862baa61b501.zip
CMake-1ec0372ed4b450e242fdb8f6a7d2862baa61b501.tar.gz
CMake-1ec0372ed4b450e242fdb8f6a7d2862baa61b501.tar.bz2
add_test: Optionally use a launcher for tests running in-project targets
Add a `CMAKE_TEST_LAUNCHER` variable and corresponding `TEST_LAUNCHER` target property. Issue: #23672
Diffstat (limited to 'Help/envvar/CMAKE_TEST_LAUNCHER.rst')
-rw-r--r--Help/envvar/CMAKE_TEST_LAUNCHER.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/Help/envvar/CMAKE_TEST_LAUNCHER.rst b/Help/envvar/CMAKE_TEST_LAUNCHER.rst
new file mode 100644
index 0000000..d620ce5
--- /dev/null
+++ b/Help/envvar/CMAKE_TEST_LAUNCHER.rst
@@ -0,0 +1,11 @@
+CMAKE_TEST_LAUNCHER
+-------------------
+
+.. versionadded:: 3.29
+
+.. include:: ENV_VAR.txt
+
+The default value for the :variable:`CMAKE_TEST_LAUNCHER` variable when there
+is no explicit configuration given on the first run while creating a new
+build tree. On later runs in an existing build tree the value persists in
+the cache as :variable:`CMAKE_TEST_LAUNCHER`.