diff lispref/windows.texi @ 22138:d4ac295a98b3

*** empty log message ***

--- a/lispref/windows.texi	Tue May 19 03:41:25 1998 +0000
+++ b/lispref/windows.texi	Tue May 19 03:45:57 1998 +0000
@@ -597,7 +597,9 @@
 
 @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}.
+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.
 
 @example
 @group
@@ -669,6 +671,16 @@
 @end itemize
 @end defun
 
+@defvar buffer-display-time
+@tindex buffer-display-time
+This variable records the time at which a buffer was last made visible
+in a window.  It is always local in each buffer; each time
+@code{set-window-buffer} is called, it sets this variable to
+@code{(current-time)} in the specified buffer (@pxref{Time of Day}).
+When a buffer is first created, @code{buffer-display-count} starts out
+with the value @code{nil}.
+@end defvar
+
 @node Displaying Buffers
 @section Displaying Buffers in Windows
 @cindex switching to a buffer
@@ -685,7 +697,8 @@
 @ifinfo
 @xref{Buffers and Windows}, for
 @end ifinfo
-low-level functions that give you more precise control.
+low-level functions that give you more precise control.  All of these
+functions work by calling @code{set-window-buffer}.
 
   Do not use the functions in this section in order to make a buffer
 current so that a Lisp program can access or modify it; they are too
@@ -786,14 +799,6 @@
 This function returns @code{nil}.
 @end deffn
 
-@tindex buffer-display-count
-@defvar buffer-display-count
-This variable is always buffer-local in each buffer.  When the buffer is
-created, @code{buffer-display-count} has value 0.  Each time the buffer
-is displayed in a window, that increments the value of
-@code{buffer-display-count}.
-@end defvar
-
 @node Choosing Window
 @section Choosing a Window for Display
 
@@ -1308,13 +1313,14 @@
 @section Horizontal Scrolling
 @cindex horizontal scrolling
 
-  Because we read English first from top to bottom and second from left
-to right, horizontal scrolling is not like vertical scrolling.  Vertical
-scrolling involves selection of a contiguous portion of text to display.
-Horizontal scrolling causes part of each line to go off screen.  The
-amount of horizontal scrolling is therefore specified as a number of
-columns rather than as a position in the buffer.  It has nothing to do
-with the display-start position returned by @code{window-start}.
+  Because we read English from left to right in the ``inner loop'', and
+from top to bottom in the ``outer loop'', horizontal scrolling is not
+like vertical scrolling.  Vertical scrolling involves selection of a
+contiguous portion of text to display, but horizontal scrolling causes
+part of each line to go off screen.  The amount of horizontal scrolling
+is therefore specified as a number of columns rather than as a position
+in the buffer.  It has nothing to do with the display-start position
+returned by @code{window-start}.
 
   Usually, no horizontal scrolling is in effect; then the leftmost
 column is at the left edge of the window.  In this state, scrolling to
@@ -1838,8 +1844,8 @@
 Windows}) is what you need here.
 @end defvar
 
+@defvar redisplay-end-trigger-functions
 @tindex redisplay-end-trigger-functions
-@defvar redisplay-end-trigger-functions
 This abnormal hook is run whenever redisplay in window uses text that
 extends past a specified end trigger position.  You set the end trigger
 position with the function @code{set-window-redisplay-end-trigger}.  The
@@ -1849,19 +1855,19 @@
 after the hook is run.
 @end defvar
 
+@defun set-window-redisplay-end-trigger window position
 @tindex set-window-redisplay-end-trigger
-@defun set-window-redisplay-end-trigger window position
 This function sets @var{window}'s end trigger position at
 @var{position}.
 @end defun
 
+@defun window-redisplay-end-trigger window
 @tindex window-redisplay-end-trigger
-@defun window-redisplay-end-trigger window
 This function returns @var{window}'s current end trigger position.
 @end defun
 
+@defvar window-configuration-change-hook
 @tindex window-configuration-change-hook
-@defvar window-configuration-change-hook
 A normal hook that is run every time you change the window configuration
 of an existing frame.  This includes splitting or deleting windows,
 changing the sizes of windows, or displaying a different buffer in a