From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Aaron S. Hawley" Newsgroups: gmane.emacs.bugs Subject: bug#13373: 24.3.50; doc string of `execute-extended-command' is incorrect Date: Mon, 7 Jan 2013 16:27:44 -0500 Message-ID: References: <9C4F75D8489349839D5B5F312F55B023@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: ger.gmane.org 1357594085 13098 80.91.229.3 (7 Jan 2013 21:28:05 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 7 Jan 2013 21:28:05 +0000 (UTC) To: 13373@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 07 22:28:22 2013 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TsKF4-0000nZ-Ah for geb-bug-gnu-emacs@m.gmane.org; Mon, 07 Jan 2013 22:28:22 +0100 Original-Received: from localhost ([::1]:50574 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TsKEo-00049C-Jh for geb-bug-gnu-emacs@m.gmane.org; Mon, 07 Jan 2013 16:28:06 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:36109) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TsKEk-00044g-Ui for bug-gnu-emacs@gnu.org; Mon, 07 Jan 2013 16:28:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TsKEj-0002Ly-SB for bug-gnu-emacs@gnu.org; Mon, 07 Jan 2013 16:28:02 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42397) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TsKEj-0002Lu-N5 for bug-gnu-emacs@gnu.org; Mon, 07 Jan 2013 16:28:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TsKEj-0001Xe-Lf for bug-gnu-emacs@gnu.org; Mon, 07 Jan 2013 16:28:01 -0500 X-Loop: help-debbugs@gnu.org In-Reply-To: <9C4F75D8489349839D5B5F312F55B023@us.oracle.com> Resent-From: "Aaron S. Hawley" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 07 Jan 2013 21:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 13373 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 13373-submit@debbugs.gnu.org id=B13373.13575940735910 (code B ref 13373); Mon, 07 Jan 2013 21:28:01 +0000 Original-Received: (at 13373) by debbugs.gnu.org; 7 Jan 2013 21:27:53 +0000 Original-Received: from localhost ([127.0.0.1]:55638 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TsKEa-0001XG-Aa for submit@debbugs.gnu.org; Mon, 07 Jan 2013 16:27:53 -0500 Original-Received: from mail-qc0-f182.google.com ([209.85.216.182]:55342) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TsKEY-0001X1-K1 for 13373@debbugs.gnu.org; Mon, 07 Jan 2013 16:27:51 -0500 Original-Received: by mail-qc0-f182.google.com with SMTP id k19so13294348qcs.13 for <13373@debbugs.gnu.org>; Mon, 07 Jan 2013 13:27:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:date:message-id:subject:from:to:content-type; bh=hzuPbyCbbvbYPqAXEehonUwmsmn0EcI9bdvG6Yepraw=; b=AapckqLTM2la3I3F114qtnWcvQnCBNK0Z6pskJYuQEbhOcJ9PgB5n/jE4HbzLtjo4l vge9Is+ovOrC2X9ZAmXyEy6csnOmt8E3vr50OPiI7bnkjydzA5/QPk+Vrh+3K4f1jPMT VMNNnfYQga1FwmUcMNsg4o12jQDhShn+3L6q573k1lO4YH4bAQQDwmNaPFMs+jm9Umlx rhqlnEseszACFP0Um9yU2erzRTfmp9I5PexgoZcVMF0DAgXG5g/LC54o90J6Ia17I5WH IfsoKMks3VRb/bRkddMUHXob2bXizvgh64jFLzwAIMeDDKYi759O8dpgeegSOdexAR5g xYCQ== Original-Received: by 10.49.74.73 with SMTP id r9mr50677444qev.44.1357594064856; Mon, 07 Jan 2013 13:27:44 -0800 (PST) Original-Received: by 10.49.48.42 with HTTP; Mon, 7 Jan 2013 13:27:44 -0800 (PST) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:69466 Archived-At: When I translated the C code to Lisp I tried to carry everything over, including any "warts". Clearly this was the case for the documentation as well. I enjoy how succinct the doc is though. Until Emacs 21, the docstring was just "Read function name, then read its arguments and call it." 1. Yes, the first line should say "command" and not "function". Although since the word "command" is in execute-extended-command it seems the intent was to avoid sounding repetitive. 2. True, the definition for execute-extended-command doesn't contain code for reading arguments. That's because the work is off-loaded to command-execute and in turn call-interactively. So for all intents and purposes that's what execute-extended-command does. Sometimes it's the case that "the command so named reads its own arguments", but that's only true when the command has an interactive Lisp form -- which gets eval'd by call-interactively. Otherwise, interactive specs of the string-variety are really handled by call-interactively. I'd file this as a distinction without a difference or at least as implementation details that are hopefully already covered appropriately in the Elisp manual. 3. The usage in the Emacs manual is "numeric argument", so for better or worse, it seems consistent. 4. Is a white space nit pick. As Yoda might have said, "A horse in the race I have not." 5. Yeah, best to delete "with" from "you are invoking with". This is actually worth fixing. 6. Yeah, "accepts an argument" is probably more correct language than "asks for an argument". This is actually worth fixing as well. Looking forward to the release of the Lisp version of M-x! /a -- In general, we reserve the right to have a poor memory--the computer, however, is supposed to remember! Poor computer. -- Guy Lewis Steele Jr.