(Command Loop Info): Advise against changing

most variables described here.  Explain new variable
last-repeatable-command.

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index af9f622ca87237805111ddc6badd61cb20322fcb..08a8dc4b0a7c69a91c5c92a503699c16522ae9eb 100644 (file)
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,9 @@
+2007-08-30  Martin Rudalics  <rudalics@gmx.at>
+
+       * commands.texi (Command Loop Info): Advise against changing
+       most variables described here.  Explain new variable
+       last-repeatable-command.
+
 2007-08-27  Richard Stallman  <rms@gnu.org>
 
        * windows.texi (Window Configurations): Clarify what

diff --git a/lispref/commands.texi b/lispref/commands.texi
index 8354346c35e386dcc4cdde41133aca1d913e4a0a..b6a6929ad6bbbb658c147d49a4f1fc5a6a62e82b 100644 (file)
--- a/lispref/commands.texi
+++ b/lispref/commands.texi
@@ -716,7 +716,9 @@ caller to ``pretend'' that the function was called interactively.
 @section Information from the Command Loop
 
 The editor command loop sets several Lisp variables to keep status
-records for itself and for commands that are run.
+records for itself and for commands that are run.  With the exception of
+@code{this-command} and @code{last-command} it's generally a bad idea to
+change any of these variables in a Lisp program.
 
 @defvar last-command
 This variable records the name of the previous command executed by the
@@ -736,6 +738,12 @@ This variable is set up by Emacs just like @code{last-command},
 but never altered by Lisp programs.
 @end defvar
 
+@defvar last-repeatable-command
+This variable stores the most recently executed command that was not
+part of an input event.  This is the command @code{repeat} will try to
+repeat, @xref{Repeating,,, emacs, The GNU Emacs Manual}.
+@end defvar
+
 @defvar this-command
 @cindex current command
 This variable records the name of the command now being executed by