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

[Eli Zaretskii]

branch: emacs-28
commit 7ffcba4213786569954bbdd9b7d7aa741b5014c9
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    * etc/PROBLEMS: Problems with Alacritty and Emoji.  (Bug#56952)
---
 etc/PROBLEMS | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index c0b44008e9..2a82995c99 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