summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2017-06-12 14:20:56 (GMT)
committerKitware Robot <kwrobot@kitware.com>2017-06-12 14:22:12 (GMT)
commit00b91b153089cfec8d60fd58bfa135e55ddae1b9 (patch)
treea80e11db4d800d70287e5b9b61abfde339a6c4f9 /Help
parent0cb8730c0b4e032db451789933ee7eb65d264278 (diff)
parentd6051ca39e2ac8e5afc8f6308fd1bda7d1e8c17b (diff)
downloadCMake-00b91b153089cfec8d60fd58bfa135e55ddae1b9.zip
CMake-00b91b153089cfec8d60fd58bfa135e55ddae1b9.tar.gz
CMake-00b91b153089cfec8d60fd58bfa135e55ddae1b9.tar.bz2
Merge topic 'execute_process-pipeline-results'
d6051ca3 execute_process: Add option to get results of every child Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !702
Diffstat (limited to 'Help')
-rw-r--r--Help/command/execute_process.rst9
-rw-r--r--Help/release/dev/execute_process-pipeline-results.rst6
2 files changed, 14 insertions, 1 deletions
diff --git a/Help/command/execute_process.rst b/Help/command/execute_process.rst
index d617243..799493f 100644
--- a/Help/command/execute_process.rst
+++ b/Help/command/execute_process.rst
@@ -10,6 +10,7 @@ Execute one or more child processes.
[WORKING_DIRECTORY <directory>]
[TIMEOUT <seconds>]
[RESULT_VARIABLE <variable>]
+ [RESULTS_VARIABLE <variable>]
[OUTPUT_VARIABLE <variable>]
[ERROR_VARIABLE <variable>]
[INPUT_FILE <file>]
@@ -49,10 +50,16 @@ Options:
specified number of seconds (fractions are allowed).
``RESULT_VARIABLE``
- The variable will be set to contain the result of running the processes.
+ The variable will be set to contain the result of last child process.
This will be an integer return code from the last child or a string
describing an error condition.
+``RESULTS_VARIABLE <variable>``
+ The variable will be set to contain the result of all processes as a
+ :ref:`;-list <CMake Language Lists>`, in order of the given ``COMMAND``
+ arguments. Each entry will be an integer return code from the
+ corresponding child or a string describing an error condition.
+
``OUTPUT_VARIABLE``, ``ERROR_VARIABLE``
The variable named will be set with the contents of the standard output
and standard error pipes, respectively. If the same variable is named
diff --git a/Help/release/dev/execute_process-pipeline-results.rst b/Help/release/dev/execute_process-pipeline-results.rst
new file mode 100644
index 0000000..9755ef5
--- /dev/null
+++ b/Help/release/dev/execute_process-pipeline-results.rst
@@ -0,0 +1,6 @@
+execute_process-pipeline-results
+--------------------------------
+
+* The :command:`execute_process` command gained a ``RESULTS_VARIABLE``
+ option to collect a list of results from all children in a pipeline
+ of processes when multiple ``COMMAND`` arguments are given.