comparison lispref/windows.texi @ 52151:eddd7191f683

(Buffers and Windows): set-window-buffer has new arg.

52150:d35ce1568ac0

related functions that find a window to use and specify a buffer for it.
The functions described there are easier to use than these, but they
employ heuristics in choosing or creating a window; use these functions
when you need complete control.

@defun set-window-buffer window buffer-or-name
This function makes @var{window} display @var{buffer-or-name} as its
contents.  It returns @code{nil}.  This is the fundamental primitive
for changing which buffer is displayed in a window, and all ways
of doing that call this function.

@group
(set-window-buffer (selected-window) "foo")
     @result{} nil
@end group
@end example
@end defun

@defun window-buffer &optional window
This function returns the buffer that @var{window} is displaying.  If
@var{window} is omitted, this function returns the buffer for the

52151:eddd7191f683

related functions that find a window to use and specify a buffer for it.
The functions described there are easier to use than these, but they
employ heuristics in choosing or creating a window; use these functions
when you need complete control.

@defun set-window-buffer window buffer-or-name &optional keep-margins
This function makes @var{window} display @var{buffer-or-name} as its
contents.  It returns @code{nil}.  This is the fundamental primitive
for changing which buffer is displayed in a window, and all ways
of doing that call this function.

@group
(set-window-buffer (selected-window) "foo")
     @result{} nil
@end group
@end example

Normally, displaying @var{buffer} in @var{window} resets the window's
fringe widths and position based on the local variables of @var{buffer}.
However, if @var{keep-margins} is non-@code{nil}, the fringe widths and
position of @var{window} remain unchanged.  @xref{Fringes}.
@end defun

@defun window-buffer &optional window
This function returns the buffer that @var{window} is displaying.  If
@var{window} is omitted, this function returns the buffer for the