From 00c0c27303007ce1485d864378683fa7f69628a9 Mon Sep 17 00:00:00 2001 From: Craig Scott Date: Sat, 23 May 2020 15:19:46 +1000 Subject: Help: Clarify how env vars and ..._INIT variables interact Fixes: #20358 --- Help/envvar/ASM_DIALECTFLAGS.rst | 2 ++ Help/envvar/CFLAGS.rst | 2 ++ Help/envvar/CSFLAGS.rst | 2 ++ Help/envvar/CUDAFLAGS.rst | 2 ++ Help/envvar/CXXFLAGS.rst | 2 ++ Help/envvar/FFLAGS.rst | 2 ++ Help/envvar/RCFLAGS.rst | 2 ++ Help/variable/CMAKE_LANG_FLAGS_INIT.rst | 6 +++++- 8 files changed, 19 insertions(+), 1 deletion(-) diff --git a/Help/envvar/ASM_DIALECTFLAGS.rst b/Help/envvar/ASM_DIALECTFLAGS.rst index 3c3b02a..2e1c6d2 100644 --- a/Help/envvar/ASM_DIALECTFLAGS.rst +++ b/Help/envvar/ASM_DIALECTFLAGS.rst @@ -11,3 +11,5 @@ flags, after which the value for ``ASMFLAGS`` is stored in the cache as ``CMAKE_ASM_FLAGS _FLAGS>``. For any configuration run (including the first), the environment variable will be ignored, if the ``CMAKE_ASM_FLAGS _FLAGS>`` variable is defined. + +See also :variable:`CMAKE_ASM_FLAGS_INIT _FLAGS_INIT>`. diff --git a/Help/envvar/CFLAGS.rst b/Help/envvar/CFLAGS.rst index fda9ccc..190b4f4 100644 --- a/Help/envvar/CFLAGS.rst +++ b/Help/envvar/CFLAGS.rst @@ -9,3 +9,5 @@ flags, after which the value for ``CFLAGS`` is stored in the cache as :variable:`CMAKE_C_FLAGS _FLAGS>`. For any configuration run (including the first), the environment variable will be ignored if the :variable:`CMAKE_C_FLAGS _FLAGS>` variable is defined. + +See also :variable:`CMAKE_C_FLAGS_INIT _FLAGS_INIT>`. diff --git a/Help/envvar/CSFLAGS.rst b/Help/envvar/CSFLAGS.rst index 404bb59..8762982 100644 --- a/Help/envvar/CSFLAGS.rst +++ b/Help/envvar/CSFLAGS.rst @@ -9,3 +9,5 @@ compilation flags, after which the value for ``CSFLAGS`` is stored in the cache as :variable:`CMAKE_CSharp_FLAGS _FLAGS>`. For any configuration run (including the first), the environment variable will be ignored if the :variable:`CMAKE_CSharp_FLAGS _FLAGS>` variable is defined. + +See also :variable:`CMAKE_CSharp_FLAGS_INIT _FLAGS_INIT>`. diff --git a/Help/envvar/CUDAFLAGS.rst b/Help/envvar/CUDAFLAGS.rst index 4456d6b..14c5d84 100644 --- a/Help/envvar/CUDAFLAGS.rst +++ b/Help/envvar/CUDAFLAGS.rst @@ -9,3 +9,5 @@ compilation flags, after which the value for ``CUDAFLAGS`` is stored in the cache as :variable:`CMAKE_CUDA_FLAGS _FLAGS>`. For any configuration run (including the first), the environment variable will be ignored if the :variable:`CMAKE_CUDA_FLAGS _FLAGS>` variable is defined. + +See also :variable:`CMAKE_CUDA_FLAGS_INIT _FLAGS_INIT>`. diff --git a/Help/envvar/CXXFLAGS.rst b/Help/envvar/CXXFLAGS.rst index d7296dc..460a347 100644 --- a/Help/envvar/CXXFLAGS.rst +++ b/Help/envvar/CXXFLAGS.rst @@ -9,3 +9,5 @@ compilation flags, after which the value for ``CXXFLAGS`` is stored in the cache as :variable:`CMAKE_CXX_FLAGS _FLAGS>`. For any configuration run ( including the first), the environment variable will be ignored if the :variable:`CMAKE_CXX_FLAGS _FLAGS>` variable is defined. + +See also :variable:`CMAKE_CXX_FLAGS_INIT _FLAGS_INIT>`. diff --git a/Help/envvar/FFLAGS.rst b/Help/envvar/FFLAGS.rst index 02d3c34..53bffb6 100644 --- a/Help/envvar/FFLAGS.rst +++ b/Help/envvar/FFLAGS.rst @@ -9,3 +9,5 @@ compilation flags, after which the value for ``FFLAGS`` is stored in the cache as :variable:`CMAKE_Fortran_FLAGS _FLAGS>`. For any configuration run (including the first), the environment variable will be ignored if the :variable:`CMAKE_Fortran_FLAGS _FLAGS>` variable is defined. + +See also :variable:`CMAKE_Fortran_FLAGS_INIT _FLAGS_INIT>`. diff --git a/Help/envvar/RCFLAGS.rst b/Help/envvar/RCFLAGS.rst index 45419fe..bc43cb2 100644 --- a/Help/envvar/RCFLAGS.rst +++ b/Help/envvar/RCFLAGS.rst @@ -9,3 +9,5 @@ default compilation flags, after which the value for ``RCFLAGS`` is stored in the cache as :variable:`CMAKE_RC_FLAGS _FLAGS>`. For any configuration run (including the first), the environment variable will be ignored if the :variable:`CMAKE_RC_FLAGS _FLAGS>` variable is defined. + +See also :variable:`CMAKE_RC_FLAGS_INIT _FLAGS_INIT>`. diff --git a/Help/variable/CMAKE_LANG_FLAGS_INIT.rst b/Help/variable/CMAKE_LANG_FLAGS_INIT.rst index a88d122..4a034e8 100644 --- a/Help/variable/CMAKE_LANG_FLAGS_INIT.rst +++ b/Help/variable/CMAKE_LANG_FLAGS_INIT.rst @@ -5,7 +5,11 @@ Value used to initialize the :variable:`CMAKE__FLAGS` cache entry the first time a build tree is configured for language ````. This variable is meant to be set by a :variable:`toolchain file `. CMake may prepend or append content to -the value based on the environment and target platform. +the value based on the environment and target platform. For example, +the contents of a ``xxxFLAGS`` environment variable will be prepended, +where ``xxx`` will be language-specific but not necessarily the same as +```` (e.g. :envvar:`CXXFLAGS` for ``CXX``, :envvar:`FFLAGS` for +``Fortran``, and so on). See also the configuration-specific :variable:`CMAKE__FLAGS__INIT` variable. -- cgit v0.12