Selaa lähdekoodia

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.
Tyler Yankee 1 kuukausi sitten
vanhempi
sitoutus
39ba62fcd5
2 muutettua tiedostoa jossa 20 lisäystä ja 11 poistoa
  1. 11 11
      Help/manual/cmake-presets.7.rst
  2. 9 0
      Help/release/4.3.rst

+ 11 - 11
Help/manual/cmake-presets.7.rst

@@ -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 - 0
Help/release/4.3.rst

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