From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 6 Aug 2022 16:19:01 +0000 (+0300)
Subject: * etc/PROBLEMS: Problems with Alacritty and Emoji.  (Bug#56952)
X-Git-Tag: emacs-28.2~63
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7ffcba4213;p=emacs.git

* etc/PROBLEMS: Problems with Alacritty and Emoji.  (Bug#56952)
---

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index c0b44008e92..2a82995c994 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -2170,8 +2170,23 @@ terminals display them as 1-column glyphs.  Again, this causes cursor
 addressing to get out of sync and eventually messes up the display.
 
 One possible workaround for problems caused by character composition
-is to turn off 'auto-composition-mode' on Kitty terminals.
+is to turn off 'auto-composition-mode' on Kitty terminals, e.g. by
+customizing the 'auto-composition-mode' variable to have as value a
+string that the 'tty-type' function returns on those terminals.
 
+*** Display artifacts on the Alacritty text terminal
+
+This terminal is known to cause problems with Emoji sequences: when
+displaying them, the Emacs text-mode frame could show gaps and other
+visual artifacts.
+
+The solution is to disable 'auto-composition-mode' on these
+terminals, for example, like this:
+
+  (setq auto-composition-mode "alacritty")
+
+This disables 'auto-composition-mode' on frames that display on
+terminals of this type.
 
 * Runtime problems specific to individual Unix variants