emacs-27 cf57663: Mention jit-lock deferred as an alternative to fast-but-imprecise-scrolling

[Alan Mackenzie]

branch: emacs-27
commit cf57663f2ab80814d17eee0f21b498262f933d89
Author: Alan Mackenzie <address@hidden>
Commit: Alan Mackenzie <address@hidden>

    Mention jit-lock deferred as an alternative to fast-but-imprecise-scrolling
    
    * doc/emacs/display.texi (Scrolling): Add a paragraph on using jit-lock
    deferred fontification as a way of obviating Emacs hanging after
    auto-repeated scrolling.
---
 doc/emacs/display.texi | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index 8444aef..4273357 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -141,6 +141,15 @@ default face.  This can cause Emacs to scroll to somewhat 
wrong buffer
 positions when the faces in use are not all the same size, even with
 single (i.e., without auto-repeat) scrolling operations.
 
+@vindex jit-lock-defer-time
+As an alternative to setting @code{fast-but-imprecise-scrolling} you
+might prefer to enable jit-lock deferred fontification (@pxref{Font
+Lock}).  To do this, customize @code{jit-lock-defer-time} to a small
+positive number such as 0.25, or even 0.1 if you type quickly.  This
+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 scroll-up
 @vindex scroll-down
 @findex scroll-up-line