Tiny clarification for markers.texi

* doc/lispref/markers.texi (The Mark):
Tiny clarification re command loop and activate-mark-hook.

2 files changed, 13 insertions, 4 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index d2bda41eb03..42ec24fac5f 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,8 +1,9 @@
 2012-03-07  Glenn Morris  <rgm@gnu.org>
 
-        * markers.texi (The Region):
-        Briefly mention use-empty-active-region and region-active-p.
+        * markers.texi (The Region): Briefly mention use-empty-active-region
+        and region-active-p.
         (Overview of Markers): Reword garbage collection, add cross-ref.
+        (The Mark): Tiny clarification re command loop and activate-mark-hook.
 
 2012-03-07  Chong Yidong  <cyd@gnu.org>
 
diff --git a/doc/lispref/markers.texi b/doc/lispref/markers.texi
index b199dba979a..25a9fc88fc5 100644
--- a/doc/lispref/markers.texi
+++ b/doc/lispref/markers.texi
@@ -595,8 +595,16 @@ the function @code{use-region-p} for that (@pxref{The Region}).
 @defvarx deactivate-mark-hook
 These normal hooks are run, respectively, when the mark becomes active
 and when it becomes inactive.  The hook @code{activate-mark-hook} is
-also run at the end of a command if the mark is active and it is
-possible that the region may have changed.
+also run at the end of the command loop if the mark is active and it
+is possible that the region may have changed.
+@ignore
+This piece of command_loop_1, run unless deactivating the mark:
+  if (current_buffer != prev_buffer || MODIFF != prev_modiff)
+    {
+      Lisp_Object hook = intern ("activate-mark-hook");
+      Frun_hooks (1, &hook);
+    }
+@end ignore
 @end defvar
 
 @defun handle-shift-selection