>From 938e45e104b55b32d6c2423543c18efc7dc9365a Mon Sep 17 00:00:00 2001 From: Alex Kost Date: Fri, 1 Jan 2016 01:37:45 +0300 Subject: [PATCH] doc: Describe how to configure Emacs packages. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Suggested by Ludovic Courtès . * doc/guix.texi (Application Setup)[Emacs Packages]: New subsection. --- doc/guix.texi | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index c45f1c8..a8cdac8 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -1035,6 +1035,31 @@ for Chinese languages: guix package -i font-adobe-source-han-sans:cn @end example address@hidden 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 address@hidden/.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 +Emacs package system organizes the file structure (@pxref{Package +Files,,, emacs, The GNU Emacs Manual}). + +So, to let Emacs ``know'' where these package are placed (i.e., to add +required directories to @code{load-path} and to load address@hidden@dots{}-autoloads.el} files), you can set up the elisp code that +comes with Guix. It should look like this: + address@hidden +(add-to-list 'load-path "/path/to/guix-emacs-directory") +(require 'guix-init nil t) address@hidden example + address@hidden Initial Setup}, for more information. + @c TODO What else? @c ********************************************************************* -- 2.6.3