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#44748: [PATCH] New section on package initialization; document quickstart Date: Fri, 20 Nov 2020 09:58:33 +0200 Message-ID: <834klk1mty.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6150"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 44748@debbugs.gnu.org, monnier@iro.umontreal.ca To: Stefan Kangas Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Nov 20 08:59:20 2020 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 1kg1KC-0001Tm-Hu for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 20 Nov 2020 08:59:20 +0100 Original-Received: from localhost ([::1]:54526 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kg1KB-00059a-Jl for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 20 Nov 2020 02:59:19 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40788) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kg1Ju-00050I-Q0 for bug-gnu-emacs@gnu.org; Fri, 20 Nov 2020 02:59:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:58534) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kg1Ju-0006SY-HY for bug-gnu-emacs@gnu.org; Fri, 20 Nov 2020 02:59:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kg1Ju-0001Pk-FO for bug-gnu-emacs@gnu.org; Fri, 20 Nov 2020 02:59:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 20 Nov 2020 07:59:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 44748 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 44748-submit@debbugs.gnu.org id=B44748.16058591365424 (code B ref 44748); Fri, 20 Nov 2020 07:59:02 +0000 Original-Received: (at 44748) by debbugs.gnu.org; 20 Nov 2020 07:58:56 +0000 Original-Received: from localhost ([127.0.0.1]:41847 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kg1Jn-0001PP-V9 for submit@debbugs.gnu.org; Fri, 20 Nov 2020 02:58:56 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:40656) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kg1Jm-0001PE-Gn for 44748@debbugs.gnu.org; Fri, 20 Nov 2020 02:58:55 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:43175) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kg1Jg-0006Oa-EE; Fri, 20 Nov 2020 02:58:48 -0500 Original-Received: from [176.228.60.248] (port=3188 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kg1Je-00052a-Uo; Fri, 20 Nov 2020 02:58:47 -0500 In-Reply-To: (message from Stefan Kangas on Thu, 19 Nov 2020 17:00:18 -0800) 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" Xref: news.gmane.io gmane.emacs.bugs:193766 Archived-At: > From: Stefan Kangas > Date: Thu, 19 Nov 2020 17:00:18 -0800 > Cc: monnier@iro.umontreal.ca > > Please find attached a patch to add a new section on package > initialization to the user manual, and to document package-quickstart. > > Thoughts? Does adding 2 short paragraphs justify yet another node? The original text is 125 lines long, not too long IMO. > diff --git a/doc/emacs/package.texi b/doc/emacs/package.texi > index 4981dd50c7..3e9be39475 100644 > --- a/doc/emacs/package.texi > +++ b/doc/emacs/package.texi > @@ -48,6 +48,7 @@ Packages > * Package Menu:: Buffer for viewing and managing packages. > * Package Statuses:: Which statuses a package can have. > * Package Installation:: Options for package installation. > +* Package Initialization:: How packages are initialized. > * Package Files:: Where packages are installed. > @end menu When you add nodes, you need to update the detailed menu in emacs.texi as well. > +@findex package-quickstart-refresh > +@vindex package-quickstart > + If you have many packages installed, you can improve startup times > +by setting the user option @code{package-quickstart} to @code{t}. > +This requires you to manually run the command > +@code{package-quickstart-refresh} when the activations need to be > +changed, such as when you change the value of > +@code{package-load-list}. This text doesn't explain what the quick start does. Perhaps saying what will happen if the user forgets to manually run that command (error messages? signs of incorrect behavior?) would suffice. Otherwise this text sounds like some black magic, and that is not a good thing for a user manual. Thanks.