.. This file was generated by Utilities/Scripts/regenerate-presets.py
   from Help/manual/presets/schema.yaml. Do not edit.

.. _`CMakePresets.configurePresets.trace.mode`:

``mode``
  An optional string that specifies the trace mode.
  Valid values are:

  ``on``
    Causes a trace of all calls made and from where to be
    printed. Equivalent to passing :cmake-option:`--trace`
    on the command line.

  ``off``
    A trace of all calls will not be printed.

  ``expand``
    Causes a trace with variables expanded of all calls made
    and from where to be printed. Equivalent to passing
    :cmake-option:`--trace-expand` on the command line.

.. _`CMakePresets.configurePresets.trace.format`:

``format``
  An optional string that specifies the format output of the
  trace. Valid values are:

  ``human``
    Prints each trace line in a human-readable format.
    This is the default format. Equivalent to passing
    :cmake-option:`--trace-format=human`
    on the command line.

  ``json-v1``
    Prints each line as a separate JSON document. Equivalent
    to passing :cmake-option:`--trace-format=json-v1`
    on the command line.

.. _`CMakePresets.configurePresets.trace.source`:

``source``
  An optional array of strings representing the paths of source
  files to be traced. This field can also be a string, which is
  equivalent to an array containing one string. Equivalent to
  passing :cmake-option:`--trace-source` on the command line.

.. _`CMakePresets.configurePresets.trace.redirect`:

``redirect``
  An optional string specifying a path to a trace output file.
  Equivalent to passing :cmake-option:`--trace-redirect` on the
  command line.
