[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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

From: Drew Adams
Subject: bug#8813: 24.0.50; `@' in doc string of `interactive'
Date: Tue, 7 Jun 2011 09:01:06 -0700

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 (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

reply via email to

[Prev in Thread] Current Thread [Next in Thread]