From bfb3cdad8a42dddf3cade7b8312578fa08b51986 Mon Sep 17 00:00:00 2001 From: emacspace Date: Sat, 20 Mar 2021 21:07:12 +0000 Subject: [PATCH] documentation formatting: Sat Mar 20 21:07:12 UTC 2021 --- doc/DOCUMENTATION.org | 4 ++-- doc/FAQ.org | 40 +++++++++++++++++++++------------------- 2 files changed, 23 insertions(+), 21 deletions(-) diff --git a/doc/DOCUMENTATION.org b/doc/DOCUMENTATION.org index a1b0c34e7..09bc799d8 100644 --- a/doc/DOCUMENTATION.org +++ b/doc/DOCUMENTATION.org @@ -437,8 +437,8 @@ Example: #+END_SRC **** Overriding a layer package - See [[https://www.spacemacs.org/doc/FAQ.html#how-to-override-a-layer-package][this answer in the FAQ's]]. - +See [[https://www.spacemacs.org/doc/FAQ.html#how-to-override-a-layer-package][this answer in the FAQ's]]. + *** Without a layer Sometimes a layer can be an unnecessary overhead, this is the case if you just want to install a package with very few configuration associated to it. A good diff --git a/doc/FAQ.org b/doc/FAQ.org index a5749deb7..d4fad9aac 100644 --- a/doc/FAQ.org +++ b/doc/FAQ.org @@ -289,26 +289,28 @@ to the list and it will be installed when you reload your configuration with ~SPC f e R~, or at the next Spacemacs launch. ** How to override a layer package? - To replace a package that is installed and configured by a layer, without - losing the layer's configuration for that package, add the package to your - =dotspacemacs-additional-packages= with the =:location= keyword set to the - value =local=: - #+begin_src emacs-lisp :tangle yes - (package-name :location local) - #+end_src - The package should reside at =/local//= (this could be a - symbolic link to the real package (repo) directory). The package will still - get configured (but not loaded) by the layer. To load the package, require it - from your =dotspacemacs/user-config=: =(require 'package-name)=. In this way - you can easily switch between the custom version and the version configured by - the layer by commenting in/out the line in =dotspacemacs-additional-packages= - (to restore deferred loading also comment out the =require= form in - =dotspacemacs/user-config=). +To replace a package that is installed and configured by a layer, without +losing the layer's configuration for that package, add the package to your +=dotspacemacs-additional-packages= with the =:location= keyword set to the +value =local=: + +#+BEGIN_SRC emacs-lisp + (package-name :location local) +#+END_SRC + +The package should reside at =/local//= (this could be a +symbolic link to the real package (repo) directory). The package will still +get configured (but not loaded) by the layer. To load the package, require it +from your =dotspacemacs/user-config=: =(require 'package-name)=. In this way +you can easily switch between the custom version and the version configured by +the layer by commenting in/out the line in =dotspacemacs-additional-packages= +(to restore deferred loading also comment out the =require= form in +=dotspacemacs/user-config=). + +You could also fully replace (i.e. overwrite) the layer version of the package +by using a Quelpa recipe with the pseudo-fetcher =local= as described [[https://develop.spacemacs.org/doc/LAYERS.html#packagesel][here]] and +[[https://github.com/quelpa/quelpa#file][here]]. - You could also fully replace (i.e. overwrite) the layer version of the package - by using a Quelpa recipe with the pseudo-fetcher =local= as described [[https://develop.spacemacs.org/doc/LAYERS.html#packagesel][here]] and - [[https://github.com/quelpa/quelpa#file][here]]. - ** Disable a package completely? To completely disable a package and effectively uninstalling it even if it is part of your used layers, look for the variable =dotspacemacs-excluded-packages=