Variable: eshell-command-async-buffer

eshell-command-async-buffer is a customizable variable defined in eshell.el.gz.

Value

confirm-new-buffer

Documentation

What to do when the output buffer is used by another shell command.

This option specifies how to resolve the conflict where a new command wants to direct its output to the buffer whose name is stored in eshell-command-buffer-name-async, but that buffer is already taken by another running shell command.

The value confirm-kill-process is used to ask for confirmation before killing the already running process and running a new process in the same buffer, confirm-new-buffer for confirmation before running the command in a new buffer with a name other than the default buffer name, new-buffer for doing the same without confirmation, confirm-rename-buffer for confirmation before renaming the existing output buffer and running a new command in the default buffer, rename-buffer for doing the same without confirmation.

This variable was added, or its default value changed, in Emacs 31.1.

Probably introduced at or before Emacs version 31.1.

Source Code

;; Defined in /usr/src/emacs/lisp/eshell/eshell.el.gz
(defcustom eshell-command-async-buffer 'confirm-new-buffer
  "What to do when the output buffer is used by another shell command.
This option specifies how to resolve the conflict where a new command
wants to direct its output to the buffer whose name is stored
in `eshell-command-buffer-name-async', but that buffer is already
taken by another running shell command.

The value `confirm-kill-process' is used to ask for confirmation before
killing the already running process and running a new process in the
same buffer, `confirm-new-buffer' for confirmation before running the
command in a new buffer with a name other than the default buffer name,
`new-buffer' for doing the same without confirmation,
`confirm-rename-buffer' for confirmation before renaming the existing
output buffer and running a new command in the default buffer,
`rename-buffer' for doing the same without confirmation."
  :type '(choice (const :tag "Confirm killing of running command"
                        confirm-kill-process)
                 (const :tag "Confirm creation of a new buffer"
                        confirm-new-buffer)
                 (const :tag "Create a new buffer"
                        new-buffer)
                 (const :tag "Confirm renaming of existing buffer"
                        confirm-rename-buffer)
                 (const :tag "Rename the existing buffer"
                        rename-buffer))
  :group 'eshell
  :version "31.1")