3b45d1ddfdee49be15d1723bb962f3dd3e190399
[platform/upstream/cmake.git] / Help / variable / CMAKE_MESSAGE_LOG_LEVEL.rst
1 CMAKE_MESSAGE_LOG_LEVEL
2 -----------------------
3
4 .. versionadded:: 3.17
5
6 When set, this variable specifies the logging level used by the
7 :command:`message` command.  Valid values are the same as those for the
8 ``--log-level`` command line option of the :manual:`cmake(1)` program.
9 If this variable is set and the ``--log-level`` command line option is
10 given, the command line option takes precedence.
11
12 The main advantage to using this variable is to make a log level persist
13 between CMake runs.  Setting it as a cache variable will ensure that
14 subsequent CMake runs will continue to use the chosen log level.
15
16 Projects should not set this variable, it is intended for users so that
17 they may control the log level according to their own needs.