From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 9 May 2024 06:05:22 +0000 (+0300)
Subject: ; * etc/PROBLEMS: Document macOS problems with Emacs.clr (bug#70836).
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=42f8526e22e23db2d5b19a410fffe15bd5af8dfe;p=emacs.git

; * etc/PROBLEMS: Document macOS problems with Emacs.clr (bug#70836).

(cherry picked from commit a7d247be90c6030a0ffebc2d8280206128b0e87c)
---

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index 2922f5a384c..77856087367 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -3402,7 +3402,7 @@ for further discussion.
 
 * Runtime problems specific to macOS
 
-** Error message when opening Emacs on macOS
+** Error message about malicious software when opening Emacs on macOS
 
 When opening Emacs, you may see an error message saying something like
 this:
@@ -3419,6 +3419,22 @@ the Emacs app icon, and then choose Open.  This adds a security
 exception for Emacs and from now on you should be able to open it by
 double-clicking on its icon, like any other app.
 
+** Error message about color list unarchiver when starting Emacs on macOS
+
+The error message looks like this:
+
+  Failed to initialize color list unarchiver:
+  Error Domain=NSCocoaErrorDomain Code=4864 "*** -[NSKeyedUnarchiver
+  _initForReadingFromData:error:throwLegacyExceptions:]: non-keyed archive cannot be decoded by NSKeyedUnarchiver"
+  UserInfo={NSDebugDescription=*** -[NSKeyedUnarchiver
+  _initForReadingFromData:error:throwLegacyExceptions:]: non-keyed archive cannot be decoded by NSKeyedUnarchiver}
+
+After showing this message, Emacs usually works normally.
+
+The usual reason for this is that the color file,
+~/Library/Colors/Emacs.clr, is stale or corrupted.  The solution is to
+delete that file and restart Emacs.
+
 ** macOS doesn't come with libxpm, so only XPM3 is supported.
 
 Libxpm is available for macOS as part of the XQuartz project.