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 09:04:12 -0800 (GMT-08:00) Message-ID: References: <589e7a71-0c91-4c28-b5d7-e0d61b405922@default> <87h9ejnmz6.fsf@gnus.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 1462035943 3500 80.91.229.3 (30 Apr 2016 17:05:43 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 30 Apr 2016 17:05:43 +0000 (UTC) Cc: 19116@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Apr 30 19:05: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 1awYKf-0000oW-Mn for geb-bug-gnu-emacs@m.gmane.org; Sat, 30 Apr 2016 19:05:29 +0200 Original-Received: from localhost ([::1]:59046 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awYKb-00075I-LP for geb-bug-gnu-emacs@m.gmane.org; Sat, 30 Apr 2016 13:05:25 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51304) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awYKS-0006sv-V5 for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 13:05:23 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1awYKH-0002K9-BI for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 13:05:11 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:45840) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awYKH-0002Ie-8T for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 13:05:05 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1awYKD-0001CV-RY for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 13:05:01 -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 17:05:01 +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.14620358634563 (code B ref 19116); Sat, 30 Apr 2016 17:05:01 +0000 Original-Received: (at 19116) by debbugs.gnu.org; 30 Apr 2016 17:04:23 +0000 Original-Received: from localhost ([127.0.0.1]:58177 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awYJb-0001BX-IJ for submit@debbugs.gnu.org; Sat, 30 Apr 2016 13:04:23 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:27343) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awYJZ-0001BK-Fz for 19116@debbugs.gnu.org; Sat, 30 Apr 2016 13:04:21 -0400 Original-Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u3UH4EZP025346 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 30 Apr 2016 17:04:14 GMT Original-Received: from userv0121.oracle.com (userv0121.oracle.com [156.151.31.72]) by userv0022.oracle.com (8.14.4/8.13.8) with ESMTP id u3UH4EqU025433 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 30 Apr 2016 17:04:14 GMT Original-Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u3UH4D95030692; Sat, 30 Apr 2016 17:04:14 GMT In-Reply-To: <87h9ejnmz6.fsf@gnus.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: userv0022.oracle.com [156.151.31.74] 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:117388 Archived-At: > > The doc string says only what this function does "When called > > interactively". It says nothing about what it does when called from > > Lisp. Please complete the description of the function, to take care of > > this. >=20 > This is how the doc starts: >=20 > Evaluate EXP and print value in the echo area. > When called interactively, read an Emacs Lisp expression and evaluate it. >=20 > So I see no need to change anything here. Doc for commands should present the behavior first in terms of interactive use - as a command, for all users. Only after that should it describe use of the command from Lisp code. The first line of the doc string should not be the first line of the doc string.