summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2022-10-25 14:37:11 (GMT)
committerKitware Robot <kwrobot@kitware.com>2022-10-25 14:37:23 (GMT)
commit979a9eb89f7961aa2f54fef3f0ac658a117dd025 (patch)
tree558390666918159846bd4b11133d19cc984ac8bb
parentae8561f690cbb787fe12272e8ebc0aa0872be1d8 (diff)
parent8a413eb8d0b9d62ce840621c1511a9ec8a57a2ff (diff)
downloadCMake-979a9eb89f7961aa2f54fef3f0ac658a117dd025.zip
CMake-979a9eb89f7961aa2f54fef3f0ac658a117dd025.tar.gz
CMake-979a9eb89f7961aa2f54fef3f0ac658a117dd025.tar.bz2
Merge topic 'doc-presets'
8a413eb8d0 Help: State default preset strategy for architecture and toolset 8de977fa70 Help: Use array consistently in presets manual e11773e8cf Help: Fix trivial typos related to presets Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !7817
-rw-r--r--Help/manual/cmake-presets.7.rst19
-rw-r--r--Help/release/3.25.rst2
2 files changed, 12 insertions, 9 deletions
diff --git a/Help/manual/cmake-presets.7.rst b/Help/manual/cmake-presets.7.rst
index ae6dcb1..da699d8 100644
--- a/Help/manual/cmake-presets.7.rst
+++ b/Help/manual/cmake-presets.7.rst
@@ -161,7 +161,7 @@ that may contain the following fields:
presets by default (except ``name``, ``hidden``, ``inherits``,
``description``, and ``displayName``), but can override them as
desired. If multiple ``inherits`` presets provide conflicting values for
- the same field, the earlier preset in the ``inherits`` list will be
+ the same field, the earlier preset in the ``inherits`` array will be
preferred.
A preset can only inherit from another preset that is defined in the
@@ -202,7 +202,7 @@ that may contain the following fields:
Optional fields representing the platform and toolset, respectively, for
:manual:`generators <cmake-generators(7)>` that support them.
- See :option:`cmake -A` option for for possible values for ``architecture``
+ See :option:`cmake -A` option for possible values for ``architecture``
and :option:`cmake -T` for ``toolset``.
Each may be either a string or an object with the following fields:
@@ -226,6 +226,9 @@ that may contain the following fields:
ignore the field, but the IDE can use them to set up the environment
before invoking CMake.
+ If no ``strategy`` field is given, or if the field uses the string form
+ rather than the object form, the behavior is the same as ``"set"``.
+
``toolchainFile``
An optional string representing the path to the toolchain file.
This field supports `macro expansion`_. If a relative path is specified,
@@ -388,7 +391,7 @@ that may contain the following fields:
``inherits`` presets by default (except ``name``, ``hidden``,
``inherits``, ``description``, and ``displayName``), but can override
them as desired. If multiple ``inherits`` presets provide conflicting
- values for the same field, the earlier preset in the ``inherits`` list
+ values for the same field, the earlier preset in the ``inherits`` array
will be preferred.
A preset can only inherit from another preset that is defined in the
@@ -549,7 +552,7 @@ that may contain the following fields:
``inherits`` presets by default (except ``name``, ``hidden``,
``inherits``, ``description``, and ``displayName``), but can override
them as desired. If multiple ``inherits`` presets provide conflicting
- values for the same field, the earlier preset in the ``inherits`` list
+ values for the same field, the earlier preset in the ``inherits`` array
will be preferred.
A preset can only inherit from another preset that is defined in the
@@ -891,7 +894,7 @@ fields:
``inherits`` presets by default (except ``name``, ``hidden``,
``inherits``, ``description``, and ``displayName``), but can override
them as desired. If multiple ``inherits`` presets provide conflicting
- values for the same field, the earlier preset in the ``inherits`` list
+ values for the same field, the earlier preset in the ``inherits`` array
will be preferred.
A preset can only inherit from another preset that is defined in the
@@ -948,10 +951,10 @@ fields:
explicitly specified in this package preset.
``generators``
- An optional list of strings representing generators for CPack to use.
+ An optional array of strings representing generators for CPack to use.
``configurations``
- An optional list of strings representing build configurations for CPack to
+ An optional array of strings representing build configurations for CPack to
package.
``variables``
@@ -1073,7 +1076,7 @@ object, it has the following fields:
A required string to search for. This field supports macro expansion.
``list``
- A required list of strings to search. This field supports macro
+ A required array of strings to search. This field supports macro
expansion, and uses short-circuit evaluation.
``"matches"``
diff --git a/Help/release/3.25.rst b/Help/release/3.25.rst
index c119fae..199e067 100644
--- a/Help/release/3.25.rst
+++ b/Help/release/3.25.rst
@@ -21,7 +21,7 @@ Presets
* The :manual:`cmake-presets(7)` format now supports a
``workflowPresets`` field to specify presets for :option:`cmake --workflow`.
-* The :manual:`cmake-presets(7)` format now supports a
+* The :manual:`cmake-presets(7)` format now supports an
``outputJUnitFile`` field to specify JUnit output in test presets.
Languages