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#21704: 25.0.50; Package (package.el) doc should mention effects on `load-path' Date: Sat, 30 Apr 2016 17:18:50 -0800 (GMT-08:00) Message-ID: References: <489dac34-2cb6-416d-9ef2-301884dd31d8@default> <87inyy7n1d.fsf@gnus.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 1462065646 24949 80.91.229.3 (1 May 2016 01:20:46 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 1 May 2016 01:20:46 +0000 (UTC) Cc: 21704@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun May 01 03:20:33 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 1awg3k-00050H-Qj for geb-bug-gnu-emacs@m.gmane.org; Sun, 01 May 2016 03:20:33 +0200 Original-Received: from localhost ([::1]:60269 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awg3g-0005pT-Iq for geb-bug-gnu-emacs@m.gmane.org; Sat, 30 Apr 2016 21:20:28 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57769) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awg3X-0005aT-RW for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 21:20:26 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1awg3J-0003Df-E5 for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 21:20:11 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:46544) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1awg3J-0003C5-Aj for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 21:20:05 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1awg3F-00061M-Sk for bug-gnu-emacs@gnu.org; Sat, 30 Apr 2016 21:20: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, 01 May 2016 01:20:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 21704 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 21704-submit@debbugs.gnu.org id=B21704.146206554223074 (code B ref 21704); Sun, 01 May 2016 01:20:01 +0000 Original-Received: (at 21704) by debbugs.gnu.org; 1 May 2016 01:19:02 +0000 Original-Received: from localhost ([127.0.0.1]:58881 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awg2I-000606-3Z for submit@debbugs.gnu.org; Sat, 30 Apr 2016 21:19:02 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:33927) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1awg2G-0005zd-EU for 21704@debbugs.gnu.org; Sat, 30 Apr 2016 21:19:00 -0400 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u411IqKx014456 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 1 May 2016 01:18:53 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u411Iqul009551 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 1 May 2016 01:18:52 GMT Original-Received: from abhmp0019.oracle.com (abhmp0019.oracle.com [141.146.116.25]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id u411IpIC016943; Sun, 1 May 2016 01:18:52 GMT In-Reply-To: <87inyy7n1d.fsf@gnus.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: userv0021.oracle.com [156.151.31.71] 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:117483 Archived-At: > > Apparently (at least from searching package.el and (emacs) `Packages' > > and its subnodes), nowhere do we tell users the effect of using the > > package system on `load-path'. (Variable `load-path' is mentioned in a > > couple of doc strings, but only for "internal-only" functions.) > > > > There is this comment in the Commentary of `package.el': > > > > ;; At activation time we will set up the load-path and the info path, > > ;; and we will load the package's autoloads. If a package's > > ;; dependencies are not available, we will not activate that package. > > > > I think it is important (helpful) to explicitly make the connection for > > users between `load-path' and the package system. Please consider > > making it clear. Even just a statement such as the one in that comment > > would help. >=20 > Do you have a suggestion as to where in the manual we should mention the > load-path impact? I'm no expert on package.el or its doc, but I think it should=20 be mentioned somewhere where we introduce using the package system. We should mention what using the package system has as effects. We no doubt explain what it does wrt downloading to certain locations (which you control), automatically byte-compiling, etc. The relation with `load-path' should, I expect, be mentioned in the same general area of the doc.