summaryrefslogtreecommitdiffstats
path: root/Help/variable/CMAKE_EXE_LINKER_FLAGS_INIT.rst
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2016-07-13 19:06:23 (GMT)
committerBrad King <brad.king@kitware.com>2016-07-14 19:47:32 (GMT)
commit8a98cf643235a4d2869e1c876f8769b3e6bcd86f (patch)
tree7c324e9cb4cf3842163a544bd679b4e167dc4c83 /Help/variable/CMAKE_EXE_LINKER_FLAGS_INIT.rst
parent37d15c399e33f3140c1ab0259984c54084dc34f8 (diff)
downloadCMake-8a98cf643235a4d2869e1c876f8769b3e6bcd86f.zip
CMake-8a98cf643235a4d2869e1c876f8769b3e6bcd86f.tar.gz
CMake-8a98cf643235a4d2869e1c876f8769b3e6bcd86f.tar.bz2
Honor CMAKE_*_LINKER_FLAGS[_<CONFIG>]_INIT set in toolchain files
Document these variables. Change our convention for setting these variables from: set(CMAKE_EXE_LINKER_FLAGS_INIT "...") to string(APPEND CMAKE_EXE_LINKER_FLAGS_INIT " ...") so that any value previously set by a toolchain file will be used.
Diffstat (limited to 'Help/variable/CMAKE_EXE_LINKER_FLAGS_INIT.rst')
-rw-r--r--Help/variable/CMAKE_EXE_LINKER_FLAGS_INIT.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/Help/variable/CMAKE_EXE_LINKER_FLAGS_INIT.rst b/Help/variable/CMAKE_EXE_LINKER_FLAGS_INIT.rst
new file mode 100644
index 0000000..0b8afe4
--- /dev/null
+++ b/Help/variable/CMAKE_EXE_LINKER_FLAGS_INIT.rst
@@ -0,0 +1,11 @@
+CMAKE_EXE_LINKER_FLAGS_INIT
+---------------------------
+
+Value used to initialize the :variable:`CMAKE_EXE_LINKER_FLAGS`
+cache entry the first time a build tree is configured.
+This variable is meant to be set by a :variable:`toolchain file
+<CMAKE_TOOLCHAIN_FILE>`. CMake may prepend or append content to
+the value based on the environment and target platform.
+
+See also the configuration-specific variable
+:variable:`CMAKE_EXE_LINKER_FLAGS_<CONFIG>_INIT`.