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#19116: 25.0.50; doc string of `eval-expression' Date: Sat, 30 Apr 2016 10:38:11 -0800 (GMT-08:00) Message-ID: <6465d7ce-bec6-4be6-9408-e1a0c8abcb64@default> References: <<<589e7a71-0c91-4c28-b5d7-e0d61b405922@default> <87h9ejnmz6.fsf@gnus.org>>> <<>> <<<83lh3vnh8z.fsf@gnu.org>>> <> <<83eg9nneco.fsf@gnu.org>> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1462041584 19954 80.91.229.3 (30 Apr 2016 18:39:44 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 30 Apr 2016 18:39:44 +0000 (UTC) Cc: larsi@gnus.org, 19116@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Apr 30 20:39:30 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 1awZne-00078s-FA for geb-bug-gnu-emacs@m.gmane.org; Sat, 30 Apr 2016 20:39:30 +0200 Original-Received: from localhost ([::1]:59294 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awZna-0001kc-LW for geb-bug-gnu-emacs@m.gmane.org; Sat, 30 Apr 2016 14:39:26 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44148) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awZnR-0001Tl-HQ for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 14:39:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1awZnF-0007lm-Mx for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 14:39:12 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:46040) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awZnF-0007kq-K4 for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 14:39:05 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1awZnC-0001kW-8N for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 14:39:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 30 Apr 2016 18:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 19116 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug Original-Received: via spool by 19116-submit@debbugs.gnu.org id=B19116.14620415026679 (code B ref 19116); Sat, 30 Apr 2016 18:39:02 +0000 Original-Received: (at 19116) by debbugs.gnu.org; 30 Apr 2016 18:38:22 +0000 Original-Received: from localhost ([127.0.0.1]:58377 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awZmY-0001jf-4y for submit@debbugs.gnu.org; Sat, 30 Apr 2016 14:38:22 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:17528) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awZmW-0001jO-Or for 19116@debbugs.gnu.org; Sat, 30 Apr 2016 14:38:21 -0400 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u3UIcEtF017631 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 30 Apr 2016 18:38:14 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u3UIcDh2004515 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 30 Apr 2016 18:38:14 GMT Original-Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u3UIcCJH024873; Sat, 30 Apr 2016 18:38:13 GMT In-Reply-To: <<83eg9nneco.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] 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:117420 Archived-At: > > The first doc-string line should say what the command does > > interactively: > > > > Read a Lisp expression, evaluate it, and print the value in the echo = area. > > ^^^^ ^^^^ ^^^^^ >=20 > That's exactly what it says, just in fewer words. Nope. 2 out of 3. It does not tell you that you are asked to input an expression to evaluate. I'm not inventing anything here, and it seems like you are just being defensive about this. This is the way we document commands, as I'm sure you know. We tell users that they will be prompted for this and that, and we tell them what the command does with what they enter. I'm done with this.