aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAlex Kost <alezost@gmail.com>2016-01-01 01:37:45 +0300
committerAlex Kost <alezost@gmail.com>2016-01-29 11:13:15 +0300
commit6d97319c531999e907794ef17c63c305820974ac (patch)
tree01bfe57eabe1a155492e0ed14030a3f3d42b37b4 /doc
parent13fe4891fa247d306e203ee14c6886513bd86b52 (diff)
downloadgnu-guix-6d97319c531999e907794ef17c63c305820974ac.tar
gnu-guix-6d97319c531999e907794ef17c63c305820974ac.tar.gz
doc: Describe how Emacs packages are found.
* doc/guix.texi (Application Setup)[Emacs Packages]: New subsection.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi19
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index a6ba9485eb..3969cc04d9 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -1080,6 +1080,25 @@ for Chinese languages:
guix package -i font-adobe-source-han-sans:cn
@end example
+@subsection Emacs Packages
+
+When you install Emacs packages with Guix, the elisp files may be placed
+either in @file{$HOME/.guix-profile/share/emacs/site-lisp/} or in
+sub-directories of
+@file{$HOME/.guix-profile/share/emacs/site-lisp/guix.d/}. The latter
+directory exists because potentially there may exist thousands of Emacs
+packages and storing all their files in a single directory may be not
+reliable (because of name conflicts). So we think using a separate
+directory for each package is a good idea. It is very similar to how
+the Emacs package system organizes the file structure (@pxref{Package
+Files,,, emacs, The GNU Emacs Manual}).
+
+By default, Emacs (installed with Guix) ``knows'' where these packages
+are placed, so you don't need to perform any configuration. If, for
+some reason, you want to avoid auto-loading Emacs packages installed
+with Guix, you can do it by running Emacs with @code{--no-site-file}
+option (@pxref{Init File,,, emacs, The GNU Emacs Manual}).
+
@c TODO What else?
@c *********************************************************************