TakeV
/
spacemacs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

documentation formatting: Sat Mar 20 21:07:12 UTC 2021

This commit is contained in:
emacspace 2021-03-20 21:07:12 +00:00 committed by Eugene Yaremenko
parent 5fac9a26c6
commit bfb3cdad8a
2 changed files with 23 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/DOCUMENTATION.org
View File

@ -437,8 +437,8 @@ Example:
#+END_SRC #+END_SRC
**** Overriding a layer package **** 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 *** Without a layer
Sometimes a layer can be an unnecessary overhead, this is the case if you just 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 want to install a package with very few configuration associated to it. A good

40
doc/FAQ.org
View File

@ -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. ~SPC f e R~, or at the next Spacemacs launch.
** How to override a layer package? ** How to override a layer package?
To replace a package that is installed and configured by a layer, without 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 losing the layer's configuration for that package, add the package to your
=dotspacemacs-additional-packages= with the =:location= keyword set to the =dotspacemacs-additional-packages= with the =:location= keyword set to the
value =local=: value =local=:
#+begin_src emacs-lisp :tangle yes
(package-name :location local) #+BEGIN_SRC emacs-lisp
#+end_src (package-name :location local)
The package should reside at =<layer>/local/<package>/= (this could be a #+END_SRC
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 The package should reside at =<layer>/local/<package>/= (this could be a
from your =dotspacemacs/user-config=: =(require 'package-name)=. In this way symbolic link to the real package (repo) directory). The package will still
you can easily switch between the custom version and the version configured by get configured (but not loaded) by the layer. To load the package, require it
the layer by commenting in/out the line in =dotspacemacs-additional-packages= from your =dotspacemacs/user-config=: =(require 'package-name)=. In this way
(to restore deferred loading also comment out the =require= form in you can easily switch between the custom version and the version configured by
=dotspacemacs/user-config=). 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? ** Disable a package completely?
To completely disable a package and effectively uninstalling it even if it is 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= part of your used layers, look for the variable =dotspacemacs-excluded-packages=