From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Magne Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#1010: 23.0.60; call-interactively doc Date: Thu, 07 Jul 2011 18:57:25 +0200 Message-ID: References: <007801c91b34$cfe46170$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1310060811 23760 80.91.229.12 (7 Jul 2011 17:46:51 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 7 Jul 2011 17:46:51 +0000 (UTC) Cc: 1010@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jul 07 19:46:47 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Qesev-0003rT-Mn for geb-bug-gnu-emacs@m.gmane.org; Thu, 07 Jul 2011 19:46:41 +0200 Original-Received: from localhost ([::1]:43298 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qeseu-0007Os-J9 for geb-bug-gnu-emacs@m.gmane.org; Thu, 07 Jul 2011 13:46:40 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:37103) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qerwm-0003bs-Pq for bug-gnu-emacs@gnu.org; Thu, 07 Jul 2011 13:01:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qerwk-0001da-Ow for bug-gnu-emacs@gnu.org; Thu, 07 Jul 2011 13:01:04 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:49222) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qerwk-0001dJ-6W for bug-gnu-emacs@gnu.org; Thu, 07 Jul 2011 13:01:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qerwj-0005qh-Jv; Thu, 07 Jul 2011 13:01:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 07 Jul 2011 17:01:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 1010 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 1010-submit@debbugs.gnu.org id=B1010.131005801920586 (code B ref 1010); Thu, 07 Jul 2011 17:01:01 +0000 Original-Received: (at 1010) by debbugs.gnu.org; 7 Jul 2011 17:00:19 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qerw2-0005Lv-K3 for submit@debbugs.gnu.org; Thu, 07 Jul 2011 13:00:18 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qerw0-0005BN-Vv for 1010@debbugs.gnu.org; Thu, 07 Jul 2011 13:00:17 -0400 Original-Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1Qervp-00064g-J0; Thu, 07 Jul 2011 19:00:05 +0200 In-Reply-To: <007801c91b34$cfe46170$0200a8c0@us.oracle.com> (Drew Adams's message of "Sat, 20 Sep 2008 08:23:19 -0700") User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: The Smiths's _The World Won't Listen_: "That joke isn't funny anymore" X-Hashcash: 1:23:110707:1010@debbugs.gnu.org::yOLP5w7J4SawKH2u:00000000000000000000000000000000000000001N6eF X-Hashcash: 1:23:110707:drew.adams@oracle.com::aIOQ0/1+3Y94Ao2G:0000000000000000000000000000000000000001UKFa X-MailScanner-ID: 1Qervp-00064g-J0 MailScanner-NULL-Check: 1310662805.67618@7DkdAXMg7LhvoAgvMJD55Q X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Thu, 07 Jul 2011 13:01:01 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:48176 Archived-At: "Drew Adams" writes: > The doc for `call-interactively', both Elisp manual and doc string, > could perhaps be improved slightly by changing "reading args" to > "providing args". Yes, I think you're right. In case of the "r" spec, for instance, there's little "reading" going on, but it does provide the point/mark to the function. I'm guessing the intention was to say that it would prompt the user for stuff, if the interactive spec is a prompting one. I've now made the change. > 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. I've added an example to the manual. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/