From: Po Lu <luangruo@yahoo.com>
Date: Tue, 10 Oct 2023 08:58:21 +0000 (+0800)
Subject: Improve documentation of inhibit-double-buffering
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=b504faf003c507b79cdc7de5109f0f38e817f139;p=emacs.git

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.
---

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