diff options
Diffstat (limited to 'doc/emacs.texi')
| -rw-r--r-- | doc/emacs.texi | 44 |
1 files changed, 18 insertions, 26 deletions
diff --git a/doc/emacs.texi b/doc/emacs.texi index 27f5365caa..c4fdfff272 100644 --- a/doc/emacs.texi +++ b/doc/emacs.texi @@ -48,13 +48,19 @@ command (@pxref{Emacs Popup Interface}). @end itemize -When it is done ``guix.el'' may be configured by requiring a special -@code{guix-init} file---i.e., by adding the following code into your -init file (@pxref{Init File,,, emacs, The GNU Emacs Manual}): +When it is done, ``guix.el'' may be configured by requiring +@code{guix-autoloads} 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 (add-to-list 'load-path "/path/to/directory-with-guix.el") -(require 'guix-init nil t) +(require 'guix-autoloads nil t) @end example So the only thing you need to figure out is where the directory with @@ -66,17 +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 -@code{load-path}, so there is no need to add that directory there. +@code{load-path}, 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 -@command{guix package -i guix} command (@pxref{Invoking guix package}) -and add @file{~/.guix-profile/share/emacs/site-lisp/} directory to -@code{load-path} variable. +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 @@ -88,26 +96,10 @@ same directory, so your final configuration will look like this: (let ((dir "/path/to/your-guix-git-tree/emacs")) (add-to-list 'load-path dir) (setq guix-load-path dir)) -(require 'guix-init nil t) +(require 'guix-autoloads nil t) @end example @end itemize -By default, along with autoloading (@pxref{Autoload,,, elisp, The GNU -Emacs Lisp Reference Manual}) the main interactive commands for -``guix.el'' (@pxref{Emacs Commands}), requiring @code{guix-init} will -also autoload commands for the Emacs packages installed in your user -profile. - -To disable automatic loading of installed Emacs packages, set -@code{guix-package-enable-at-startup} variable to @code{nil} before -requiring @code{guix-init}. This variable has the same meaning for -Emacs packages installed with Guix, as @code{package-enable-at-startup} -for the built-in Emacs package system (@pxref{Package Installation,,, -emacs, The GNU Emacs Manual}). - -You can activate Emacs packages installed in your profile whenever you -want using @kbd{M-x@tie{}guix-emacs-autoload-packages}. - @node Emacs Package Management @section Package Management |