From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#1010: 23.0.60; call-interactively doc Date: Sat, 20 Sep 2008 08:23:19 -0700 Message-ID: <007801c91b34$cfe46170$0200a8c0@us.oracle.com> Reply-To: Drew Adams , 1010@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1221925676 12277 80.91.229.12 (20 Sep 2008 15:47:56 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 20 Sep 2008 15:47:56 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Sep 20 17:48:53 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1Kh4hX-0002H1-QD for geb-bug-gnu-emacs@m.gmane.org; Sat, 20 Sep 2008 17:48:52 +0200 Original-Received: from localhost ([127.0.0.1]:37181 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Kh4gW-0001M2-4I for geb-bug-gnu-emacs@m.gmane.org; Sat, 20 Sep 2008 11:47:48 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Kh4gQ-0001Lw-8e for bug-gnu-emacs@gnu.org; Sat, 20 Sep 2008 11:47:42 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Kh4gN-0001La-9R for bug-gnu-emacs@gnu.org; Sat, 20 Sep 2008 11:47:40 -0400 Original-Received: from [199.232.76.173] (port=59380 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Kh4gN-0001LS-2X for bug-gnu-emacs@gnu.org; Sat, 20 Sep 2008 11:47:39 -0400 Original-Received: from [138.23.92.77] (port=54886 helo=rzlab.ucr.edu) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Kh4gM-0001fE-Ae for bug-gnu-emacs@gnu.org; Sat, 20 Sep 2008 11:47:38 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m8KFlZxP015597; Sat, 20 Sep 2008 08:47:36 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id m8KFU4mV009075; Sat, 20 Sep 2008 08:30:04 -0700 X-Loop: don@donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Sat, 20 Sep 2008 15:30:04 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 1010 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12219242067080 (code B ref -1); Sat, 20 Sep 2008 15:30:04 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 20 Sep 2008 15:23:26 +0000 Original-Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id m8KFNMHV007074 for ; Sat, 20 Sep 2008 08:23:24 -0700 Original-Received: from mail.gnu.org ([199.232.76.166]:44645 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1Kh4Gw-0002yt-Ds for emacs-pretest-bug@gnu.org; Sat, 20 Sep 2008 11:21:22 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1Kh4Im-0006Io-AN for emacs-pretest-bug@gnu.org; Sat, 20 Sep 2008 11:23:21 -0400 Original-Received: from rgminet01.oracle.com ([148.87.113.118]:20625) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Kh4Il-0006IR-T4 for emacs-pretest-bug@gnu.org; Sat, 20 Sep 2008 11:23:16 -0400 Original-Received: from agmgw2.us.oracle.com (agmgw2.us.oracle.com [152.68.180.213]) by rgminet01.oracle.com (Switch-3.2.4/Switch-3.1.6) with ESMTP id m8KFNCjR025512 for ; Sat, 20 Sep 2008 09:23:12 -0600 Original-Received: from acsmt701.oracle.com (acsmt701.oracle.com [141.146.40.71]) by agmgw2.us.oracle.com (Switch-3.2.0/Switch-3.2.0) with ESMTP id m8KFNB06008308 for ; Sat, 20 Sep 2008 09:23:12 -0600 Original-Received: from dradamslap1 (/24.23.165.218) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 20 Sep 2008 08:23:11 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AckbNM+Asa67zFFFT3mEmzIhrfGQKA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.4-2.6 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Sat, 20 Sep 2008 11:47:40 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:20674 gmane.emacs.pretest.bugs:23073 Archived-At: 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'