(Command Loop Info): Advise against changing

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

2 files changed, 15 insertions, 1 deletions

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index af9f622ca87..08a8dc4b0a7 100644
--- 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 8354346c35e..b6a6929ad6b 100644
--- 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