# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1017847179 0
# Node ID 65c0edf0d53cb81f1ad5bef0c5aa9809d89d5acb
# Parent  aefe458553096b48bc9e73bfa9acc3dd27b89600
Comment change.

diff -r aefe45855309 -r 65c0edf0d53c src/process.c
--- a/src/process.c	Wed Apr 03 14:47:16 2002 +0000
+++ b/src/process.c	Wed Apr 03 15:19:39 2002 +0000
@@ -5788,7 +5788,8 @@
 
 /* Report all recent events of a change in process status
    (either run the sentinel or output a message).
-   This is done while Emacs is waiting for keyboard input.  */
+   This is usually done while Emacs is waiting for keyboard input
+   but can be done at other times.  */
 
 void
 status_notify ()
diff -r aefe45855309 -r 65c0edf0d53c src/term.c
--- a/src/term.c	Wed Apr 03 14:47:16 2002 +0000
+++ b/src/term.c	Wed Apr 03 15:19:39 2002 +0000
@@ -1637,11 +1637,23 @@
 }
 
 
-/* Produce glyphs for the display element described by IT.  The
-   function fills output fields of IT with pixel information like the
-   pixel width and height of a character, and maybe produces glyphs at
+/* Produce glyphs for the display element described by IT.  *IT
+   specifies what we want to produce a glyph for (character, image, ...),
+   and where in the glyph matrix we currently are (glyph row and hpos).
+   produce_glyphs fills in output fields of *IT with information such as the
+   pixel width and height of a character, and maybe output actual glyphs at
    the same time if IT->glyph_row is non-null.  See the explanation of
-   struct display_iterator in dispextern.h for an overview.  */
+   struct display_iterator in dispextern.h for an overview.
+
+   produce_glyphs also stores the result of glyph width, ascent
+   etc. computations in *IT.
+
+   IT->glyph_row may be null, in which case produce_glyphs does not
+   actually fill in the glyphs.  This is used in the move_* functions
+   in xdisp.c for text width and height computations.
+
+   Callers usually don't call produce_glyphs directly;
+   instead they use the macro PRODUCE_GLYPHS.  */
 
 void 
 produce_glyphs (it)