diff options
| author | Brad King <brad.king@kitware.com> | 2022-10-18 17:18:12 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2022-10-18 18:10:41 (GMT) |
| commit | e0075799ed97951c62f749eae671cefb62b2e694 (patch) | |
| tree | 9318b6e6ae68f4c05ace515f31e6838744d1e471 /Help/envvar/LANG_FLAGS.txt | |
| parent | 787fc8caa8c46b7c29e05c9b367f8e85665845d4 (diff) | |
| download | CMake-e0075799ed97951c62f749eae671cefb62b2e694.zip CMake-e0075799ed97951c62f749eae671cefb62b2e694.tar.gz CMake-e0075799ed97951c62f749eae671cefb62b2e694.tar.bz2 | |
Help: Clarify how language-specific flag environment values are used
Previous the wording could be interpreted to mean that the environment
variables like `CXXFLAGS` are used exclusively to initialize the
corresponding cache entries like `CMAKE_CXX_FLAGS`. State clearly
that the value will be used in combination with builtin defaults.
Issue: #23956
Diffstat (limited to 'Help/envvar/LANG_FLAGS.txt')
| -rw-r--r-- | Help/envvar/LANG_FLAGS.txt | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/Help/envvar/LANG_FLAGS.txt b/Help/envvar/LANG_FLAGS.txt new file mode 100644 index 0000000..d01a56d --- /dev/null +++ b/Help/envvar/LANG_FLAGS.txt @@ -0,0 +1,6 @@ +CMake uses this environment variable value, in combination with its own +builtin default flags for the toolchain, to initialize and store the +|CMAKE_LANG_FLAGS| cache entry. +This occurs the first time a build tree is configured for language |LANG|. +For any configuration run (including the first), the environment variable +will be ignored if the |CMAKE_LANG_FLAGS| variable is already defined. |