From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#13571: 24.3.50; doc of `interactive' Date: Fri, 29 Apr 2016 00:23:07 +0200 Message-ID: <871t5p4blg.fsf@gnus.org> References: <6B1C0A2C1FE74926A90E8BEFA7562DF4@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1461882262 10185 80.91.229.3 (28 Apr 2016 22:24:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 28 Apr 2016 22:24:22 +0000 (UTC) Cc: 13571@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Apr 29 00:24:10 2016 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 1avuLy-00015F-6R for geb-bug-gnu-emacs@m.gmane.org; Fri, 29 Apr 2016 00:24:10 +0200 Original-Received: from localhost ([::1]:51413 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1avuLx-00020V-EC for geb-bug-gnu-emacs@m.gmane.org; Thu, 28 Apr 2016 18:24:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35627) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1avuLt-0001xU-Ne for bug-gnu-emacs@gnu.org; Thu, 28 Apr 2016 18:24:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1avuLq-0001ne-HW for bug-gnu-emacs@gnu.org; Thu, 28 Apr 2016 18:24:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:41309) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1avuLq-0001na-Ec for bug-gnu-emacs@gnu.org; Thu, 28 Apr 2016 18:24:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1avuLq-00057l-BF for bug-gnu-emacs@gnu.org; Thu, 28 Apr 2016 18:24:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 28 Apr 2016 22:24:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 13571 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 13571-submit@debbugs.gnu.org id=B13571.146188219219628 (code B ref 13571); Thu, 28 Apr 2016 22:24:02 +0000 Original-Received: (at 13571) by debbugs.gnu.org; 28 Apr 2016 22:23:12 +0000 Original-Received: from localhost ([127.0.0.1]:53643 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1avuL2-00056W-IJ for submit@debbugs.gnu.org; Thu, 28 Apr 2016 18:23:12 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]:38388) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1avuL0-00056N-4S for 13571@debbugs.gnu.org; Thu, 28 Apr 2016 18:23:10 -0400 Original-Received: from cm-84.215.1.64.getinternet.no ([84.215.1.64] helo=mouse) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1avuKx-00013s-Jr; Fri, 29 Apr 2016 00:23:09 +0200 In-Reply-To: <6B1C0A2C1FE74926A90E8BEFA7562DF4@us.oracle.com> (Drew Adams's message of "Sun, 27 Jan 2013 18:21:48 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.1.50 (gnu/linux) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.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" Xref: news.gmane.org gmane.emacs.bugs:117125 Archived-At: "Drew Adams" writes: > 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. I disagree. Saying that it's a variable helps with understanding here. > 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 All these say that are symbols, and I think that's clear enough. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no