changeset 52151:eddd7191f683

(Buffers and Windows): set-window-buffer has new arg.
author Richard M. Stallman <rms@gnu.org>
date Wed, 06 Aug 2003 01:43:43 +0000
parents d35ce1568ac0
children b41c6ef00205
files lispref/windows.texi
diffstat 1 files changed, 6 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/windows.texi	Wed Aug 06 01:43:18 2003 +0000
+++ b/lispref/windows.texi	Wed Aug 06 01:43:43 2003 +0000
@@ -643,7 +643,7 @@
 employ heuristics in choosing or creating a window; use these functions
 when you need complete control.
 
-@defun set-window-buffer window buffer-or-name
+@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
@@ -655,6 +655,11 @@
      @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