summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorAsit Dhal <dhal.asitk@gmail.com>2020-09-20 02:29:53 (GMT)
committerAsit Dhal <dhal.asitk@gmail.com>2020-10-01 15:07:44 (GMT)
commit116a427eb1aa7e603a80a50486c08cd0dd16d7dd (patch)
treec0a83c7d054b77110fcc77af694d63a6ef0672d7 /Help
parent47b569a85852f716b05ede538e9940392407316c (diff)
downloadCMake-116a427eb1aa7e603a80a50486c08cd0dd16d7dd.zip
CMake-116a427eb1aa7e603a80a50486c08cd0dd16d7dd.tar.gz
CMake-116a427eb1aa7e603a80a50486c08cd0dd16d7dd.tar.bz2
execute_process: add options for fatal errors on subprocess failure
Fixes: #19930
Diffstat (limited to 'Help')
-rw-r--r--Help/command/execute_process.rst8
-rw-r--r--Help/release/dev/execute-process-command-error-is-fatal.rst5
2 files changed, 12 insertions, 1 deletions
diff --git a/Help/command/execute_process.rst b/Help/command/execute_process.rst
index b32025f..a6f141a 100644
--- a/Help/command/execute_process.rst
+++ b/Help/command/execute_process.rst
@@ -23,7 +23,8 @@ Execute one or more child processes.
[ERROR_STRIP_TRAILING_WHITESPACE]
[ENCODING <name>]
[ECHO_OUTPUT_VARIABLE]
- [ECHO_ERROR_VARIABLE])
+ [ECHO_ERROR_VARIABLE]
+ [COMMAND_ERROR_IS_FATAL <ANY|LAST>])
Runs the given sequence of one or more commands.
@@ -116,6 +117,11 @@ Options:
This is analogous to the ``tee`` Unix command.
+``COMMAND_ERROR_IS_FATAL <ANY|LAST>``
+ ``COMMAND_ERROR_IS_FATAL ANY`` option stops processing if any command fails.
+ ``COMMAND_ERROR_IS_FATAL LAST`` option stops processing if the last command
+ in the command list fails.
+
If more than one ``OUTPUT_*`` or ``ERROR_*`` option is given for the
same pipe the precedence is not specified.
If no ``OUTPUT_*`` or ``ERROR_*`` options are given the output will
diff --git a/Help/release/dev/execute-process-command-error-is-fatal.rst b/Help/release/dev/execute-process-command-error-is-fatal.rst
new file mode 100644
index 0000000..fbc54bf
--- /dev/null
+++ b/Help/release/dev/execute-process-command-error-is-fatal.rst
@@ -0,0 +1,5 @@
+execute-process-command-error-is-fatal
+--------------------------------------
+
+* The :command:`execute_process` command gained a ``COMMAND_ERROR_IS_FATAL``
+ option to specify a fatal error.