8c29d7d16d258d59f66e1d87171ee03f0e909cd5
[platform/upstream/cmake.git] / Help / envvar / CTEST_PROGRESS_OUTPUT.rst
1 CTEST_PROGRESS_OUTPUT
2 ---------------------
3
4 .. versionadded:: 3.13
5
6 .. include:: ENV_VAR.txt
7
8 Boolean environment variable that affects how :manual:`ctest <ctest(1)>`
9 command output reports overall progress.  When set to ``1``, ``TRUE``, ``ON`` or anything
10 else that evaluates to boolean true, progress is reported by repeatedly
11 updating the same line.  This greatly reduces the overall verbosity, but is
12 only supported when output is sent directly to a terminal.  If the environment
13 variable is not set or has a value that evaluates to false, output is reported
14 normally with each test having its own start and end lines logged to the
15 output.
16
17 The ``--progress`` option to :manual:`ctest <ctest(1)>` overrides this
18 environment variable if both are given.