Commit d4bd55e7 authored by Chong Yidong's avatar Chong Yidong
Browse files

* lisp/window.el (display-buffer): Doc fix.

Fixes: debbugs:10785
parent 95986d52
2012-02-12 Chong Yidong <cyd@gnu.org>
* window.el (display-buffer): Doc fix (Bug#10785).
2012-02-12 Glenn Morris <rgm@gnu.org>
* term/pc-win.el (x-selection-owner-p, x-own-selection-internal)
......
......@@ -4625,16 +4625,20 @@ buffer. Return the window chosen for displaying BUFFER-OR-NAME,
or nil if no such window is found.
Optional argument ACTION should have the form (FUNCTION . ALIST).
FUNCTION is either a function or a list of functions. Each such
function is called with two arguments: the buffer to display and
an alist. It should either display the buffer and return the
window, or return nil if unable to display the buffer.
FUNCTION is either a function or a list of functions.
ALIST is an arbitrary association list (alist).
Each such FUNCTION should accept two arguments: the buffer to
display and an alist. Based on those arguments, it should either
display the buffer and return the window, or return nil if unable
to display the buffer.
The `display-buffer' function builds a function list and an alist
from `display-buffer-overriding-action', `display-buffer-alist',
the ACTION argument, `display-buffer-base-action', and
`display-buffer-fallback-action' (in that order). Then it calls
each function in the combined function list in turn, passing the
by combining the functions and alists specified in
`display-buffer-overriding-action', `display-buffer-alist', the
ACTION argument, `display-buffer-base-action', and
`display-buffer-fallback-action' (in order). Then it calls each
function in the combined function list in turn, passing the
buffer as the first argument and the combined alist as the second
argument, until one of the functions returns non-nil.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment