summaryrefslogtreecommitdiff
path: root/share/cmake-3.17/Help/variable/CMAKE_MESSAGE_CONTEXT_SHOW.rst
blob: 7ec218e04e6ef6248b313a1f9308fc9f994766dd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
CMAKE_MESSAGE_CONTEXT_SHOW
--------------------------

Setting this variable to true enables showing a context with each line
logged by the :command:`message` command (see :variable:`CMAKE_MESSAGE_CONTEXT`
for how the context itself is specified).

This variable is an alternative to providing the ``--log-context`` option
on the :manual:`cmake <cmake(1)>` command line.  Whereas the command line
option will apply only to that one CMake run, setting
``CMAKE_MESSAGE_CONTEXT_SHOW`` to true as a cache variable will ensure that
subsequent CMake runs will continue to show the message context.

Projects should not set ``CMAKE_MESSAGE_CONTEXT_SHOW``.  It is intended for
users so that they may control whether or not to include context with messages.