@@ -18,14 +18,26 @@ Date: August 2012
1818
1919int run (const std::string &what, const std::vector<std::string> &argv);
2020
21+ // / This runs the executable given by the file name \p what.
22+ // / Control returns when execution has finished.
23+ // / Stdin, stdout and stderr may be redirected from/to a given file.
24+ // / Give the empty string to retain the default handle.
25+ // / Any shell-meta characters in the executable, \p argv and the I/O
26+ // / redirect files are escaped as needed.
2127int run (
2228 const std::string &what,
2329 const std::vector<std::string> &argv,
2430 const std::string &std_input,
2531 const std::string &std_output,
2632 const std::string &std_error);
2733
28- // / A variant that streams the stdout of the child into an ostream
34+ // / This runs the executable given by the file name \p what.
35+ // / Control returns when execution has finished.
36+ // / Stdin and stderr may be redirected from/to a given file.
37+ // / Give the empty string to retain the default handle.
38+ // / Any output to stdout is stored in the \p std_output stream buffer.
39+ // / Any shell-meta characters in the executable, \p argv and the I/O
40+ // / redirect files are escaped as needed.
2941int run (
3042 const std::string &what,
3143 const std::vector<std::string> &argv,
0 commit comments