Merge topic 'ctest_preset_args_cli'

63b6e7d785 ctest: allow dashboard clients to specify presets via variables

Acked-by: Kitware Robot <kwrobot@kitware.com>
Tested-by: buildbot <buildbot@kitware.com>
Merge-request: !12109
This commit is contained in:
Brad King
2026-05-28 13:50:25 +00:00
committed by Kitware Robot
31 changed files with 513 additions and 26 deletions

View File

@@ -86,13 +86,20 @@ The options are:
argument will override the :preset:`buildPresets.targets` setting from
the chosen preset.
See also the :variable:`CTEST_BUILD_PRESET` and
:variable:`CTEST_PRESET` variables.
``PRESETS_FILE <file>``
.. versionadded:: 4.4
Specify a :manual:`presets <cmake-presets(7)>` file to use instead of the
default ``CMakePresets.json`` in the source directory.
A relative path is interpreted relative to the source directory.
Has no effect unless ``PRESET`` is also specified.
Has no effect unless a preset is selected via the ``PRESET`` argument
or the :variable:`CTEST_BUILD_PRESET` or :variable:`CTEST_PRESET`
variables.
See also the :variable:`CTEST_PRESETS_FILE` variable.
``RETURN_VALUE <result-var>``
Store the return value of the native build tool in the given variable.

View File

@@ -49,13 +49,20 @@ The options are:
This option is ignored when :variable:`CTEST_CONFIGURE_COMMAND`
is used.
See also the :variable:`CTEST_CONFIGURE_PRESET` and
:variable:`CTEST_PRESET` variables.
``PRESETS_FILE <file>``
.. versionadded:: 4.4
Specify a :manual:`presets <cmake-presets(7)>` file to use instead of the
default ``CMakePresets.json`` in the source directory.
A relative path is interpreted relative to the source directory.
Has no effect unless ``PRESET`` is also specified.
Has no effect unless a preset is selected via the ``PRESET`` argument
or the :variable:`CTEST_CONFIGURE_PRESET` or :variable:`CTEST_PRESET`
variables.
See also the :variable:`CTEST_PRESETS_FILE` variable.
``RETURN_VALUE <result-var>``
Store in the ``<result-var>`` variable the return value of the native

View File

@@ -201,13 +201,22 @@ The options are:
the :preset:`filter.include.name <testPresets.filter.include.name>` setting
from the chosen preset.
This option also applies to the :command:`ctest_memcheck` command.
See also the :variable:`CTEST_TEST_PRESET` and
:variable:`CTEST_PRESET` variables.
``PRESETS_FILE <file>``
.. versionadded:: 4.4
Specify a :manual:`presets <cmake-presets(7)>` file to use instead of the
default ``CMakePresets.json`` in the source directory.
A relative path is interpreted relative to the source directory.
Has no effect unless ``PRESET`` is also specified.
Has no effect unless a preset is selected via the ``PRESET`` argument
or the :variable:`CTEST_TEST_PRESET` or :variable:`CTEST_PRESET`
variables.
This option also applies to the :command:`ctest_memcheck` command.
See also the :variable:`CTEST_PRESETS_FILE` variable.
``QUIET``
.. versionadded:: 3.3