From 77e78af1a2f10d5ec349d0a46118cddd8ec7a539 Mon Sep 17 00:00:00 2001 From: Christian Fetzer Date: Tue, 1 Nov 2016 10:19:00 +0100 Subject: Help: Clarify how to run sequential commands in execute_process The execute_process command starts all commands in parallel (in order for the piping to work). Mention this explicitly and also add a note about how to execute commands sequentially. --- Help/command/execute_process.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Help/command/execute_process.rst b/Help/command/execute_process.rst index ca44b53..e9a5eb0 100644 --- a/Help/command/execute_process.rst +++ b/Help/command/execute_process.rst @@ -20,7 +20,7 @@ Execute one or more child processes. [OUTPUT_STRIP_TRAILING_WHITESPACE] [ERROR_STRIP_TRAILING_WHITESPACE]) -Runs the given sequence of one or more commands with the standard +Runs the given sequence of one or more commands in parallel with the standard output of each process piped to the standard input of the next. A single standard error pipe is used for all processes. @@ -36,6 +36,9 @@ Options: (Use the ``INPUT_*``, ``OUTPUT_*``, and ``ERROR_*`` options to redirect stdin, stdout, and stderr.) + If a sequential execution of multiple commands is required, use multiple + :command:`execute_process` calls with a single ``COMMAND`` argument. + ``WORKING_DIRECTORY`` The named directory will be set as the current working directory of the child processes. -- cgit v0.12 From 311d0376e2312d3539bd997160f880cf58743834 Mon Sep 17 00:00:00 2001 From: Christian Fetzer Date: Tue, 1 Nov 2016 10:23:15 +0100 Subject: Help: Document error behavior of file(REMOVE/REMOVE_RECURSE) Clarifies that there is no need to surround file(REMOVE/REMOVE_RECURSE) calls by `if(EXISTS)` as non existent files are silently ignored. --- Help/command/file.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Help/command/file.rst b/Help/command/file.rst index 77e9f62..8da46cb 100644 --- a/Help/command/file.rst +++ b/Help/command/file.rst @@ -153,7 +153,8 @@ Move a file or directory within a filesystem from ```` to file(REMOVE_RECURSE [...]) Remove the given files. The ``REMOVE_RECURSE`` mode will remove the given -files and directories, also non-empty directories +files and directories, also non-empty directories. No error is emitted if a +given file does not exist. ------------------------------------------------------------------------------ -- cgit v0.12