From 25641fe8d5e4a74e56fea3a5b8dce26f564f908b Mon Sep 17 00:00:00 2001 From: Tyler Yankee Date: Thu, 29 Jan 2026 11:17:07 -0500 Subject: [PATCH] Help/presets: Document behavior for native build tool parallelism This is already technically supported by the implementation, but it's not immediately intuitive to users. Relates: #27070 --- Help/manual/cmake-presets.7.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Help/manual/cmake-presets.7.rst b/Help/manual/cmake-presets.7.rst index 70b9245139..8459469d88 100644 --- a/Help/manual/cmake-presets.7.rst +++ b/Help/manual/cmake-presets.7.rst @@ -493,6 +493,8 @@ that may contain the following fields: ``description`` An optional string with a human-friendly description of the preset. +.. _`CMakePresets build environment`: + ``environment`` An optional map of environment variables. The key is the variable name (which may not be an empty string), and the value is either ``null`` or @@ -544,6 +546,10 @@ that may contain the following fields: ``jobs`` An optional integer. Equivalent to passing :option:`--parallel ` or ``-j`` on the command line. + If the value is ``0``, it is equivalent to passing ``--parallel`` with + ```` omitted; alternatively, one can define the environment variable + :envvar:`CMAKE_BUILD_PARALLEL_LEVEL` as an empty string using the + ``environment`` field. ``targets`` An optional string or array of strings. Equivalent to passing