diff options
author | Eli Zaretskii <eliz@gnu.org> | 2023-05-14 10:13:39 +0300 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2023-05-14 10:13:39 +0300 |
commit | 5c8864fab4fd445144eb9ba845e02230302819dc (patch) | |
tree | d406e63ad999ce749eca04f525adae8e4ad21857 /lisp | |
parent | b96dc472bcba9a484d8151cec61752464f599ad2 (diff) | |
download | emacs-5c8864fab4fd445144eb9ba845e02230302819dc.tar.gz |
; * lisp/simple.el (async-shell-command): Doc fix. (Bug#63432)
Diffstat (limited to 'lisp')
-rw-r--r-- | lisp/simple.el | 17 |
1 files 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 " &"))) |