summaryrefslogtreecommitdiffstats
path: root/Help/variable/CMAKE_MESSAGE_LOG_LEVEL.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Help/variable/CMAKE_MESSAGE_LOG_LEVEL.rst')
-rw-r--r--Help/variable/CMAKE_MESSAGE_LOG_LEVEL.rst15
1 files changed, 15 insertions, 0 deletions
diff --git a/Help/variable/CMAKE_MESSAGE_LOG_LEVEL.rst b/Help/variable/CMAKE_MESSAGE_LOG_LEVEL.rst
new file mode 100644
index 0000000..1d4cfe6
--- /dev/null
+++ b/Help/variable/CMAKE_MESSAGE_LOG_LEVEL.rst
@@ -0,0 +1,15 @@
+CMAKE_MESSAGE_LOG_LEVEL
+-----------------------
+
+When set, this variable specifies the logging level used by the
+:command:`message` command. Valid values are the same as those for the
+``--log-level`` command line option of the :manual:`cmake(1)` program.
+If this variable is set and the ``--log-level`` command line option is
+given, the command line option takes precedence.
+
+The main advantage to using this variable is to make a log level persist
+between CMake runs. Setting it as a cache variable will ensure that
+subsequent CMake runs will continue to use the chosen log level.
+
+Projects should not set this variable, it is intended for users so that
+they may control the log level according to their own needs.