From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#26888: 25.2; doc of `with-eval-after-load' Date: Thu, 11 May 2017 09:00:46 -0700 (PDT) Message-ID: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1494518545 5014 195.159.176.226 (11 May 2017 16:02:25 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 11 May 2017 16:02:25 +0000 (UTC) To: 26888@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu May 11 18:02:19 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1d8qXd-00010T-UA for geb-bug-gnu-emacs@m.gmane.org; Thu, 11 May 2017 18:02:14 +0200 Original-Received: from localhost ([::1]:49151 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1d8qXj-00044A-31 for geb-bug-gnu-emacs@m.gmane.org; Thu, 11 May 2017 12:02:19 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46600) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1d8qXW-000414-Gi for bug-gnu-emacs@gnu.org; Thu, 11 May 2017 12:02:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1d8qXS-0005um-Ef for bug-gnu-emacs@gnu.org; Thu, 11 May 2017 12:02:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:36295) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1d8qXS-0005ue-Ax for bug-gnu-emacs@gnu.org; Thu, 11 May 2017 12:02:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1d8qXS-0004aF-42 for bug-gnu-emacs@gnu.org; Thu, 11 May 2017 12:02: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: Thu, 11 May 2017 16:02:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 26888 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.149451846617542 (code B ref -1); Thu, 11 May 2017 16:02:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 11 May 2017 16:01:06 +0000 Original-Received: from localhost ([127.0.0.1]:38969 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1d8qWY-0004Yr-Ag for submit@debbugs.gnu.org; Thu, 11 May 2017 12:01:06 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:55104) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1d8qWV-0004YG-66 for submit@debbugs.gnu.org; Thu, 11 May 2017 12:01:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1d8qWP-0005Db-09 for submit@debbugs.gnu.org; Thu, 11 May 2017 12:00:57 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:56401) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1d8qWO-0005DT-Mr for submit@debbugs.gnu.org; Thu, 11 May 2017 12:00:56 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46039) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1d8qWN-00038H-3H for bug-gnu-emacs@gnu.org; Thu, 11 May 2017 12:00:56 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1d8qWK-0005Bq-Gk for bug-gnu-emacs@gnu.org; Thu, 11 May 2017 12:00:55 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:31351) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1d8qWK-0005AX-4J for bug-gnu-emacs@gnu.org; Thu, 11 May 2017 12:00:52 -0400 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v4BG0mlX017698 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 11 May 2017 16:00:48 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0022.oracle.com (8.14.4/8.14.4) with ESMTP id v4BG0lID013564 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 11 May 2017 16:00:48 GMT Original-Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id v4BG0l9V010621 for ; Thu, 11 May 2017 16:00:47 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6767.5000 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:132442 Archived-At: 1. The doc does not make clear that argument LIBRARY is evaluated or that argument BODY is _not_ evaluated, at the time the overall sexp is evaluated. 2. The doc string and the Elisp manual should use the same name, LIBRARY or FILE. 3. There is lots of information about the behavior that is missing from the doc of `with-eval-after-load' but is present in the doc of `eval-after-load'. They don't behave the same, but the latter makes use of the former. You cannot understand all of the the behavior of the former without consulting the doc (or the code) of the latter. We've done users a disservice by removing the doc for `eval-after-load' from the manual and by not, at least, providing equivalent information for `with-eval-after-load'. We've apparently intentionally tried to "dumb this down", but users deserve better help than this. At the very least, the doc for `with-eval-after-load' should refer to the more complete doc of `eval-after-load', and explain that the former just expands to the latter after wrapping BODY in an anonymous function. In GNU Emacs 25.2.1 (x86_64-w64-mingw32) of 2017-04-24 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --without-dbus --without-compress-install 'CFLAGS=3D-O2 -static -g3''