>From 5332759fbd531226bdd54b723cdd789dcf21b42e Mon Sep 17 00:00:00 2001 From: Alex Kost Date: Sat, 5 Mar 2016 11:39:35 +0300 Subject: [PATCH 3/3] doc: Clarify installation instructions for "guix.el". * doc/emacs.texi (Emacs Initial Setup): Mention that "guix package -i guix" is an easy way. Warn that "make install" may lead to an outdated code. --- doc/emacs.texi | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/doc/emacs.texi b/doc/emacs.texi index 527afe7..c4fdfff 100644 --- a/doc/emacs.texi +++ b/doc/emacs.texi @@ -49,7 +49,13 @@ command (@pxref{Emacs Popup Interface}). @end itemize When it is done, ``guix.el'' may be configured by requiring address@hidden file---i.e., by adding the following code into address@hidden file. If you install Guix in your user profile, +this auto-loading is done automatically by our Emacs package +(@pxref{Application Setup}), so a universal recipe for configuring +``guix.el'' is: @command{guix package -i guix}. If you do this, there +is no need to read further. + +For the manual installation, you need to add the following code into your init file (@pxref{Init File,,, emacs, The GNU Emacs Manual}): @example @@ -66,18 +72,19 @@ If it was installed by a package manager of your distribution or by a usual @code{./configure && make && make install} command sequence, then elisp files are placed in a standard directory with Emacs packages (usually it is @file{/usr/share/emacs/site-lisp/}), which is already in address@hidden, so there is no need to add that directory there. address@hidden, so there is no need to add that directory there. Note +that if you don't update this installation periodically, you may get an +outdated Emacs code which does not work with the current Guile code of +Guix. @item If you used a binary installation method (@pxref{Binary Installation}), then Guix is installed somewhere in the store, so the elisp files are placed in @file{/gnu/store/@dots{}-guix-0.8.2/share/emacs/site-lisp/} or alike. However it is not recommended to refer directly to a store -directory. Instead you can install Guix using Guix itself with address@hidden package -i guix} command (@pxref{Invoking guix package}). -No further actions are needed in this case, as @code{guix-autoloads} -file will automatically be loaded by Emacs (if it is installed with -Guix, of course) (@pxref{Application Setup}). +directory, as it may be garbage-collected one day. So a better choice +would be to install Guix using Guix itself with @command{guix package -i +guix}. @item If you did not install Guix at all and prefer a hacking way -- 2.6.3