aboutsummaryrefslogtreecommitdiff
path: root/src/connection.lisp
diff options
context:
space:
mode:
authorSean Whitton <spwhitton@spwhitton.name>2021-05-25 12:58:25 -0700
committerSean Whitton <spwhitton@spwhitton.name>2021-05-25 12:59:15 -0700
commit6f92d92e7b1b6a620f1ddd4bcfb080732cae3649 (patch)
tree6e56c9cdc6c6f54fb5951d19af43144d067e1792 /src/connection.lisp
parent53ede3562a5d36a97c46e2d0d91aac6fb2ca926a (diff)
downloadconsfigurator-6f92d92e7b1b6a620f1ddd4bcfb080732cae3649.tar.gz
don't recommend RUN over MRUN in general
Signed-off-by: Sean Whitton <spwhitton@spwhitton.name>
Diffstat (limited to 'src/connection.lisp')
-rw-r--r--src/connection.lisp9
1 files changed, 6 insertions, 3 deletions
diff --git a/src/connection.lisp b/src/connection.lisp
index 9af1f86..3f979d2 100644
--- a/src/connection.lisp
+++ b/src/connection.lisp
@@ -418,9 +418,12 @@ Some (but not all) connection types will want to use this when implementing
ESTABLISH-CONNECTION, CONNECTION-RUN, CONNECTION-WRITEFILE etc. to avoid the
overhead of splitting the output streams only to immediately recombine them.
-Some :POSIX properties which want to run a lot of commands and don't need to
-separate the streams might want to use this too, but usually it is best to
-start with RUN."
+Code in property definitions which will not examine command output should
+usually use this in preference to RUN for a performance boost; an exception is
+when the command sends a lot of text to stdout which might make it harder for
+the user to pick out error messages. Code which examines command output
+should use RUN and only examine the stream from which the output to be read is
+expected."
(%process-run-args
(informat 4 "~&MRUN ~A" cmd)
(multiple-value-bind (out exit)