From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 7 Oct 2021 16:27:49 +0000 (+0300)
Subject: ; * src/composite.h (LGSTRING_FONT): Add comment about its role.
X-Git-Tag: emacs-28.0.90~366
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7ae70054aa208da5d281ad8f6887d818d98f02d6;p=emacs.git

; * src/composite.h (LGSTRING_FONT): Add comment about its role.
---

diff --git a/src/composite.h b/src/composite.h
index 67e87201bf2..945f2612915 100644
--- a/src/composite.h
+++ b/src/composite.h
@@ -254,6 +254,10 @@ composition_valid_p (ptrdiff_t start, ptrdiff_t end, Lisp_Object prop)
 #define LGSTRING_HEADER(lgs) AREF (lgs, 0)
 #define LGSTRING_SET_HEADER(lgs, header) ASET (lgs, 0, header)
 
+/* LGSTRING_FONT retrieves the font used for LGSTRING, if we are going
+   to display it on a GUI frame.  On text-mode frames, that slot
+   stores the coding-system that should be used to write output to the
+   frame's terminal.  */
 #define LGSTRING_FONT(lgs) AREF (LGSTRING_HEADER (lgs), 0)
 #define LGSTRING_CHAR(lgs, i) AREF (LGSTRING_HEADER (lgs), (i) + 1)
 #define LGSTRING_CHAR_LEN(lgs) (ASIZE (LGSTRING_HEADER (lgs)) - 1)