summaryrefslogtreecommitdiff
path: root/share/cmake-3.2/Help/command/execute_process.rst
diff options
context:
space:
mode:
Diffstat (limited to 'share/cmake-3.2/Help/command/execute_process.rst')
-rwxr-xr-xshare/cmake-3.2/Help/command/execute_process.rst75
1 files changed, 0 insertions, 75 deletions
diff --git a/share/cmake-3.2/Help/command/execute_process.rst b/share/cmake-3.2/Help/command/execute_process.rst
deleted file mode 100755
index 478b30e..0000000
--- a/share/cmake-3.2/Help/command/execute_process.rst
+++ /dev/null
@@ -1,75 +0,0 @@
-execute_process
----------------
-
-Execute one or more child processes.
-
-.. code-block:: cmake
-
- execute_process(COMMAND <cmd1> [args1...]]
- [COMMAND <cmd2> [args2...] [...]]
- [WORKING_DIRECTORY <directory>]
- [TIMEOUT <seconds>]
- [RESULT_VARIABLE <variable>]
- [OUTPUT_VARIABLE <variable>]
- [ERROR_VARIABLE <variable>]
- [INPUT_FILE <file>]
- [OUTPUT_FILE <file>]
- [ERROR_FILE <file>]
- [OUTPUT_QUIET]
- [ERROR_QUIET]
- [OUTPUT_STRIP_TRAILING_WHITESPACE]
- [ERROR_STRIP_TRAILING_WHITESPACE])
-
-Runs the given sequence of one or more commands 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.
-
-Options:
-
-COMMAND
- A child process command line.
-
- CMake executes the child process using operating system APIs directly.
- All arguments are passed VERBATIM to the child process.
- No intermediate shell is used, so shell operators such as ``>``
- are treated as normal arguments.
- (Use the ``INPUT_*``, ``OUTPUT_*``, and ``ERROR_*`` options to
- redirect stdin, stdout, and stderr.)
-
-WORKING_DIRECTORY
- The named directory will be set as the current working directory of
- the child processes.
-
-TIMEOUT
- The child processes will be terminated if they do not finish in the
- specified number of seconds (fractions are allowed).
-
-RESULT_VARIABLE
- The variable will be set to contain the result of running the processes.
- This will be an integer return code from the last 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
- for both pipes their output will be merged in the order produced.
-
-INPUT_FILE, OUTPUT_FILE, ERROR_FILE
- The file named will be attached to the standard input of the first
- process, standard output of the last process, or standard error of
- all processes, respectively.
-
-OUTPUT_QUIET, ERROR_QUIET
- The standard output or standard error results will be quietly ignored.
-
-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
-be shared with the corresponding pipes of the CMake process itself.
-
-The :command:`execute_process` command is a newer more powerful version of
-:command:`exec_program`, but the old command has been kept for compatibility.
-Both commands run while CMake is processing the project prior to build
-system generation. Use :command:`add_custom_target` and
-:command:`add_custom_command` to create custom commands that run at
-build time.