; * lisp/eshell/em-script.el (eshell-execute-file): Improve docstring.

(cherry picked from commit 19b407ac749fcb8d978e8263ed98328100128de5)

diff --git a/lisp/eshell/em-script.el b/lisp/eshell/em-script.el
index 6cddffdcf5fc990ea58f17ac5f11f3152d97c509..ba020d2eb5b9d800fb78c22e4673d5d4335e27b0 100644 (file)
--- a/lisp/eshell/em-script.el
+++ b/lisp/eshell/em-script.el
@@ -108,6 +108,10 @@ Comments begin with `#'."
 ;;;###autoload
 (defun eshell-execute-file (file &optional args destination)
   "Execute a series of Eshell commands in FILE, passing ARGS.
+If DESTINATION is t, write the command output to the current buffer.  If
+nil, don't write the output anywhere.  For any other value, output to
+the corresponding Eshell target (see `eshell-get-target').
+
 Comments begin with `#'."
   (let ((eshell-non-interactive-p t)
         (stdout (if (eq destination t) (current-buffer) destination)))