From 827503c6456f63af54b594f7d84c0d963aed3d90 Mon Sep 17 00:00:00 2001
From: Gerd Moellmann <gerd@gnu.org>
Date: Wed, 5 Jul 2000 11:39:10 +0000
Subject: [PATCH] Add some comments.

---
 src/dispextern.h | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/src/dispextern.h b/src/dispextern.h
index 4d81e9e4e27..a50d30877e4 100644
--- a/src/dispextern.h
+++ b/src/dispextern.h
@@ -224,7 +224,13 @@ enum glyph_type
 };
 
 
-/* Glyphs.  */
+/* Glyphs.
+
+   Be extra careful when changing this structure!  Esp. make sure that
+   functions producing glyphs, like x_append_glyph, fill ALL of the
+   glyph structure, and that GLYPH_EQUAL_P compares all
+   display-relevant members of glyphs (not to imply that these are the
+   only things to check when you add a member).  */
 
 struct glyph
 {
@@ -324,7 +330,7 @@ struct glyph
 #define CHAR_GLYPH_SPACE_P(GLYPH) \
      (GLYPH_FROM_CHAR_GLYPH ((GLYPH)) == SPACEGLYPH)
 
-/* Are glyphs *X and *Y equal?  */
+/* Are glyphs *X and *Y displayed equal?  */
      
 #define GLYPH_EQUAL_P(X, Y)					\
      ((X)->type == (Y)->type					\
-- 
2.39.2