From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#23258: 25.1.50; The docstring of with-eval-after-load needs improvement Date: Sun, 10 Apr 2016 09:26:25 -0700 (PDT) Message-ID: <84fc8455-9d8a-4ccd-b606-21749743cdb3@default> References: <> <<83mvp1h20l.fsf@gnu.org>> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1460305635 20436 80.91.229.3 (10 Apr 2016 16:27:15 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 10 Apr 2016 16:27:15 +0000 (UTC) Cc: 23258-done@debbugs.gnu.org To: Eli Zaretskii , Harald Hanche-Olsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Apr 10 18:27:11 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 1apICc-0003Vm-JE for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Apr 2016 18:27:10 +0200 Original-Received: from localhost ([::1]:35563 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1apICb-0006fq-K5 for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Apr 2016 12:27:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34707) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1apICX-0006cx-32 for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 12:27:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1apICT-0005Kd-Qi for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 12:27:04 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:45081) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1apICT-0005KZ-NZ for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 12:27:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1apICT-0005fF-Iz for bug-gnu-emacs@gnu.org; Sun, 10 Apr 2016 12:27:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 10 Apr 2016 16:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 23258 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 23258-done@debbugs.gnu.org id=D23258.146030559621743 (code D ref 23258); Sun, 10 Apr 2016 16:27:01 +0000 Original-Received: (at 23258-done) by debbugs.gnu.org; 10 Apr 2016 16:26:36 +0000 Original-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 Original-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 Original-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 Original-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 Original-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 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)] X-Source-IP: userv0022.oracle.com [156.151.31.74] 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:116327 Archived-At: > > 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?