Function: display-buffer-no-window

display-buffer-no-window is a byte-compiled function defined in window.el.gz.

Signature

(display-buffer-no-window BUFFER ALIST)

Documentation

Display BUFFER in no window.

ALIST is an association list of action symbols and values. See Info node (elisp) Buffer Display Action Alists for details of such alists.

If ALIST contains a non-nil allow-no-window entry, do nothing and return fail. This allows display-buffer to override the default action and avoid displaying the buffer. It is assumed that when the caller specifies a non-nil allow-no-window ALIST entry, it can handle a nil value returned by display-buffer.

This is an action function for buffer display, see Info node (elisp) Buffer Display Action Functions. It should be called only by display-buffer or a function directly or indirectly called by the latter.

Probably introduced at or before Emacs version 24.4.

Source Code

;; Defined in /usr/src/emacs/lisp/window.el.gz
(defun display-buffer-no-window (_buffer alist)
  "Display BUFFER in no window.
ALIST is an association list of action symbols and values.  See
Info node `(elisp) Buffer Display Action Alists' for details of
such alists.

If ALIST contains a non-nil `allow-no-window' entry, do nothing
and return `fail'.  This allows `display-buffer' to override the
default action and avoid displaying the buffer.  It is assumed
that when the caller specifies a non-nil `allow-no-window' ALIST
entry, it can handle a nil value returned by `display-buffer'.

This is an action function for buffer display, see Info
node `(elisp) Buffer Display Action Functions'.  It should be
called only by `display-buffer' or a function directly or
indirectly called by the latter."
  (when (cdr (assq 'allow-no-window alist))
    'fail))