[Emacs-diffs] /srv/bzr/emacs/trunk r106949: Minor clarification in Lisp manual about pre/post-command-hook.

[Chong Yidong]

------------------------------------------------------------
revno: 106949
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Fri 2012-01-27 16:35:51 +0800
message:
  Minor clarification in Lisp manual about pre/post-command-hook.
  
  * doc/lispref/commands.texi (Command Overview): Minor clarification 
(Bug#10384).
modified:
  doc/lispref/ChangeLog
  doc/lispref/commands.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-01-26 15:48:27 +0000
+++ b/doc/lispref/ChangeLog     2012-01-27 08:35:51 +0000
@@ -1,3 +1,7 @@
+2012-01-27  Chong Yidong  <address@hidden>
+
+       * commands.texi (Command Overview): Minor clarification (Bug#10384).
+
 2012-01-26  Chong Yidong  <address@hidden>
 
        * searching.texi (String Search): Document negative repeat count

=== modified file 'doc/lispref/commands.texi'
--- a/doc/lispref/commands.texi 2012-01-19 07:21:25 +0000
+++ b/doc/lispref/commands.texi 2012-01-27 08:35:51 +0000
@@ -75,18 +75,22 @@
 character causes @dfn{quitting} (@pxref{Quitting}).
 
 @defvar pre-command-hook
-The editor command loop runs this normal hook before each command.  At
-that time, @code{this-command} contains the command that is about to
-run, and @code{last-command} describes the previous command.
address@hidden Loop Info}.
+This normal hook is run by the editor command loop before it executes
+each command.  At that time, @code{this-command} contains the command
+that is about to run, and @code{last-command} describes the previous
+command.  @xref{Command Loop Info}.
 @end defvar
 
 @defvar post-command-hook
-The editor command loop runs this normal hook after each command
-(including commands terminated prematurely by quitting or by errors),
-and also when the command loop is first entered.  At that time,
address@hidden refers to the command that just ran, and
address@hidden refers to the command before that.
+This normal hook is run by the editor command loop after it executes
+each command (including commands terminated prematurely by quitting or
+by errors).  At that time, @code{this-command} refers to the command
+that just ran, and @code{last-command} refers to the command before
+that.
+
+This hook is also run when Emacs first enters the command loop (at
+which point @code{this-command} and @code{last-command} are both
address@hidden).
 @end defvar
 
   Quitting is suppressed while running @code{pre-command-hook} and