summaryrefslogtreecommitdiffstats
path: root/Help/envvar
diff options
context:
space:
mode:
authorBobby D Reynolds <boreynol@microsoft.com>2021-05-18 15:57:02 (GMT)
committerBrad King <brad.king@kitware.com>2021-05-28 16:28:43 (GMT)
commitae108418ae45aff7740605bb7add3843b050d226 (patch)
tree1b46b02e2c567538b0437fed2aef91564cd8f577 /Help/envvar
parent92c8b83641eae61700d16602e0b60d9c9c6f3b15 (diff)
downloadCMake-ae108418ae45aff7740605bb7add3843b050d226.zip
CMake-ae108418ae45aff7740605bb7add3843b050d226.tar.gz
CMake-ae108418ae45aff7740605bb7add3843b050d226.tar.bz2
Launchers: Support setting linker launchers
Fixes: #18316
Diffstat (limited to 'Help/envvar')
-rw-r--r--Help/envvar/CMAKE_LANG_LINKER_LAUNCHER.rst13
1 files changed, 13 insertions, 0 deletions
diff --git a/Help/envvar/CMAKE_LANG_LINKER_LAUNCHER.rst b/Help/envvar/CMAKE_LANG_LINKER_LAUNCHER.rst
new file mode 100644
index 0000000..6251d9c
--- /dev/null
+++ b/Help/envvar/CMAKE_LANG_LINKER_LAUNCHER.rst
@@ -0,0 +1,13 @@
+CMAKE_<LANG>_LINKER_LAUNCHER
+----------------------------
+
+.. versionadded:: 3.21
+
+.. include:: ENV_VAR.txt
+
+Default launcher to use when linking a target of the specified language. Will
+only be used by CMake to initialize the variable on the first configuration.
+Afterwards, it is available through the cache setting of the variable of the
+same name. For any configuration run (including the first), the environment
+variable will be ignored if the :variable:`CMAKE_<LANG>_LINKER_LAUNCHER`
+variable is defined.