From unknown Sun Aug 17 22:01:44 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#23258 <23258@debbugs.gnu.org> To: bug#23258 <23258@debbugs.gnu.org> Subject: Status: 25.1.50; The docstring of with-eval-after-load needs improvement Reply-To: bug#23258 <23258@debbugs.gnu.org> Date: Mon, 18 Aug 2025 05:01:44 +0000 retitle 23258 25.1.50; The docstring of with-eval-after-load needs improvem= ent reassign 23258 emacs submitter 23258 Harald Hanche-Olsen severity 23258 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 02:43:57 2016 Received: (at submit) by debbugs.gnu.org; 10 Apr 2016 06:43:57 +0000 Received: from localhost ([127.0.0.1]:56501 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ap96D-0006nD-3w for submit@debbugs.gnu.org; Sun, 10 Apr 2016 02:43:57 -0400 Received: from eggs.gnu.org ([208.118.235.92]:33138) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ap96C-0006n0-1P for submit@debbugs.gnu.org; Sun, 10 Apr 2016 02:43:56 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ap965-0007CR-OH for submit@debbugs.gnu.org; Sun, 10 Apr 2016 02:43:50 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:58976) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ap965-0007CN-LX for submit@debbugs.gnu.org; Sun, 10 Apr 2016 02:43:49 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:52340) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ap964-0008VN-NQ for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 02:43:49 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ap961-0007Bm-I8 for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 02:43:48 -0400 Received: from hylle05.itea.ntnu.no ([129.241.56.225]:52800) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ap961-00079a-B9 for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 02:43:45 -0400 Received: from localhost (localhost [127.0.0.1]) by hylle05.itea.ntnu.no (Postfix) with ESMTP id 14365906F4C for ; Sun, 10 Apr 2016 08:43:29 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at hylle05.itea.ntnu.no Received: from it-ex11.win.ntnu.no (it-ex11.it.ntnu.no [IPv6:2001:700:300:3::146]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by hylle05.itea.ntnu.no (Postfix) with ESMTPS id 56C8D906215 for ; Sun, 10 Apr 2016 08:43:28 +0200 (CEST) Received: from it-ex13.win.ntnu.no (2001:700:300:3::148) by it-ex11.win.ntnu.no (2001:700:300:3::146) with Microsoft SMTP Server (TLS) id 15.0.1130.7; Sun, 10 Apr 2016 08:43:09 +0200 Received: from it-ex13.win.ntnu.no ([fe80::d4d7:f6fd:a4b:6a86]) by it-ex13.win.ntnu.no ([fe80::d4d7:f6fd:a4b:6a86%17]) with mapi id 15.00.1130.005; Sun, 10 Apr 2016 08:43:09 +0200 From: Harald Hanche-Olsen To: "bug-gnu-emacs@gnu.org" Subject: 25.1.50; The docstring of with-eval-after-load needs improvement Thread-Topic: 25.1.50; The docstring of with-eval-after-load needs improvement Thread-Index: AQHRkvQ+O43JyTjYGUK6m22rhmDvVA== Date: Sun, 10 Apr 2016 06:43:09 +0000 Message-ID: Accept-Language: en-US, nb-NO Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-mailer: Airmail Beta (353) x-ms-exchange-transport-fromentityheader: Hosted X-Ntnu-xOriginatingIp: [2001:4662:4ff3:0:b093:e7f8:76f0:e6fe] Content-Type: text/plain; charset="utf-8" Content-ID: <82E886EDD1EA8E4EB2AC2676EBA0C5DA@mail.ntnu.no> Content-Transfer-Encoding: base64 MIME-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) VGhlIGRvY3N0cmluZyBmb3Igd2l0aC1ldmFsLWFmdGVyLWxvYWQgZ2l2ZXMgb25seSBhIGN1cnNv cnkgZGVzY3JpcHRpb24gb2YgdGhlIEZJTEUgYXJndW1lbnQuIFRoZSBkb2NzdHJpbmcgb2YgdGhl IHdyYXBwZWQgZnVuY3Rpb24gZXZhbC1hZnRlci1sb2FkLCBob3dldmVyLCBpcyBtdWNoIG1vcmUg Y29tcHJlaGVuc2l2ZS4gSXQgc2hvdWxkIGVpdGhlciBiZSBpbmNsdWRlZCBpbiB0aGUgZG9jc3Ry aW5nIG9mIHdpdGgtZXZhbC1hZnRlci1sb2FkLCBvciB0aGUgZG9jc3RyaW5nIGZvciB3aXRoLWV2 YWwtYWZ0ZXItbG9hZCBzaG91bGQgcmVmZXIgdGhlIHJlYWRlciB0byBldmFsLWFmdGVyLWxvYWQg Zm9yIGZ1cnRoZXIgZGV0YWlscy4gKFRoZSBsYXR0ZXIgb3B0aW9uIGlzIGZhciBiZXR0ZXIsIElN Ty4pDQoNCkFzIGV2aWRlbmNlIG9mIHRoZSBoYXJtIGRvbmUgYnkgdGhlIGluY29tcGxldGUgZG9j dW1lbnRhdGlvbiwgSSBvZmZlciB0aGlzIGxpbms6DQoNCmh0dHA6Ly9lbWFjcy5zdGFja2V4Y2hh bmdlLmNvbS9xLzIxNTQwLzk2Mg0KDQrigJMgSGFyYWxkDQoNCkluIEdOVSBFbWFjcyAyNS4xLjUw LjEgKHg4Nl82NC1hcHBsZS1kYXJ3aW4xNS4zLjAsIE5TIGFwcGtpdC0xNDA0LjM0IFZlcnNpb24g MTAuMTEuMyAoQnVpbGQgMTVEMjEpKQ0KwqBvZiAyMDE2LTAzLTE2IGJ1aWx0IG9uIGZyaWdnDQpS ZXBvc2l0b3J5IHJldmlzaW9uOiBiNDgxOTdkOGVkYTBkNGZlMjIxYTEyOGQ4NjI4MDdkODA0ZTJl YmYwDQpXaW5kb3dpbmcgc3lzdGVtIGRpc3RyaWJ1dG9yICdBcHBsZScsIHZlcnNpb24gMTAuMy4x NDA0DQpDb25maWd1cmVkIHVzaW5nOg0KwqAnY29uZmlndXJlIC0td2l0aC1ucycNCg0K From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 12:17:59 2016 Received: (at 23258-done) by debbugs.gnu.org; 10 Apr 2016 16:17:59 +0000 Received: from localhost ([127.0.0.1]:57399 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apI3i-0005Ra-Sx for submit@debbugs.gnu.org; Sun, 10 Apr 2016 12:17:59 -0400 Received: from eggs.gnu.org ([208.118.235.92]:42061) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apI3g-0005RN-R1 for 23258-done@debbugs.gnu.org; Sun, 10 Apr 2016 12:17:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1apI3Y-0003h6-Jd for 23258-done@debbugs.gnu.org; Sun, 10 Apr 2016 12:17:51 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=BAYES_40,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:40654) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1apI3Y-0003h2-GG; Sun, 10 Apr 2016 12:17:48 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3621 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1apI3X-0006Nh-TG; Sun, 10 Apr 2016 12:17:48 -0400 Date: Sun, 10 Apr 2016 19:17:14 +0300 Message-Id: <83mvp1h20l.fsf@gnu.org> From: Eli Zaretskii To: Harald Hanche-Olsen In-reply-to: (message from Harald Hanche-Olsen on Sun, 10 Apr 2016 06:43:09 +0000) Subject: Re: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement References: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -6.0 (------) X-Debbugs-Envelope-To: 23258-done Cc: 23258-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) > From: Harald Hanche-Olsen > Date: Sun, 10 Apr 2016 06:43:09 +0000 > > The docstring for with-eval-after-load gives only a cursory description of the FILE argument. The docstring of the wrapped function eval-after-load, however, is much more comprehensive. It should either be included in the docstring of with-eval-after-load, or the docstring for with-eval-after-load should refer the reader to eval-after-load for further details. (The latter option is far better, IMO.) Fixed. For such simple bugs, I'd encourage people to submit patches rather than just tell how to fix the problem. Thanks in advance. From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 12:21:59 2016 Received: (at 23258) by debbugs.gnu.org; 10 Apr 2016 16:21:59 +0000 Received: from localhost ([127.0.0.1]:57407 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apI7b-0005Xo-E4 for submit@debbugs.gnu.org; Sun, 10 Apr 2016 12:21:59 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:39792) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apI7Y-0005Xa-WB for 23258@debbugs.gnu.org; Sun, 10 Apr 2016 12:21:57 -0400 Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u3AGLoVv014778 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 10 Apr 2016 16:21:50 GMT Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u3AGLo2f019732 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 10 Apr 2016 16:21:50 GMT Received: from abhmp0001.oracle.com (abhmp0001.oracle.com [141.146.116.7]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u3AGLna2027499; Sun, 10 Apr 2016 16:21:49 GMT MIME-Version: 1.0 Message-ID: <6ba754ce-e37a-4334-a48c-64b55f506ed4@default> Date: Sun, 10 Apr 2016 09:21:46 -0700 (PDT) From: Drew Adams To: Harald Hanche-Olsen , 23258@debbugs.gnu.org Subject: RE: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement References: In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-Spam-Score: -3.3 (---) X-Debbugs-Envelope-To: 23258 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > The docstring for with-eval-after-load gives only a cursory description > of the FILE argument. The docstring of the wrapped function eval-after- > load, however, is much more comprehensive. It should either be included > in the docstring of with-eval-after-load, or the docstring for with-eval- > after-load should refer the reader to eval-after-load for further > details. (The latter option is far better, IMO.) >=20 > As evidence of the harm done by the incomplete documentation, I offer > this link: >=20 > http://emacs.stackexchange.com/q/21540/962 +1 (Thank you, Harald.) Let me add a bit about this doc. AFAICT, there was no great need for creating this macro (and essentially telling users to prefer it over function `eval-after-load'). The "need" seems to have been only the fact that some users were not quoting arguments that they did not want to have evaluated. But having done that, whoever did it seems to have dropped the ball wrt documenting it. At the least, its doc should refer to `eval-after-load' (and vice versa presumably). As for the changes that were made to the doc string of `eval-after-load' at the same time: 1. This mystery sentence was added - at the very top, no less: This function has a compiler macro. I had to search the source code to find out what that is meant to mean - means for a function to have a "compiler macro", and even what a "compiler macro" is. And having found property `compiler-macro' used in the source code, I had to search the Elisp manual for that (there is no index entry for it). Finally, I found some light in node `Declare Form'. It cannot be clear to readers of `C-h f eval-after-load' what that mystery sentence is for. If we are going to include mention of this we should use English to get across the real point, which is presumably to say that a call to the function might be expanded by the compiler in different ways. I admit that I still do not understand why we would tell users this in `C-h f' output. And perhaps I still do not fully grasp the message. What seems clear to me is that most users will have NO CLUE what this mystery sentence (again, at the top of the help output, no less) is trying to tell them, much less why it is (or isn't) important. 2. FORM can now be a function, and what it can be is described before the description of what FILE can be. These are out of order. (OK, not very important.) As for the doc in the Elisp manual: `eval-after-load' is no longer even mentioned, except for these nodes: (1) `Hooks for Loading`, (2) `Coding Conventions', and (3) `Named Features'. The doc should be cleaned up to be coherent. And (IMHO) it _should_ document `eval-after-load' - far more important than documenting `with-eval-after-load'. Mentioning the latter does not replace describing the former. 1. Node `Hooks for Loading` says: Normally, well-designed Lisp programs should not use =E2=80=98eval-after-load=E2=80=99.... Perhaps it meant to say `with-eval-after-load' here? If not, why not? 2. Node `Coding Conventions' says: Avoid using =E2=80=98eval-after-load=E2=80=99 in libraries and package= s (*note Hooks for Loading::). This feature is meant for personal customizations; using it in a Lisp program is unclean... Again, why only `eval-after-load' for such a caution, and not (also) `with-eval-after-load'? 3. Node `Named Features' says: The direct effect of calling =E2=80=98provide=E2=80=99 is if not alrea= dy in FEATURES then to add FEATURE to the front of that list and call any =E2=80=98eval-after-load=E2=80=99 code waiting for it (*n= ote Hooks for Loading::). Now clearly it is correct to speak of `eval-after-load' here, and not `with-eval-after-load'. But is the same not true pretty much everywhere? Ultimately, the _behavior_ is that of `eval-after-load' - `with-eval-after-load' is only a wrapper. Finally, the Emacs manual makes no reference to either the macro or the function, except for this, in node `Foldout': To use the Foldout package, you can type =E2=80=98M-x load-library foldout =E2=80=99; or you can arrange for to do that automatically by putting the following in your init file: (eval-after-load "outline" '(require 'foldout)) Is that mention appropriate, or should it be removed? What's so special about library `foldout.el' in this regard? From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 12:26:36 2016 Received: (at 23258-done) by debbugs.gnu.org; 10 Apr 2016 16:26:36 +0000 Received: from localhost ([127.0.0.1]:57418 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apIC4-0005ed-Bc for submit@debbugs.gnu.org; Sun, 10 Apr 2016 12:26:36 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:40251) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apIC2-0005eQ-63 for 23258-done@debbugs.gnu.org; Sun, 10 Apr 2016 12:26:34 -0400 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 u3AGQSWE017691 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 10 Apr 2016 16:26:28 GMT 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 u3AGQRQO005980 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 10 Apr 2016 16:26:28 GMT Received: from abhmp0001.oracle.com (abhmp0001.oracle.com [141.146.116.7]) by userv0121.oracle.com (8.13.8/8.13.8) with ESMTP id u3AGQR5s009772; Sun, 10 Apr 2016 16:26:27 GMT MIME-Version: 1.0 Message-ID: <84fc8455-9d8a-4ccd-b606-21749743cdb3@default> Date: Sun, 10 Apr 2016 09:26:25 -0700 (PDT) From: Drew Adams To: Eli Zaretskii , Harald Hanche-Olsen Subject: RE: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement References: <> <<83mvp1h20l.fsf@gnu.org>> In-Reply-To: <<83mvp1h20l.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-Spam-Score: -3.3 (---) X-Debbugs-Envelope-To: 23258-done Cc: 23258-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > > The docstring for with-eval-after-load gives only a cursory description > of the FILE argument. The docstring of the wrapped function eval-after- > load, however, is much more comprehensive. It should either be included i= n > the docstring of with-eval-after-load, or the docstring for with-eval- > after-load should refer the reader to eval-after-load for further details= . > (The latter option is far better, IMO.) >=20 > Fixed. >=20 > For such simple bugs, I'd encourage people to submit patches rather > than just tell how to fix the problem. Thanks in advance. Your quick closing coincided with my reply. There is more to this than just what was mentioned in the bug report. Do you want me to file a separate bug report with the feedback I provided to this one? From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 12:38:20 2016 Received: (at 23258-done) by debbugs.gnu.org; 10 Apr 2016 16:38:20 +0000 Received: from localhost ([127.0.0.1]:57427 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apINQ-0005vt-Ml for submit@debbugs.gnu.org; Sun, 10 Apr 2016 12:38:20 -0400 Received: from hylle05.itea.ntnu.no ([129.241.56.225]:53608) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apINO-0005vk-GX for 23258-done@debbugs.gnu.org; Sun, 10 Apr 2016 12:38:19 -0400 Received: from localhost (localhost [127.0.0.1]) by hylle05.itea.ntnu.no (Postfix) with ESMTP id 09F21904E26; Sun, 10 Apr 2016 18:38:14 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at hylle05.itea.ntnu.no Received: from it-ex13.win.ntnu.no (it-ex13.it.ntnu.no [IPv6:2001:700:300:3::148]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by hylle05.itea.ntnu.no (Postfix) with ESMTPS id 164CC904EE5; Sun, 10 Apr 2016 18:38:11 +0200 (CEST) Received: from it-ex13.win.ntnu.no (2001:700:300:3::148) by it-ex13.win.ntnu.no (2001:700:300:3::148) with Microsoft SMTP Server (TLS) id 15.0.1130.7; Sun, 10 Apr 2016 18:38:02 +0200 Received: from it-ex13.win.ntnu.no ([fe80::d4d7:f6fd:a4b:6a86]) by it-ex13.win.ntnu.no ([fe80::d4d7:f6fd:a4b:6a86%17]) with mapi id 15.00.1130.005; Sun, 10 Apr 2016 18:38:02 +0200 From: Harald Hanche-Olsen To: Eli Zaretskii Subject: Re: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement Thread-Topic: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement Thread-Index: AQHRk0dZr6lNc8O4S0m8ZvBHkUH+pQ== Date: Sun, 10 Apr 2016 16:38:02 +0000 Message-ID: References: <83mvp1h20l.fsf@gnu.org> In-Reply-To: <83mvp1h20l.fsf@gnu.org> Accept-Language: en-US, nb-NO Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-mailer: Airmail Beta (353) x-ms-exchange-transport-fromentityheader: Hosted X-Ntnu-xOriginatingIp: [2001:4662:4ff3:0:40f2:3e0b:5859:ce39] Content-Type: text/plain; charset="utf-8" Content-ID: Content-Transfer-Encoding: base64 MIME-Version: 1.0 X-Spam-Score: -3.3 (---) X-Debbugs-Envelope-To: 23258-done Cc: "23258-done@debbugs.gnu.org" <23258-done@debbugs.gnu.org> X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) T24gMTAgQXByaWwgMjAxNiBhdCAxODoxODoxMiwgRWxpIFphcmV0c2tpaSAoZWxpekBnbnUub3Jn KSB3cm90ZToNCg0KPiBGb3Igc3VjaCBzaW1wbGUgYnVncywgSSdkIGVuY291cmFnZSBwZW9wbGUg dG8gc3VibWl0IHBhdGNoZXMgcmF0aGVyDQo+IHRoYW4ganVzdCB0ZWxsIGhvdyB0byBmaXggdGhl IHByb2JsZW0uIFRoYW5rcyBpbiBhZHZhbmNlLg0KDQpPa2F5LiBCeSB0aGF0LCBkbyB5b3UgbWVh biBpbmNsdWRlIGEgcGF0Y2ggd2l0aCB0aGUgYnVnIHJlcG9ydCwgb3IgaXMgdGhlcmUgc29tZSBv dGhlciBtZWNoYW5pc20gZm9yIHN1Ym1pdHRpbmcgcGF0Y2hlcyB0aGF0IEkgYW0gbm90IGF3YXJl IG9mPw0KDQrigJMgSGFyYWxk From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 12:42:42 2016 Received: (at 23258) by debbugs.gnu.org; 10 Apr 2016 16:42:42 +0000 Received: from localhost ([127.0.0.1]:57431 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apIRe-00061x-7g for submit@debbugs.gnu.org; Sun, 10 Apr 2016 12:42:42 -0400 Received: from eggs.gnu.org ([208.118.235.92]:46738) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apIRc-00061k-Tl for 23258@debbugs.gnu.org; Sun, 10 Apr 2016 12:42:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1apIRU-0008OS-I3 for 23258@debbugs.gnu.org; Sun, 10 Apr 2016 12:42:35 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:40928) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1apIRU-0008OO-EY; Sun, 10 Apr 2016 12:42:32 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3651 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1apIRT-0003DT-PB; Sun, 10 Apr 2016 12:42:32 -0400 Date: Sun, 10 Apr 2016 19:41:57 +0300 Message-Id: <83inzph0ve.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <6ba754ce-e37a-4334-a48c-64b55f506ed4@default> (message from Drew Adams on Sun, 10 Apr 2016 09:21:46 -0700 (PDT)) Subject: Re: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement References: <6ba754ce-e37a-4334-a48c-64b55f506ed4@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -6.0 (------) X-Debbugs-Envelope-To: 23258 Cc: 23258@debbugs.gnu.org, hanche@math.ntnu.no X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) > Date: Sun, 10 Apr 2016 09:21:46 -0700 (PDT) > From: Drew Adams > > As for the changes that were made to the doc string of > `eval-after-load' at the same time: > > 1. This mystery sentence was added - at the very top, no less: > > This function has a compiler macro. There's no such text in the doc string, it is created by the documentation system. From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 12:43:39 2016 Received: (at 23258-done) by debbugs.gnu.org; 10 Apr 2016 16:43:39 +0000 Received: from localhost ([127.0.0.1]:57435 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apISZ-00063Y-Fn for submit@debbugs.gnu.org; Sun, 10 Apr 2016 12:43:39 -0400 Received: from eggs.gnu.org ([208.118.235.92]:47030) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apISX-00063L-Lq for 23258-done@debbugs.gnu.org; Sun, 10 Apr 2016 12:43:37 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1apISP-0000LK-IY for 23258-done@debbugs.gnu.org; Sun, 10 Apr 2016 12:43:32 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=BAYES_20,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:40955) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1apISP-0000LG-Ey; Sun, 10 Apr 2016 12:43:29 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3652 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1apISO-0003Jp-Pt; Sun, 10 Apr 2016 12:43:29 -0400 Date: Sun, 10 Apr 2016 19:42:54 +0300 Message-Id: <83h9f9h0tt.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <84fc8455-9d8a-4ccd-b606-21749743cdb3@default> (message from Drew Adams on Sun, 10 Apr 2016 09:26:25 -0700 (PDT)) Subject: Re: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement References: <> <<83mvp1h20l.fsf@gnu.org>> <84fc8455-9d8a-4ccd-b606-21749743cdb3@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -6.0 (------) X-Debbugs-Envelope-To: 23258-done Cc: 23258-done@debbugs.gnu.org, hanche@math.ntnu.no X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) > Date: Sun, 10 Apr 2016 09:26:25 -0700 (PDT) > From: Drew Adams > Cc: 23258-done@debbugs.gnu.org > > Your quick closing coincided with my reply. There is more to > this than just what was mentioned in the bug report. Do you > want me to file a separate bug report with the feedback I > provided to this one? Separate bug, of course. It has nothing to do with this one. From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 12:45:24 2016 Received: (at 23258) by debbugs.gnu.org; 10 Apr 2016 16:45:24 +0000 Received: from localhost ([127.0.0.1]:57439 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apIUF-00066k-R1 for submit@debbugs.gnu.org; Sun, 10 Apr 2016 12:45:23 -0400 Received: from eggs.gnu.org ([208.118.235.92]:47320) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apIUE-00066V-VZ for 23258@debbugs.gnu.org; Sun, 10 Apr 2016 12:45:23 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1apIU6-0000ig-Hk for 23258@debbugs.gnu.org; Sun, 10 Apr 2016 12:45:17 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:40981) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1apIU6-0000ic-EV; Sun, 10 Apr 2016 12:45:14 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3654 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1apIU5-0003XG-Ql; Sun, 10 Apr 2016 12:45:14 -0400 Date: Sun, 10 Apr 2016 19:44:40 +0300 Message-Id: <83fuuth0qv.fsf@gnu.org> From: Eli Zaretskii To: Harald Hanche-Olsen In-reply-to: (message from Harald Hanche-Olsen on Sun, 10 Apr 2016 16:38:02 +0000) Subject: Re: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement References: <83mvp1h20l.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -6.0 (------) X-Debbugs-Envelope-To: 23258 Cc: 23258@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -6.0 (------) > X-Spam-Status: No, score=-2.5 required=5.0 tests=BAYES_50,RCVD_IN_DNSWL_MED, > RP_MATCHES_RCVD autolearn=disabled version=3.3.2 > From: Harald Hanche-Olsen > CC: "23258-done@debbugs.gnu.org" <23258-done@debbugs.gnu.org> > Date: Sun, 10 Apr 2016 16:38:02 +0000 > Accept-Language: en-US, nb-NO > > On 10 April 2016 at 18:18:12, Eli Zaretskii (eliz@gnu.org) wrote: > > > For such simple bugs, I'd encourage people to submit patches rather > > than just tell how to fix the problem. Thanks in advance. > > Okay. By that, do you mean include a patch with the bug report, or is there some other mechanism for submitting patches that I am not aware of? Just include it. The "git format-patch" form is preferred, but a simple patch is also okay. TIA From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 14:14:45 2016 Received: (at 23258) by debbugs.gnu.org; 10 Apr 2016 18:14:45 +0000 Received: from localhost ([127.0.0.1]:57491 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apJsj-0008Fe-2b for submit@debbugs.gnu.org; Sun, 10 Apr 2016 14:14:45 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:39148) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apJsh-0008FQ-9n for 23258@debbugs.gnu.org; Sun, 10 Apr 2016 14:14:43 -0400 Received: from userv0022.oracle.com (userv0022.oracle.com [156.151.31.74]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u3AIEZPV029637 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 10 Apr 2016 18:14:35 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userv0022.oracle.com (8.14.4/8.13.8) with ESMTP id u3AIEZgD005602 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 10 Apr 2016 18:14:35 GMT Received: from abhmp0001.oracle.com (abhmp0001.oracle.com [141.146.116.7]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id u3AIEX6p032707; Sun, 10 Apr 2016 18:14:34 GMT MIME-Version: 1.0 Message-ID: <61fedd17-25d2-4653-bb36-59ca338ebf7e@default> Date: Sun, 10 Apr 2016 11:14:32 -0700 (PDT) From: Drew Adams To: Eli Zaretskii , Drew Adams Subject: RE: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement References: <> <<6ba754ce-e37a-4334-a48c-64b55f506ed4@default>> <<83inzph0ve.fsf@gnu.org>> In-Reply-To: <<83inzph0ve.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: userv0022.oracle.com [156.151.31.74] X-Spam-Score: -3.3 (---) X-Debbugs-Envelope-To: 23258 Cc: 23258@debbugs.gnu.org, hanche@math.ntnu.no X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > > As for the changes that were made to the doc string of > > `eval-after-load' at the same time: > > > > 1. This mystery sentence was added - at the very top, no less: > > > > This function has a compiler macro. >=20 > There's no such text in the doc string, it is created by the > documentation system. Yes, I know that. I think I made it clear in the rest of my message, stating that I was referring to the output of `C-h f' here. But yes, the intro sentence above misleadingly spoke of the "doc string". From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 14:49:56 2016 Received: (at 23258-done) by debbugs.gnu.org; 10 Apr 2016 18:49:56 +0000 Received: from localhost ([127.0.0.1]:57513 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apKQm-0000el-Lc for submit@debbugs.gnu.org; Sun, 10 Apr 2016 14:49:56 -0400 Received: from userp1040.oracle.com ([156.151.31.81]:23413) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1apKQl-0000eW-2D for 23258-done@debbugs.gnu.org; Sun, 10 Apr 2016 14:49:55 -0400 Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u3AInmq1009218 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 10 Apr 2016 18:49:48 GMT Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u3AInld9029284 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 10 Apr 2016 18:49:48 GMT Received: from abhmp0001.oracle.com (abhmp0001.oracle.com [141.146.116.7]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id u3AIniSq010103; Sun, 10 Apr 2016 18:49:45 GMT MIME-Version: 1.0 Message-ID: <3471043c-c86c-4e38-a2dc-66647c3d8bc7@default> Date: Sun, 10 Apr 2016 11:49:43 -0700 (PDT) From: Drew Adams To: Eli Zaretskii Subject: RE: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement References: <<>> <<<83mvp1h20l.fsf@gnu.org>>> <<84fc8455-9d8a-4ccd-b606-21749743cdb3@default>> <<83h9f9h0tt.fsf@gnu.org>> In-Reply-To: <<83h9f9h0tt.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-Spam-Score: -3.3 (---) X-Debbugs-Envelope-To: 23258-done Cc: 23258-done@debbugs.gnu.org, hanche@math.ntnu.no X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > > Your quick closing coincided with my reply. There is more to > > this than just what was mentioned in the bug report. Do you > > want me to file a separate bug report with the feedback I > > provided to this one? >=20 > Separate bug, of course. It has nothing to do with this one. Done - bugs #23262 and #23264. From unknown Sun Aug 17 22:01:44 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Mon, 09 May 2016 11:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator