src/buffer.h, src/frame.h: Clarify doc of optimization variables.

diff --git a/src/buffer.h b/src/buffer.h
index d461415e036e2203fdd565d11084252d81af64a9..de117eb9c61a15a9a42f1e5f5e86f9bd6b93cffd 100644 (file)
--- a/src/buffer.h
+++ b/src/buffer.h
@@ -847,8 +847,8 @@ struct buffer
   struct region_cache *width_run_cache;
   struct region_cache *bidi_paragraph_cache;
 
-  /* Non-zero means don't use redisplay optimizations for
-     displaying this buffer.  */
+  /* Non-zero means disable redisplay optimizations when rebuilding the glyph
+     matrices (but not when redrawing).  */
   bool_bf prevent_redisplay_optimizations_p : 1;
 
   /* Non-zero whenever the narrowing is changed in this buffer.  */

diff --git a/src/frame.h b/src/frame.h
index 62dc33511b55121dd1fa812c542fe0ab4dc296c8..ff696df9effdb10965988a64381981328ae6998a 100644 (file)
--- a/src/frame.h
+++ b/src/frame.h
@@ -375,7 +375,8 @@ struct frame
      set this directly, use SET_FRAME_ICONIFIED instead.  */
   bool_bf iconified : 1;
 
-  /* True if this frame should be redrawn.  */
+  /* True if this frame should be fully redisplayed.  Disables all
+     optimizations while rebuilding matrices and redrawing.  */
   bool_bf garbaged : 1;
 
   /* False means, if this frame has just one window,