From: Chong Yidong <cyd@gnu.org>
Date: Fri, 27 Jan 2012 08:35:51 +0000 (+0800)
Subject: Minor clarification in Lisp manual about pre/post-command-hook.
X-Git-Tag: emacs-pretest-24.0.93~52
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=9f40220d8e86c83567e168b93242f0a28c2675e5;p=emacs.git

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 89174f3ca0e..3e4946f261e 100644
--- 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 4a0bc8a6b24..3d2b813b592 100644
--- 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