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#23258: 25.1.50; The docstring of with-eval-after-load needs improvement Date: Sun, 10 Apr 2016 19:17:14 +0300 Message-ID: <83mvp1h20l.fsf@gnu.org> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1460305099 11949 80.91.229.3 (10 Apr 2016 16:18:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 10 Apr 2016 16:18:19 +0000 (UTC) Cc: 23258-done@debbugs.gnu.org To: Harald Hanche-Olsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Apr 10 18:18:15 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 1apI3y-0000Ej-Vs for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Apr 2016 18:18:15 +0200 Original-Received: from localhost ([::1]:35522 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1apI3v-0003sZ-0D for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Apr 2016 12:18:11 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:33075) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1apI3n-0003lI-Br for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 12:18:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1apI3m-0003jW-G4 for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 12:18:03 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:45063) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1apI3m-0003jP-Cm for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 12:18:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1apI3m-0005Rw-9K for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 12:18:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sun, 10 Apr 2016 16:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 23258 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 23258@debbugs.gnu.org, eliz@gnu.org, hanche@math.ntnu.no Original-Received: via spool by 23258-done@debbugs.gnu.org id=D23258.146030507920934 (code D ref 23258); Sun, 10 Apr 2016 16:18:02 +0000 Original-Received: (at 23258-done) by debbugs.gnu.org; 10 Apr 2016 16:17:59 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 In-reply-to: (message from Harald Hanche-Olsen on Sun, 10 Apr 2016 06:43:09 +0000) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:116324 Archived-At: > 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.