Help: Update presets release notes for 4.3

See commit 23615b7ca4 (presets: Allow jobs to match `ctest -j` with no
value, 2025-12-15) and commit 71ff5a9d6f (presets: Disallow negative
values for "jobs" fields, 2026-01-13) for the changes.

Also update `cmake-presets(7)` itself to correct the behavior change
from the prior commit not respecting the presets file version.
This commit is contained in:
Tyler Yankee
2026-02-22 16:48:51 -05:00
parent 401ba7d8ca
commit 39ba62fcd5
2 changed files with 20 additions and 11 deletions

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
======

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
--------------