mirror of
https://github.com/Kitware/CMake.git
synced 2026-08-12 22:17:06 +00:00
ef5e1e3a5b
While we're at it, use the new `:cmake-option:` role to shorten some references to `--log-level`.
22 lines
914 B
ReStructuredText
22 lines
914 B
ReStructuredText
CMAKE_MESSAGE_LOG_LEVEL
|
|
-----------------------
|
|
|
|
.. versionadded:: 3.17
|
|
|
|
When set, this variable specifies the logging level used by the
|
|
:command:`message` command. Valid values are the same as those for the
|
|
:cmake-option:`--log-level` command line option of the :manual:`cmake(1)`
|
|
program. If this variable is set and the :cmake-option:`--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.
|
|
|
|
.. versionadded:: 3.25
|
|
See the :command:`cmake_language(GET_MESSAGE_LOG_LEVEL)` command for a way to
|
|
query the current message logging level.
|