Merge topic 'preset-4.3-relnotes'

39ba62fcd5 Help: Update presets release notes for 4.3

Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !11721
This commit is contained in:
Brad King
2026-02-24 11:59:58 -05:00
committed by Kitware Robot
2 changed files with 20 additions and 11 deletions
+11 -11
View File
@@ -553,8 +553,10 @@ that may contain the following fields:
:envvar:`CMAKE_BUILD_PARALLEL_LEVEL` as an empty string using the
``environment`` field.
In preset files specifying version ``11`` or above, this field does not
accept negative values.
.. versionchanged:: 4.3
This field does not accept negative integer values, regardless of the
version in the preset file.
``targets``
An optional string or array of strings. Equivalent to passing
@@ -904,8 +906,12 @@ that may contain the following fields:
In preset files specifying version ``11`` or above, this field can also be
a string, in which case it must be empty, and is equivalent to passing
``--parallel`` with ``<jobs>`` omitted; additionally, it does not accept
negative values.
``--parallel`` with ``<jobs>`` omitted.
.. versionchanged:: 4.3
This field does not accept negative integer values, regardless of the
version in the preset file.
``resourceSpecFile``
An optional string. Equivalent to passing
@@ -1460,17 +1466,11 @@ they were added and a summary of the new features and changes is given below.
``11``
.. versionadded:: 4.3
* Changes to `Build Presets <Build Preset_>`_
* The `jobs <CMakePresets build jobs_>`_ field no longer accepts negative
values.
* Changes to `Test Presets <Test Preset_>`_
* The `jobs <CMakePresets test jobs_>`_ field now accepts an empty string
representing :option:`--parallel <ctest --parallel>` with ``<jobs>``
omitted. In addition, when an integer is specified, it must not be
negative.
omitted.
Schema
======
+9
View File
@@ -48,6 +48,15 @@ Instrumentation
:ref:`Google Trace Event Format <cmake-instrumentation Google Trace File>`
files may be generated to visualize instrumentation data.
Presets
-------
* :manual:`cmake-presets(7)` files now support schema version ``11``.
The ``jobs`` field under test presets now supports an empty string, to
match the behavior of :option:`ctest --parallel` with the value omitted.
* The ``jobs`` field under both build and test presets no longer accept
negative integer values, regardless of the schema version.
File-Based API
--------------