From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#13571: 24.3.50; doc of `interactive' Date: Sun, 27 Jan 2013 18:21:48 -0800 Message-ID: <6B1C0A2C1FE74926A90E8BEFA7562DF4@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1359339763 2739 80.91.229.3 (28 Jan 2013 02:22:43 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 28 Jan 2013 02:22:43 +0000 (UTC) To: 13571@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 28 03:23:03 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 1TzeNB-0000IA-2w for geb-bug-gnu-emacs@m.gmane.org; Mon, 28 Jan 2013 03:23:01 +0100 Original-Received: from localhost ([::1]:60068 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TzeMt-00024g-5u for geb-bug-gnu-emacs@m.gmane.org; Sun, 27 Jan 2013 21:22:43 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:34998) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TzeMq-00024Z-Gx for bug-gnu-emacs@gnu.org; Sun, 27 Jan 2013 21:22:41 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TzeMp-0003vr-Bv for bug-gnu-emacs@gnu.org; Sun, 27 Jan 2013 21:22:40 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:46404) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TzeMp-0003vm-8L for bug-gnu-emacs@gnu.org; Sun, 27 Jan 2013 21:22:39 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TzeNB-0007Zu-Nn for bug-gnu-emacs@gnu.org; Sun, 27 Jan 2013 21:23:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 28 Jan 2013 02:23:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 13571 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.135933975129087 (code B ref -1); Mon, 28 Jan 2013 02:23:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 28 Jan 2013 02:22:31 +0000 Original-Received: from localhost ([127.0.0.1]:51868 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TzeMg-0007Z5-H2 for submit@debbugs.gnu.org; Sun, 27 Jan 2013 21:22:31 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:51790) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TzeMe-0007Yx-GD for submit@debbugs.gnu.org; Sun, 27 Jan 2013 21:22:29 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TzeMG-0003rS-M1 for submit@debbugs.gnu.org; Sun, 27 Jan 2013 21:22:05 -0500 Original-Received: from lists.gnu.org ([208.118.235.17]:41410) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TzeMG-0003rO-JR for submit@debbugs.gnu.org; Sun, 27 Jan 2013 21:22:04 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:34913) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TzeMF-00022e-KF for bug-gnu-emacs@gnu.org; Sun, 27 Jan 2013 21:22:04 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TzeMD-0003r1-UY for bug-gnu-emacs@gnu.org; Sun, 27 Jan 2013 21:22:03 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:34822) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TzeMD-0003qf-Ok for bug-gnu-emacs@gnu.org; Sun, 27 Jan 2013 21:22:01 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r0S2LxOo001670 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 28 Jan 2013 02:22:00 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r0S2LxbF028514 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Mon, 28 Jan 2013 02:21:59 GMT Original-Received: from abhmt108.oracle.com (abhmt108.oracle.com [141.146.116.60]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id r0S2LxgU016297 for ; Sun, 27 Jan 2013 20:21:59 -0600 Original-Received: from dradamslap1 (/71.202.147.44) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 27 Jan 2013 18:21:58 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac38/jnELBDgGbOpRD23EMVzbRK8Xg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:70390 Archived-At: 1. For `v' it should not say "Variable name", even if it also mentions `custom-variable-p'. It should speak of "option", not "variable". E.g.: Option: a symbol that is `custom-variable-p'. The name is read. A user should not need to click `custom-variable-p', or be already familiar with that Lisp predicate, to understand that this reads an option name, not the name of an arbitrary variable. 2. There is confusion in the doc string and in (elisp) `Interactive Codes' regarding (a) what a given interactive code reads and (b) what value it returns/provides for the argument. In particular, we misleadingly see mention of "name" here and there. A name is read in such cases, but a name, i.e., a string, is not always what is returned. In many cases, a symbol is returned. A symbol is a special Lisp object, and definitely not a name. It has a name, as well as other properties. Some of the entries, such as `b', are correct: they read and return a name, not the object named (e.g. a buffer). The following entries incorrectly speak of "name". They read names, but they return symbols, and the doc is not clear about this. a C v z Z See the entry for `S' in the manual (not the doc string), for proper distinction between what is read (a symbol name) and what is returned (a symbol). See also #1 above, for another example of possible wording. In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600) of 2013-01-25 on ODIEONE Bzr revision: 111604 eliz@gnu.org-20130125143821-1ykj7ia1qjojjjnp Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -IC:/Devel/emacs/build/include --ldflags -LC:/Devel/emacs/build/lib'