From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#72961: Possible documentation improvement: Clarification for package installation Date: Thu, 05 Sep 2024 12:10:08 +0300 Message-ID: <86frqe4gb3.fsf@gnu.org> References: <86r0a28dpd.fsf@gnu.org> <87ikvdgabf.fsf@posteo.net> <86o7524nx4.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="38922"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 72961@debbugs.gnu.org, philipk@posteo.net To: Krystian Samp Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Sep 05 11:11:21 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1sm8WO-0009y0-VI for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 05 Sep 2024 11:11:21 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sm8W3-0007tC-3n; Thu, 05 Sep 2024 05:10:59 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sm8W1-0007t2-AX for bug-gnu-emacs@gnu.org; Thu, 05 Sep 2024 05:10:57 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sm8W1-0005R1-2m for bug-gnu-emacs@gnu.org; Thu, 05 Sep 2024 05:10:57 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=References:In-Reply-To:From:Date:To:Subject; bh=YfEZlkwxzVkii1H3i/KjjBcyggGeexFg/tswdL097+k=; b=UuWZo3opA0KksR+jH4ukEJ8F4SnO6c3R6nuhg58IBiBogyJgm09jCyYAdiGAfKbBPUU0/W98SCx5yD6z81X5RV4X89m9gkjHq5xQ487468S7e1oFfNf8M/DBgRxfHrvnPJbUalUY6djiQfJl939vNfRCHnxIIQiDMrWpJgy2/ga3pEOtcAgXVhfMuJ2cLimMaAqOkMzLbabWPbkW2sH0LoW5JRjrYQC8Nr22zIcd05mn9yPowa+SJv1DZ3ac00srH50I9k099Yj6P7//dnWKTZnVvw+tRKdfKEK1sigacytc/L/Axmt0DkxBvjdiB1QR8Ggn/WOenhbtwxkhSyZ8gA==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sm8X3-0006fp-L2 for bug-gnu-emacs@gnu.org; Thu, 05 Sep 2024 05:12:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 05 Sep 2024 09:12:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 72961 X-GNU-PR-Package: emacs Original-Received: via spool by 72961-submit@debbugs.gnu.org id=B72961.172552749625567 (code B ref 72961); Thu, 05 Sep 2024 09:12:01 +0000 Original-Received: (at 72961) by debbugs.gnu.org; 5 Sep 2024 09:11:36 +0000 Original-Received: from localhost ([127.0.0.1]:36143 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sm8We-0006eJ-A8 for submit@debbugs.gnu.org; Thu, 05 Sep 2024 05:11:36 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:37486) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sm8Wc-0006e2-Gz for 72961@debbugs.gnu.org; Thu, 05 Sep 2024 05:11:35 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sm8VT-0005Kj-2p; Thu, 05 Sep 2024 05:10:23 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=YfEZlkwxzVkii1H3i/KjjBcyggGeexFg/tswdL097+k=; b=i0v0VJMR5LdQ Ykk1HUjb0AhwSEItIhxyDUs5WP5MkMqeoci1uNxow+SK6uP4fVM3wL6L+VFKo4+61EIGnxvGr9rEd IEk5XnIGlj8RUdAf6ChaAd/sId/hU2cmDRhs8CjB0TdUUmeUdaOWJOeHQpJYDddsleD2iHtFEIGDN tEEYwwZ+iClgk1J+hZP4C5qtFIvPjo7f5YGBmy39XjX8GXvQtjNtCXsU/jcAHLAELV2n4a91autOT cOoyrJftgsgNsN7+UXZRCGmmcmxkaWl+isUNDOZPV9OLg9TBhyz8++8pGiTwbsKKgRdl/LzD9Qwh9 u5fKP8BiCU5dI2mrb14Ejg==; In-Reply-To: (message from Krystian Samp on Thu, 5 Sep 2024 09:44:14 +0200) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:291238 Archived-At: > From: Krystian Samp > Date: Thu, 5 Sep 2024 09:44:14 +0200 > Cc: philipk@posteo.net, 72961@debbugs.gnu.org > > Thanks, > > imho it'd be also useful to add there that Emacs will make the installed packages available automatically at > startup. Now it reads that Emacs will add them to `load-path` but I wouldn't infer from this that Emacs will also > make these packages available. And right after that we say that "... making the above manual customizations > unnecessary for such packages" which specifically refers to loading, not only adding to `load-path`. Just two > cents, All of this is already described in the node "Package Installation", to which this node points. Cross-references in the manual are there for a reason: interested readers are expected to follow them and to read what the referenced nodes say. We don't have the same information in more than one place in the manual because that would make it a maintenance burden: all of those places have to be found and updated when something changes. Our conventions are to describe each feature in full in a single place, and then have cross-references to that one place in other related places. So I decided not to expand on this more in the sections which is only tangentially related to package installation. This text is there so as to avoid creating an impression that what this node describes must be done for packages installed via package.el. It doesn't (and should not) pretend to describe installation via package.el.