GNU bug report logs - #1010
23.0.60; call-interactively doc

Previous Next

Full log

Message #5 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <emacs-pretest-bug <at> gnu.org>
Subject: 23.0.60; call-interactively doc
Date: Sat, 20 Sep 2008 08:23:19 -0700

The doc for `call-interactively', both Elisp manual and doc string,
could perhaps be improved slightly by changing "reading args" to
"providing args".
 
It's still good to say, in a separate sentence, that this might entail
reading, depending on the `interactive' spec for the individual
arguments. The point is that "calling interactively" does not
necessarily involve anything interactive (input from the user). It
just calls the command providing arguments as determined by the
`interactive' spec, which _might_ require reading user input.
 
In the Elisp manual, a simple example might illustrate what
`call-interactively' is typically used for.
 
This report is prompted by a question on help-gnu-emacs from someone
whose English skills were limited. People helped by suggesting that
the OP read node Interactive Call in the Elisp manual and use
`call-interactively' in his code, but the OP still misunderstood. 
 
His impression was that that would require him to input arguments
interactively, which was not necessarily the case: (interactive
"p\nd\nd"). He was looking, he said, for a way to call a command so
that the command itself figured out the argument values it
needed. What he meant was exactly what `call-interactively' does, but
he didn't grasp the connection even after the suggestion and reading
the doc.
 
I think changing "reading args" to "providing args" would go a long
way toward removing some of this confusion. `interactive' does not
just read args input by the user.
 
 
 
In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600)
 of 2008-09-03 on LENNART-69DE564
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include
-fno-crossjumping'
 

Previous Next

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