summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2021-03-17 13:23:58 (GMT)
committerKitware Robot <kwrobot@kitware.com>2021-03-17 13:24:04 (GMT)
commit649976e9a656e4c98bd235f7232b2f46d78da31a (patch)
treebdfa650f5ccff29d47615455c7f10b9974115178 /Help
parent7a9fb6a9c9764f8400f72aee0d26d27bad2c36d1 (diff)
parent95c50da8af070999f5302ed19d807b59451d8c85 (diff)
downloadCMake-649976e9a656e4c98bd235f7232b2f46d78da31a.zip
CMake-649976e9a656e4c98bd235f7232b2f46d78da31a.tar.gz
CMake-649976e9a656e4c98bd235f7232b2f46d78da31a.tar.bz2
Merge topic 'doc-flag-var-strings'
95c50da8af Help: Document that CMAKE_<LANG>_FLAGS[_INIT] are strings Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !5915
Diffstat (limited to 'Help')
-rw-r--r--Help/variable/CMAKE_LANG_FLAGS.rst3
-rw-r--r--Help/variable/CMAKE_LANG_FLAGS_INIT.rst2
2 files changed, 5 insertions, 0 deletions
diff --git a/Help/variable/CMAKE_LANG_FLAGS.rst b/Help/variable/CMAKE_LANG_FLAGS.rst
index 14b2694..11864f8 100644
--- a/Help/variable/CMAKE_LANG_FLAGS.rst
+++ b/Help/variable/CMAKE_LANG_FLAGS.rst
@@ -15,3 +15,6 @@ This is initialized for each language from environment variables:
Initialized by the :envvar:`CUDAFLAGS` environment variable.
* ``CMAKE_Fortran_FLAGS``:
Initialized by the :envvar:`FFLAGS` environment variable.
+
+This value is a command-line string fragment. Therefore, multiple options
+should be separated by spaces, and options with spaces should be quoted.
diff --git a/Help/variable/CMAKE_LANG_FLAGS_INIT.rst b/Help/variable/CMAKE_LANG_FLAGS_INIT.rst
index 67ff2cb..ca13a29 100644
--- a/Help/variable/CMAKE_LANG_FLAGS_INIT.rst
+++ b/Help/variable/CMAKE_LANG_FLAGS_INIT.rst
@@ -12,6 +12,8 @@ the contents of a ``xxxFLAGS`` environment variable will be prepended,
where ``xxx`` will be language-specific but not necessarily the same as
``<LANG>`` (e.g. :envvar:`CXXFLAGS` for ``CXX``, :envvar:`FFLAGS` for
``Fortran``, and so on).
+This value is a command-line string fragment. Therefore, multiple options
+should be separated by spaces, and options with spaces should be quoted.
See also the configuration-specific
:variable:`CMAKE_<LANG>_FLAGS_<CONFIG>_INIT` variable.