From 25fcc9b8333ec68a0e9c094aefbb9cf080e70889 Mon Sep 17 00:00:00 2001
From: Robert Pluim <rpluim@gmail.com>
Date: Fri, 19 Apr 2024 15:16:34 +0200
Subject: [PATCH] Improve 'set-fontset-font' documentation

* doc/emacs/mule.texi (Modifying Fontsets): Add an 'emoji' example.

(cherry picked from commit c38d5cc3b280394bbbb9b579cbc82455077ac9b1)
---
 doc/emacs/mule.texi | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/emacs/mule.texi b/doc/emacs/mule.texi
index 55dd74c48a3..8b16c661a7e 100644
--- a/doc/emacs/mule.texi
+++ b/doc/emacs/mule.texi
@@ -1657,6 +1657,16 @@ used.  Some examples are:
                   'han (font-spec :registry "big5")
                   nil 'prepend)
 
+@cindex emoji font
+;; Use "Noto Color Emoji" for the emoji script (this is the default).
+(set-fontset-font "fontset-default" 'emoji
+                  '("Noto Color Emoji" . "iso10646-1")
+                  nil 'prepend)
+
+;; Display the "heart" character using a color font.
+(set-fontset-font "fontset-default"
+                  #x2764 "Noto Color Emoji")
+
 ;; Use MyPrivateFont for the Unicode private use area.
 (set-fontset-font "fontset-default"  '(#xe000 . #xf8ff)
                   "MyPrivateFont")
-- 
2.39.2