From 5c8864fab4fd445144eb9ba845e02230302819dc Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sun, 14 May 2023 10:13:39 +0300 Subject: [PATCH] ; * lisp/simple.el (async-shell-command): Doc fix. (Bug#63432) --- lisp/simple.el | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/lisp/simple.el b/lisp/simple.el index c3d0726f91b..0138556787b 100644 --- a/lisp/simple.el +++ b/lisp/simple.el @@ -4460,11 +4460,13 @@ whose `car' is BUFFER." Like `shell-command', but adds `&' at the end of COMMAND to execute it asynchronously. -The output appears in the buffer whose name is stored in the -variable `shell-command-buffer-name-async'. That buffer is in -shell mode. +The output appears in OUTPUT-BUFFER, which could be a buffer or +the name of a buffer, and defaults to `shell-command-buffer-name-async' +if nil or omitted. That buffer is in shell mode. Note that, unlike +with `shell-command', OUTPUT-BUFFER can only be a buffer, a buffer's +name (a string), or nil. -You can configure `async-shell-command-buffer' to specify what to do +You can customize `async-shell-command-buffer' to specify what to do when the buffer specified by `shell-command-buffer-name-async' is already taken by another running shell command. @@ -4473,6 +4475,10 @@ configure `display-buffer-alist' to use the action `display-buffer-no-window' for the buffer given by `shell-command-buffer-name-async'. +Optional argument ERROR-BUFFER is for backward compatibility; it +is ignored, and error output of the async command is always +mingled with its regular output. + In Elisp, you will often be better served by calling `start-process' directly, since it offers more control and does not impose the use of a shell (with its need to quote arguments)." @@ -4491,6 +4497,9 @@ a shell (with its need to quote arguments)." (dired-get-filename nil t))))) (and filename (file-relative-name filename)))) nil + ;; FIXME: the following argument is always ignored by 'shell-commnd', + ;; when the command is invoked asynchronously, except, perhaps, when + ;; 'default-directory' is remote. shell-command-default-error-buffer)) (unless (string-match "&[ \t]*\\'" command) (setq command (concat command " &"))) -- 2.39.2