* callint.c (Finteractive): Clarify the meaning of "@".

Fixes: debbugs:8813

diff --git a/src/ChangeLog b/src/ChangeLog
index b77759527e730ce9ad4c0dcf30416163b720ac80..5f3aa60dfd6e040a3657b72213501d38160c4392 100644 (file)
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,3 +1,7 @@
+2011-07-03  Lars Magne Ingebrigtsen  <larsi@gnus.org>
+
+       * callint.c (Finteractive): Clarify the meaning of "@" (bug#8813).
+
 2011-07-03  Chong Yidong  <cyd@stupidchicken.com>
 
        * xfaces.c (Finternal_merge_in_global_face): Modify the foreground

diff --git a/src/callint.c b/src/callint.c
index 4d0a2a079213c12e2f0861c41d1f4ca6d8095e1d..1371b403e4bae04907b7068f2be7b8e620f07054 100644 (file)
--- a/src/callint.c
+++ b/src/callint.c
@@ -105,9 +105,10 @@ Z -- Coding system, nil if no prefix arg.
 
 In addition, if the string begins with `*', an error is signaled if
   the buffer is read-only.
-If the string begins with `@', Emacs searches the key sequence which
- invoked the command for its first mouse click (or any other event
- which specifies a window).
+If `@' appears at the beginning of the string, and if the key sequence
+ used to invoke the command includes any mouse events, then the window
+ associated with the first of those events is selected before the
+ command is run.
 If the string begins with `^' and `shift-select-mode' is non-nil,
  Emacs first calls the function `handle-shift-selection'.
 You may use `@', `*', and `^' together.  They are processed in the