Minor clarification in Lisp manual about pre/post-command-hook.

* doc/lispref/commands.texi (Command Overview): Minor clarification (Bug#10384).

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index 89174f3ca0ee0e86d89f72356ff00fc2ce685f5b..3e4946f261e59ead75e63803b0e4330495f79c4b 100644 (file)
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,7 @@
+2012-01-27  Chong Yidong  <cyd@gnu.org>
+
+       * commands.texi (Command Overview): Minor clarification (Bug#10384).
+
 2012-01-26  Chong Yidong  <cyd@gnu.org>
 
        * searching.texi (String Search): Document negative repeat count

diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index 4a0bc8a6b2443e31ffa9c0b10635464485d2f94f..3d2b813b592a4cbcf6d08098b83a8cdc50443ca6 100644 (file)
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -75,18 +75,22 @@ function yourself (@pxref{Keyboard Macros}).
 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.
-@xref{Command 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,
-@code{this-command} refers to the command that just ran, and
-@code{last-command} 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
+@code{nil}).
 @end defvar
 
   Quitting is suppressed while running @code{pre-command-hook} and