From: Eli Zaretskii <eliz@gnu.org>
Date: Mon, 21 Feb 2022 17:01:14 +0000 (+0200)
Subject: Revert "Remove PROBLEMS section on double-buffering"
X-Git-Tag: emacs-29.0.90~2178
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=ce04647d4d19916a25f40615d7bf54539f92c222;p=emacs.git

Revert "Remove PROBLEMS section on double-buffering"

This reverts commit 366b2bc757d011f96693bd219877c5aa42fa3359.

We cannot be sure this problem is no longer relevant, since
its root cause was in software we don't control, and cannot
tell whether any of the versions where that problem happened
are still out in the wild.
---

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index f95564454cb..4e4ec6d353d 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -574,6 +574,21 @@ For example, simply moving through a file that contains hundreds of
 thousands of characters per line is slow, and consumes a lot of CPU.
 This is a known limitation of Emacs with no solution at this time.
 
+*** Display artifacts on GUI frames on X-based systems.
+
+This is known to be caused by using double-buffering (which is enabled
+by default in Emacs 26 and later).  The artifacts typically appear
+after commands that cause Emacs to scroll the display.
+
+You can disable double-buffering by evaluating the following form:
+
+  (modify-all-frames-parameters '((inhibit-double-buffering . t)))
+
+To make this permanent, add it to your ~/.emacs init file.
+
+Note that disabling double-buffering will cause flickering of the
+display in some situations.
+
 *** Self-documentation messages are garbled.
 
 This means that the file 'etc/DOC' doesn't properly correspond