From: Gerd Moellmann <gerd@gnu.org>
Date: Wed, 5 Jul 2000 11:39:10 +0000 (+0000)
Subject: Add some comments.
X-Git-Tag: emacs-pretest-21.0.90~2984
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=827503c6456f63af54b594f7d84c0d963aed3d90;p=emacs.git

Add some comments.
---

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					\