Variable: special-display-function

special-display-function is a customizable variable defined in window.el.gz.

This variable is obsolete since 24.3; use display-buffer-alist instead.

Value

special-display-popup-frame

Documentation

Function to call for displaying special buffers.

This function is called with two arguments - the buffer and, optionally, a list - and should return a window displaying that buffer. The default value usually makes a separate frame for the buffer using special-display-frame-alist to specify the frame parameters. See the definition of special-display-popup-frame for how to specify such a function.

A buffer is special when its name is either listed in special-display-buffer-names or matches a regexp in special-display-regexps.

The specified function should call display-buffer-record-window with corresponding arguments to set up the quit-restore parameter of the window used.

Probably introduced at or before Emacs version 24.3.

Source Code

;; Defined in /usr/src/emacs/lisp/window.el.gz
(defcustom special-display-function 'special-display-popup-frame
  "Function to call for displaying special buffers.
This function is called with two arguments - the buffer and,
optionally, a list - and should return a window displaying that
buffer.  The default value usually makes a separate frame for the
buffer using `special-display-frame-alist' to specify the frame
parameters.  See the definition of `special-display-popup-frame'
for how to specify such a function.

A buffer is special when its name is either listed in
`special-display-buffer-names' or matches a regexp in
`special-display-regexps'.

The specified function should call `display-buffer-record-window'
with corresponding arguments to set up the quit-restore parameter
of the window used."
  :type 'function
  :group 'frames)