master b504faf003c: Improve documentation of inhibit-double-buffering

[Po Lu]

branch: master
commit b504faf003c507b79cdc7de5109f0f38e817f139
Author: Po Lu <luangruo@yahoo.com>
Commit: Po Lu <luangruo@yahoo.com>

    Improve documentation of inhibit-double-buffering
    
    * doc/lispref/frames.texi (Management Parameters): Reword joke
    and mention the precise circumstances where
    inhibit-double-double-buffering is useful.
---
 doc/lispref/frames.texi | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 5d6e1809286..75bc4de4f61 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -2219,8 +2219,10 @@ resource must also be set to the string 
@code{"extended"}.
 @item inhibit-double-buffering
 If non-@code{nil}, the frame is drawn to the screen without double
 buffering.  Emacs normally attempts to use double buffering, where
-available, to reduce flicker.  Set this property if you experience
-display bugs or pine for that retro, flicker-y feeling.
+available, to reduce flicker; nevertheless, this parameter is provided
+for circumstances where double-buffering induces display corruption,
+and for those eccentrics wistful for the immemorial flicker that once
+beset Emacs.
 
 @vindex skip-taskbar@r{, a frame parameter}
 @item skip-taskbar