master 1ea434b 1/2: Document redisplay-skip-fontification-on-input

[Lars Ingebrigtsen]

branch: master
commit 1ea434b19161949936b57458d10edf9241893a43
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Document redisplay-skip-fontification-on-input
    
    * doc/emacs/display.texi (Scrolling): Mention
    redisplay-skip-fontification-on-input.
---
 doc/emacs/display.texi | 8 ++++++++
 etc/NEWS               | 1 +
 2 files changed, 9 insertions(+)

diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index 996c5a6..7ea7546 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -150,6 +150,14 @@ gives you less jerky scrolling when you hold down 
@kbd{C-v}, but the
 window contents after any action which scrolls into a fresh portion of
 the buffer will be momentarily unfontified.
 
+@vindex redisplay-skip-fontification-on-input
+Finally, a third alternative to these variables is
+@code{redisplay-skip-fontification-on-input}.  If this variable is
+non-@code{nil}, skip some fontifications is there's input pending.
+This usually does not affect the display because redisplay is
+completely skipped anyway if input was pending, but it can make
+scrolling smoother by avoiding unnecessary fontification.
+
 @vindex scroll-up
 @vindex scroll-down
 @findex scroll-up-line
diff --git a/etc/NEWS b/etc/NEWS
index 3298212..1ee8588 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -745,6 +745,7 @@ Applies to headings of shortdoc sections.
 *** New face 'separator-line'.
 This is used by 'make-separator-line' (see below).
 
++++
 *** 'redisplay-skip-fontification-on-input' helps Emacs keep up with fast 
input.
 This is another attempt to solve the problem of handling high key repeat rate
 and other "slow scrolling" situations.  It is hoped it behaves better