summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorErin Melucci <emelucci@opera.com>2022-05-09 17:18:53 (GMT)
committerBrad King <brad.king@kitware.com>2022-05-12 14:37:49 (GMT)
commitba969ce5fe3a363b52dd4f0290e4b827272101fb (patch)
treeb3a8747cdf46785bd05851fccb2f35e7778723bd /Help
parentef10e61b6b7d3bb264cdbf72e143dbef7be8c736 (diff)
downloadCMake-ba969ce5fe3a363b52dd4f0290e4b827272101fb.zip
CMake-ba969ce5fe3a363b52dd4f0290e4b827272101fb.tar.gz
CMake-ba969ce5fe3a363b52dd4f0290e4b827272101fb.tar.bz2
cmake-presets: add ${pathListSep} macro
Fixes: #23282
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/cmake-presets.7.rst11
-rw-r--r--Help/release/dev/presets-pathListSep.rst5
2 files changed, 16 insertions, 0 deletions
diff --git a/Help/manual/cmake-presets.7.rst b/Help/manual/cmake-presets.7.rst
index c8d24f2..948d87a 100644
--- a/Help/manual/cmake-presets.7.rst
+++ b/Help/manual/cmake-presets.7.rst
@@ -1068,6 +1068,17 @@ Recognized macros include:
A literal dollar sign (``$``).
+``${pathListSep}``
+
+ Native character for separating lists of paths, such as ``:`` or ``;``.
+
+ For example, by setting ``PATH`` to
+ ``/path/to/ninja/bin${pathListSep}$env{PATH}``, ``${pathListSep}`` will
+ expand to the underlying operating system's character used for
+ concatenation in ``PATH``.
+
+ This is allowed in preset files specifying version ``5`` or above.
+
``$env{<variable-name>}``
Environment variable with name ``<variable-name>``. The variable name may
diff --git a/Help/release/dev/presets-pathListSep.rst b/Help/release/dev/presets-pathListSep.rst
new file mode 100644
index 0000000..84b129f
--- /dev/null
+++ b/Help/release/dev/presets-pathListSep.rst
@@ -0,0 +1,5 @@
+presets-pathListSep
+-------------------
+
+* :manual:`cmake-presets(7)` files now support a ``${pathListSep}`` macro,
+ which expands to ``:`` or ``;`` based on the platform.