]> git.eshelyaron.com Git - emacs.git/commitdiff
Clarify where the shell-command output goes
authorMichael Albinus <michael.albinus@gmx.de>
Fri, 28 Jan 2022 15:32:15 +0000 (16:32 +0100)
committerLars Ingebrigtsen <larsi@gnus.org>
Fri, 28 Jan 2022 15:32:15 +0000 (16:32 +0100)
* lisp/simple.el (shell-command):
* doc/emacs/misc.texi (Single Shell): Clarify where the output
goes if the specified buffer isn't the current one (bug#40896).

doc/emacs/misc.texi
lisp/simple.el

index 365c079e897680dc664cf710058c9c6c0266a7db..4710c05b620b244ffc0118c3ac9e956e3b3c6244 100644 (file)
@@ -856,6 +856,9 @@ Restores the position of point as it was before inserting the
 shell-command output.
 @end table
 
+In case the output buffer is not the current buffer, shell command
+output is appended at the end of this buffer.
+
 @node Interactive Shell
 @subsection Interactive Subshell
 
index 801a3c992c8fb2b7d82f29f421101a905880bbea..00669ac63499f12ff582350ddfe62e741ba79abd 100644 (file)
@@ -4092,6 +4092,10 @@ interactively when the prefix argument is given), insert the
 output in current buffer after point leaving mark after it.  This
 cannot be done asynchronously.
 
+If OUTPUT-BUFFER is a buffer or buffer name different from the
+current buffer, instead of outputting at point in that buffer,
+the output will be appended at the end of that buffer.
+
 The user option `shell-command-dont-erase-buffer', which see, controls
 whether the output buffer is erased and where to put point after
 the shell command.