summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorHenri Manson <hfmanson@gmail.com>2019-03-04 11:40:24 (GMT)
committerBrad King <brad.king@kitware.com>2019-03-11 15:39:25 (GMT)
commit463c2fba4eec7f364689a11b7c36afe966b1f151 (patch)
tree968eb63ed218579fd19f30412b3e3959cd5ae744 /Help
parent21da25d2a878cfccf9496ef7b227de2c98601ef2 (diff)
downloadCMake-463c2fba4eec7f364689a11b7c36afe966b1f151.zip
CMake-463c2fba4eec7f364689a11b7c36afe966b1f151.tar.gz
CMake-463c2fba4eec7f364689a11b7c36afe966b1f151.tar.bz2
Genex: Teach SHELL_PATH to support a list of paths
Extend the genex added by commit ca6ba3fee5 (Genex: Add a SHELL_PATH expression, 2015-09-24, v3.4.0-rc1~37^2) to accept a `;`-list of paths, convert them all, and generate a list separated by the native shell `PATH``` separator.
Diffstat (limited to 'Help')
-rw-r--r--Help/manual/cmake-generator-expressions.7.rst5
-rw-r--r--Help/release/dev/shell_path.rst5
2 files changed, 10 insertions, 0 deletions
diff --git a/Help/manual/cmake-generator-expressions.7.rst b/Help/manual/cmake-generator-expressions.7.rst
index 7f484a4..614358a 100644
--- a/Help/manual/cmake-generator-expressions.7.rst
+++ b/Help/manual/cmake-generator-expressions.7.rst
@@ -455,6 +455,11 @@ Output-Related Expressions
Content of ``...`` converted to shell path style. For example, slashes are
converted to backslashes in Windows shells and drive letters are converted
to posix paths in MSYS shells. The ``...`` must be an absolute path.
+ The ``...`` may be a :ref:`semicolon-separated list <CMake Language Lists>`
+ of paths, in which case each path is converted individually and a result
+ list is generated using the shell path separator (``:`` on POSIX and
+ ``;`` on Windows). Be sure to enclose the argument containing this genex
+ in double quotes in CMake source code so that ``;`` does not split arguments.
Debugging
=========
diff --git a/Help/release/dev/shell_path.rst b/Help/release/dev/shell_path.rst
new file mode 100644
index 0000000..e8ebfb5
--- /dev/null
+++ b/Help/release/dev/shell_path.rst
@@ -0,0 +1,5 @@
+shell_path
+----------
+
+* The ``$<SHELL_PATH:...>`` :manual:`generator expression
+ <cmake-generator-expressions(7)>` gained support for a list of paths.