bug#8813: 24.0.50; `@' in doc string of `interactive'

bug#8813: 24.0.50; `@' in doc string of `interactive'

[Drew Adams]

The explanation of `@' at the beginning of a doc string is fine in the
Emacs Lisp manual.  But in the doc string of `interactive' it is
meaningless and useless.
 
From the doc string:
 
 "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)."
 
What does that mean?  Why is Emacs searching the key sequence?  What
does Emacs do with the searched key sequence?  What does it do when it
finds the first mouse click or any other event that specifies a window?
What is going on here?  What for?
 
Please change this text to say what is said in the manual (using similar
or different wording):
 
     "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."
 
In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-06-06 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt --cflags
-Ic:/build/include'
 

bug#8813: 24.0.50; `@' in doc string of `interactive'

[Lars Magne Ingebrigtsen]

"Drew Adams" <drew.adams@oracle.com> writes:

> Please change this text to say what is said in the manual (using similar
> or different wording):
>
>      "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."

Ok; fixed.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/