GNU bug report logs - #8813
24.0.50; `@' in doc string of `interactive'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 8813 in the body.
You can then email your comments to 8813 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 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 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'
 

Message #12 received at 8813 <at> debbugs.gnu.org (full text, mbox):

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 8813 <at> debbugs.gnu.org
Subject: Re: 24.0.50; `@' in doc string of `interactive'
Date: Mon, 04 Jul 2011 01:22:10 +0200

"Drew Adams" <drew.adams <at> 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/

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.