You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
38 lines
1.2 KiB
38 lines
1.2 KiB
2 years ago
|
CMAKE_COLOR_DIAGNOSTICS
|
||
|
-----------------------
|
||
|
|
||
|
.. versionadded:: 3.24
|
||
|
|
||
|
Enable color diagnostics throughout.
|
||
|
|
||
|
This variable uses three states: ``ON``, ``OFF`` and not defined.
|
||
|
|
||
|
When not defined:
|
||
|
|
||
|
* :ref:`Makefile Generators` initialize the :variable:`CMAKE_COLOR_MAKEFILE`
|
||
|
variable to ``ON``. It controls color buildsystem messages.
|
||
|
|
||
|
* GNU/Clang compilers are not invoked with any color diagnostics flag.
|
||
|
|
||
|
When ``ON``:
|
||
|
|
||
|
* :ref:`Makefile Generators` produce color buildsystem messages by default.
|
||
|
:variable:`CMAKE_COLOR_MAKEFILE` is not initialized, but may be
|
||
|
explicitly set to ``OFF`` to disable color buildsystem messages.
|
||
|
|
||
|
* GNU/Clang compilers are invoked with a flag enabling color diagnostics
|
||
|
(``-fcolor-diagnostics``).
|
||
|
|
||
|
When ``OFF``:
|
||
|
|
||
|
* :ref:`Makefile Generators` do not produce color buildsystem messages by
|
||
|
default. :variable:`CMAKE_COLOR_MAKEFILE` is not initialized, but may be
|
||
|
explicitly set to ``ON`` to enable color buildsystem messages.
|
||
|
|
||
|
* GNU/Clang compilers are invoked with a flag disabling color diagnostics
|
||
|
(``-fno-color-diagnostics``).
|
||
|
|
||
|
If the :envvar:`CMAKE_COLOR_DIAGNOSTICS` environment variable is set, its
|
||
|
value is used. Otherwise, ``CMAKE_COLOR_DIAGNOSTICS`` is not defined by
|
||
|
default.
|