[Emacs-diffs] emacs-25 3db8ce4: Document 'pre-redisplay-functions'

[Eli Zaretskii]

branch: emacs-25
commit 3db8ce4fbd75b978d658df58810adf1deca04708
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Document 'pre-redisplay-functions'
    
    * doc/lispref/hooks.texi (Standard Hooks):
    * doc/lispref/display.texi (Forcing Redisplay): Document
    'pre-redisplay-functions'.
---
 doc/lispref/display.texi |   18 +++++++++++++-----
 doc/lispref/hooks.texi   |   24 ++++++++++++++----------
 etc/NEWS                 |    4 +++-
 3 files changed, 30 insertions(+), 16 deletions(-)

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 93b00e1..1ac0f05 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -95,11 +95,6 @@ redisplay proceeded to completion; it could have been 
preempted by
 newly arriving input.
 @end defun
 
address@hidden pre-redisplay-function
-A function run just before redisplay.  It is called with one argument,
-the set of windows to redisplay.
address@hidden defvar
-
   Although @code{redisplay} tries immediately to redisplay, it does
 not change how Emacs decides which parts of its frame(s) to redisplay.
 By contrast, the following function adds certain windows to the
@@ -117,6 +112,19 @@ This function does not do a redisplay immediately; Emacs 
does that as
 it waits for input, or when the function @code{redisplay} is called.
 @end defun
 
address@hidden pre-redisplay-function
+A function run just before redisplay.  It is called with one argument,
+the set of windows to be redisplayed.  The set can be @code{nil},
+meaning only the selected window, or @code{t}, meaning all the
+windows.
address@hidden defvar
+
address@hidden pre-redisplay-functions
+This hook is run just before redisplay.  It is called once in each
+window that is about to be redisplayed, with @code{current-buffer} set
+to the buffer displayed in that window.
address@hidden defvar
+
 @node Truncation
 @section Truncation
 @cindex line wrapping
diff --git a/doc/lispref/hooks.texi b/doc/lispref/hooks.texi
index b8f761d..1027aa0 100644
--- a/doc/lispref/hooks.texi
+++ b/doc/lispref/hooks.texi
@@ -180,16 +180,6 @@ Hook run when about to switch windows with a mouse command.
 @item mouse-position-function
 @xref{Mouse Position}.
 
address@hidden post-command-hook
address@hidden pre-command-hook
address@hidden Overview}.
-
address@hidden post-gc-hook
address@hidden Collection}.
-
address@hidden post-self-insert-hook
address@hidden and Minor Modes}.
-
 @item prefix-command-echo-keystrokes-functions
 @vindex prefix-command-echo-keystrokes-functions
 An abnormal hook run by prefix commands (such as @kbd{C-u}) which
@@ -206,6 +196,20 @@ the current prefix command state to the next command.  For 
example,
 @kbd{C-u} needs to pass the state to the next command when the user
 types @kbd{C-u -} or follows @kbd{C-u} with a digit.
 
address@hidden pre-redisplay-functions
+Hook run in each window just before redisplaying it.  @xref{Forcing
+Redisplay}.
+
address@hidden post-command-hook
address@hidden pre-command-hook
address@hidden Overview}.
+
address@hidden post-gc-hook
address@hidden Collection}.
+
address@hidden post-self-insert-hook
address@hidden and Minor Modes}.
+
 @ignore
 @item prog-mode-hook
 @itemx special-mode-hook
diff --git a/etc/NEWS b/etc/NEWS
index 076835c..c51136f 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1349,7 +1349,9 @@ file byte offsets, given the file's encoding.
 ** The default value of `load-read-function' is now `read'.
 Previously, the default value of `nil' implied using `read'.
 
-** New hook `pre-redisplay-functions', a bit easier to use than 
pre-redisplay-function.
++++
+** New hook `pre-redisplay-functions'.
+It is a bit easier to use than `pre-redisplay-function'.
 
 ** The second arg of `looking-back' should always be provided explicitly.