From 26fd987425ae40ebdb5469131f66c3afe9d359b6 Mon Sep 17 00:00:00 2001 From: Gerard Vermeulen Date: Thu, 30 Dec 2021 09:03:28 +0100 Subject: [PATCH] Edit the section on the installation of the selected packages --- README.org | 25 +++++++++++-------------- 1 file changed, 11 insertions(+), 14 deletions(-) diff --git a/README.org b/README.org index 55630a1..80d0b0a 100644 --- a/README.org +++ b/README.org @@ -256,7 +256,7 @@ the ~custom-file~ as [[info:emacs#Saving Customizations][saving customizations ( (add-to-list 'initial-frame-alist '(width . 180))) #+end_src -* Install the selected packages +* [[info:emacs#Package Installation][Install the selected packages (info)]] :PROPERTIES: :CUSTOM_ID: sec:install-selected-packages :END: @@ -267,19 +267,16 @@ archives: 2. The [[https://elpa.nongnu.org/][NonGNU Emacs Lisp Package Archive]]. 3. The [[https://melpa.org/#/][Milkypostman’s Emacs Lisp Package Archive (MELPA)]]. In addition, the [[https://github.com/quelpa/quelpa][quelpa]] tool allows to fetch code from any source and build a -package on your computer before installation. - -The code in listing [[lst:install-selected-packages]] assumes that the package -system is in a *virgin* state if the package [[https://github.com/emacscollective/no-littering][no-littering]] is not present. -Refreshing the contents of available packages at least once is a requirement in -order to be able to install and load any packages, hence also [[https://github.com/emacscollective/no-littering][no-littering]]. -It also ensures installation of [[https://github.com/quelpa/quelpa][quelpa]] before ensuring installation of -[[https://www.reddit.com/r/emacs/comments/l6rcqh/undotree_repositorys_new_home_gitlab/][undo-tree]]. - -Finally, the call src_emacs-lisp{(package-install-selected-packages)} checks the -installation status of all packages in src_emacs-lisp{package-selected-packages} -and installs the missing packages after the user has agreed to its prompt. - +package on your computer before installation. The code in listing +[[lst:install-selected-packages]] assumes that the package system is in a *virgin* +state if the package [[https://github.com/emacscollective/no-littering][no-littering]] is not present: +1. It installs and loads [[https://github.com/emacscollective/no-littering][no-littering]] after ensuring refreshing of the + contents of available packages. +2. It ensures installation of [[https://github.com/quelpa/quelpa][quelpa]] before ensuring installation of [[https://www.reddit.com/r/emacs/comments/l6rcqh/undotree_repositorys_new_home_gitlab/][undo-tree]]. +3. It calls src_emacs-lisp{(package-install-selected-packages)} to check the + installation status of all packages in + src_emacs-lisp{package-selected-packages} and to install the missing packages + after the user has agreed to its prompt. In case of normal Emacs usage, src_emacs-lisp{(package-list-packages)} refreshes the contents of packages and allows to update packages to the latest version.