From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: emacs-26: `with-eval-after-load' docstring omission Date: Sat, 03 Mar 2018 16:52:45 -0500 Message-ID: References: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1520113906 27715 195.159.176.226 (3 Mar 2018 21:51:46 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 3 Mar 2018 21:51:46 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Mar 03 22:51:42 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1esF48-0006Kp-Tg for ged-emacs-devel@m.gmane.org; Sat, 03 Mar 2018 22:51:41 +0100 Original-Received: from localhost ([::1]:41661 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1esF6B-0004WQ-ET for ged-emacs-devel@m.gmane.org; Sat, 03 Mar 2018 16:53:47 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45808) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1esF5X-0004WB-Fm for emacs-devel@gnu.org; Sat, 03 Mar 2018 16:53:08 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1esF5S-0001qr-Hy for emacs-devel@gnu.org; Sat, 03 Mar 2018 16:53:07 -0500 Original-Received: from [195.159.176.226] (port=60383 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1esF5S-0001p5-A4 for emacs-devel@gnu.org; Sat, 03 Mar 2018 16:53:02 -0500 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1esF3J-0008A9-Ck for emacs-devel@gnu.org; Sat, 03 Mar 2018 22:50:49 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 15 Original-X-Complaints-To: usenet@blaine.gmane.org Cancel-Lock: sha1:cmPHux2ZpiGzfvyfL076m1FOtxs= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 195.159.176.226 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:223249 Archived-At: > After reading ‘with-eval-after-load’ docstring (which just says > "Execute BODY after FILE is loaded.") I expected that BODY would be > executed just like in ‘eval-after-load’, which by default passes forms > to ‘eval’. But then that would mean it does the same as eval-after-load. The whole point of with-eval-after-load is that it doesn't do the "double evaluation" of eval-after-load (which was a frequent source of errors/confusion). Do you have some suggestion for how we could change with-eval-after-load's doc to avoid your confusion? Stefan