From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 7 Sep 2001 15:54:52 +0000 (+0000)
Subject: More commentary about the role of kbd_macro_end.
X-Git-Tag: emacs-pretest-21.0.106~197
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=705644780d4ab9a47dad5e6ecc006600aca3b910;p=emacs.git

More commentary about the role of kbd_macro_end.
---

diff --git a/src/keyboard.h b/src/keyboard.h
index 61a52460809..14dad977cd3 100644
--- a/src/keyboard.h
+++ b/src/keyboard.h
@@ -104,7 +104,10 @@ struct kboard
        ends before this.  This is not the same as kbd_macro_ptr, because
        we advance this to kbd_macro_ptr when a key's command is complete.
        This way, the keystrokes for "end-kbd-macro" are not included in the
-       macro.  */
+       macro.  This also allows us to throw away the events added to the
+       macro by the last command: all the events between kbd_macro_end and
+       kbd_macro_ptr belong to the last command; see
+       cancel-kbd-macro-events.  */
     Lisp_Object *kbd_macro_end;
 
     /* Allocated size of kbd_macro_buffer.  */