From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#22023: 25.0.50; doc string of `eval-buffer' Date: Fri, 27 Nov 2015 12:09:02 +0200 Message-ID: <83mvtzsqip.fsf@gnu.org> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1448619026 10000 80.91.229.3 (27 Nov 2015 10:10:26 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 27 Nov 2015 10:10:26 +0000 (UTC) Cc: 22023-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 27 11:10:13 2015 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 1a2Fyj-0007Lg-Vf for geb-bug-gnu-emacs@m.gmane.org; Fri, 27 Nov 2015 11:10:10 +0100 Original-Received: from localhost ([::1]:55644 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2Fym-00045Z-PB for geb-bug-gnu-emacs@m.gmane.org; Fri, 27 Nov 2015 05:10:12 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:32983) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2Fyi-00041h-BS for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 05:10:09 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a2Fye-0005S2-BI for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 05:10:08 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:37214) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a2Fye-0005Ry-8R for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 05:10:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1a2Fyd-0001pZ-S7 for bug-gnu-emacs@gnu.org; Fri, 27 Nov 2015 05:10:03 -0500 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Fri, 27 Nov 2015 10:10:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 22023 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 22023@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 22023-done@debbugs.gnu.org id=D22023.14486189616978 (code D ref 22023); Fri, 27 Nov 2015 10:10:02 +0000 Original-Received: (at 22023-done) by debbugs.gnu.org; 27 Nov 2015 10:09:21 +0000 Original-Received: from localhost ([127.0.0.1]:55154 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a2Fxw-0001oU-KY for submit@debbugs.gnu.org; Fri, 27 Nov 2015 05:09:20 -0500 Original-Received: from mtaout29.012.net.il ([80.179.55.185]:59775) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1a2Fxt-0001oK-Sx for 22023-done@debbugs.gnu.org; Fri, 27 Nov 2015 05:09:18 -0500 Original-Received: from conversion-daemon.mtaout29.012.net.il by mtaout29.012.net.il (HyperSendmail v2007.08) id <0NYG00K00XC7LL00@mtaout29.012.net.il> for 22023-done@debbugs.gnu.org; Fri, 27 Nov 2015 12:08:46 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([84.94.185.246]) by mtaout29.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NYG009ATXILOVB0@mtaout29.012.net.il>; Fri, 27 Nov 2015 12:08:46 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x 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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:109332 Archived-At: > Date: Thu, 26 Nov 2015 16:12:49 -0800 (PST) > From: Drew Adams > > The doc string suggests that the entire buffer is always evaluated, > which is wrong. > > The Elisp manual, node `Eval' is better. It says that it operates on > the entire _accessible portion_ of the buffer. That's a big difference. > > This function is commonly used by users, as a command. They should > realize that they can easily limit its scope by narrowing the buffer. > > Even the treatment in the manual could be improved by making clear what > is meant by the "accessible" portion of the buffer. When the Emacs > manual refers to the "accessible portion" it follows that phrase with > this: (*note Narrowing::). That makes everything clear. Thanks, fixed.