From: Manuel Giraud <manuel@ledu-giraud.fr>
Date: Thu, 25 Jul 2024 11:57:59 +0000 (+0200)
Subject: Document unsupported color Emoji on OpenBSD
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=35bcf5173edbae51263ea6741e521d7610961872;p=emacs.git

Document unsupported color Emoji on OpenBSD

Bug#72268

* etc/PROBLEMS (Runtime problems related to font handling):
Document unsupported color Emoji on OpenBSD.

(cherry picked from commit d787817076e26d28163073847f01fd3587106355)
---

diff --git a/etc/PROBLEMS b/etc/PROBLEMS
index c1ad8321fa6..5f9d09b695d 100644
--- a/etc/PROBLEMS
+++ b/etc/PROBLEMS
@@ -1274,6 +1274,27 @@ Emacs will select some other font instead.
 The only workaround is not to choose such font variants as the default
 font when running Emacs on MS-Windows.
 
+** On OpenBSD, color Emoji are not supported by default.
+
+The system's FreeType library is not built with libpng support, so it
+can't display color emoji.  This is due to the fact that, on OpenBSD,
+libpng is provided through ports and that a base component cannot depend
+on that.
+
+However, you can add support for PNG in the system's FreeType library by
+following those steps:
+	1. Install the 'png' package.
+	2. Read the release(8) man page for how to get Xenocara sources.
+	3. Patch the file
+	   "/usr/xenocara/lib/freetype/include/freetype/config/ftoption.h"
+	   by uncommenting the "#define FT_CONFIG_OPTION_USE_PNG" line.
+	4. Patch the file "/usr/xenocara/lib/freetype/Makefile" by
+	   appending "-L/usr/local/lib -lpng" to LDADD and appending
+	   "-I/usr/local/include" to CPPFLAGS.
+	5. Build and install Xenocara (also, see release(8)).
+
+Note that this support will be gone after each OpenBSD's system upgrade.
+
 * Internationalization problems
 
 ** M-{ does not work on a Spanish PC keyboard.