From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Daniel Fleischer Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] Package Installation in Tutorial Date: Sat, 04 Dec 2021 22:38:58 +0200 Message-ID: References: <864k7ro07p.fsf@mail.linkov.net> <87pmqdvd1h.fsf@gnus.org> <83lf105o58.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31912"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (darwin) To: emacs-devel@gnu.org Cancel-Lock: sha1:mhJprMgZprSjphB787Wy+YdpqqE= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Dec 04 21:41:37 2021 Return-path: Envelope-to: ged-emacs-devel@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 1mtbqj-00089e-4w for ged-emacs-devel@m.gmane-mx.org; Sat, 04 Dec 2021 21:41:37 +0100 Original-Received: from localhost ([::1]:33420 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtbqh-0002o5-C1 for ged-emacs-devel@m.gmane-mx.org; Sat, 04 Dec 2021 15:41:35 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:60092) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtboM-0001uG-QR for emacs-devel@gnu.org; Sat, 04 Dec 2021 15:39:10 -0500 Original-Received: from ciao.gmane.io ([116.202.254.214]:44470) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtboL-0006FQ-0d for emacs-devel@gnu.org; Sat, 04 Dec 2021 15:39:10 -0500 Original-Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1mtboH-0005Jy-Sx for emacs-devel@gnu.org; Sat, 04 Dec 2021 21:39:05 +0100 X-Injected-Via-Gmane: http://gmane.org/ Received-SPF: pass client-ip=116.202.254.214; envelope-from=ged-emacs-devel@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: 5 X-Spam_score: 0.5 X-Spam_bar: / X-Spam_report: (0.5 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, FORGED_GMAIL_RCVD=1, FREEMAIL_FORGED_FROMDOMAIN=0.248, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.248, NML_ADSP_CUSTOM_MED=0.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:280943 Archived-At: --=-=-= Content-Type: text/plain Eli Zaretskii [2021-12-04 Sat 18:29] wrote: > Thanks, but I feel this is too much for a tutorial. Just mentioning > list-packages, and having a reference to the manual that describes the > rest, should be enough. OK, listing the packages and referring the manual is good enough for raising awareness to this topic at this point. Please notice the new button in the startup screen as well, as it wasn't discussed and is also included in the patch. --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-Exposing-package-management-to-users.patch Content-Description: Patch final? >From 987fd91c4eebca66f81eef9040a6f4d23e0d7170 Mon Sep 17 00:00:00 2001 From: Daniel Fleischer Date: Wed, 1 Dec 2021 19:15:27 +0200 Subject: [PATCH] Exposing package management to users * etc/tutorials/TUTORIAL: section about package installation * lisp/startup.el (fancy-startup-tail): package-list button --- etc/tutorials/TUTORIAL | 14 ++++++++++++++ lisp/startup.el | 8 ++++++-- 2 files changed, 20 insertions(+), 2 deletions(-) diff --git a/etc/tutorials/TUTORIAL b/etc/tutorials/TUTORIAL index dcdb61f23e..a1b03a711b 100644 --- a/etc/tutorials/TUTORIAL +++ b/etc/tutorials/TUTORIAL @@ -1099,6 +1099,20 @@ manual in the node called "Dired". The manual also describes many other Emacs features. +* INSTALLING PACKAGES +--------------------- + +Emacs has a rich set of packages written by the community, which +extends Emacs' capabilities. These features include support for new +languages, additional themes, plugins for integrating with external +applications and much much more. + +To see a list of all available packages, type M-x list-packages. In +this mode, you can install or uninstall packages, as well as read +packages' descriptions. For more information about package +management, consult the maunal. + + * CONCLUSION ------------ diff --git a/lisp/startup.el b/lisp/startup.el index d4bb338fc0..d78cc6d35d 100644 --- a/lisp/startup.el +++ b/lisp/startup.el @@ -1835,7 +1835,7 @@ fancy-startup-tail (unless concise (fancy-splash-insert :face 'variable-pitch - "\nTo start... " + "\nTo start... " :link `("Open a File" ,(lambda (_button) (call-interactively 'find-file)) "Specify a new file's name, to edit the file") @@ -1843,10 +1843,14 @@ fancy-startup-tail :link `("Open Home Directory" ,(lambda (_button) (dired "~")) "Open your home directory, to operate on its files") - " " + "\n\t" :link `("Customize Startup" ,(lambda (_button) (customize-group 'initialization)) "Change initialization settings including this screen") + " " + :link `("Explore Packages" + ,(lambda (_button) (call-interactively 'package-list-packages)) + "Explore, install and remove Emacs packages") "\n")) (fancy-splash-insert :face 'variable-pitch "To quit a partially entered command, type " -- 2.33.1 --=-=-= Content-Type: text/plain -- Daniel Fleischer --=-=-=--