From: Richard M. Stallman <rms@gnu.org>
Date: Mon, 24 Dec 2001 16:28:22 +0000 (+0000)
Subject: Explain mode line redisplay better.
X-Git-Tag: ttn-vms-21-2-B4~17508
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=8e0f7b5b48d1d430674b425e3bd5723a80967839;p=emacs.git

Explain mode line redisplay better.
---

diff --git a/lispref/modes.texi b/lispref/modes.texi
index 4ea2e6d25aa..7ac30f227cd 100644
--- a/lispref/modes.texi
+++ b/lispref/modes.texi
@@ -1058,18 +1058,25 @@ line and column numbers, since those depend on point and on how the
 window is scrolled.  @code{header-line-format} is used likewise for
 header lines.
 
-  The mode line and header line of a window are normally updated
-whenever a different buffer is shown in the window, or when the buffer's
-modified-status changes from @code{nil} to @code{t} or vice-versa.  If
-you modify any of the variables referenced by @code{mode-line-format}
-(@pxref{Mode Line Variables}), or any other variables and data
-structures that affect how text is displayed (@pxref{Display}), you may
-want to force an update of the mode line so as to display the new
-information or display it in the new way.
+  For efficiency, Emacs does not recompute the mode line and header
+line of a window in every redisplay.  It does so when circumstances
+appear to call for it---for instance, if you change the window
+configuration, switch buffers, narrow or widen the buffer, scroll, or
+change the buffer's modification status.  If you modify any of the
+variables referenced by @code{mode-line-format} (@pxref{Mode Line
+Variables}), or any other variables and data structures that affect
+how text is displayed (@pxref{Display}), you may want to force an
+update of the mode line so as to display the new information or
+display it in the new way.
 
 @c Emacs 19 feature
 @defun force-mode-line-update
 Force redisplay of the current buffer's mode line and header line.
+The next redisplay will update the mode line and header line based on
+the latest values of all relevant variables.
+
+This function also forces recomputation of the menu bar menus
+and the frame title.
 @end defun
 
   The mode line is usually displayed in inverse video; see