summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAlex Kost <alezost@gmail.com>2014-12-02 10:36:25 +0300
committerAlex Kost <alezost@gmail.com>2014-12-02 22:09:24 +0300
commita7f862e4dade6942bb67322a97d733e7f89f564f (patch)
tree0c14c88e0973d678ffdb9854aba062ef53c5be75 /doc
parentd51cafb041fb517cc48b01fa68e45af45f9a223a (diff)
downloadpatches-a7f862e4dade6942bb67322a97d733e7f89f564f.tar
patches-a7f862e4dade6942bb67322a97d733e7f89f564f.tar.gz
doc: emacs: Document autoloading Emacs packages.
* doc/emacs.texi (Emacs Initial Setup): Describe how Emacs packages installed in a user profile are autoloaded by "guix.el"
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs.texi20
1 files changed, 15 insertions, 5 deletions
diff --git a/doc/emacs.texi b/doc/emacs.texi
index ad2dcd8f65..a9f706e11c 100644
--- a/doc/emacs.texi
+++ b/doc/emacs.texi
@@ -56,11 +56,21 @@ Manual}):
(require 'guix-init)
@end example
-Do not worry about the efficiency of that @code{require} thing. It will
-not load the whole ``guix.el'' package, it will just autoload the main
-interactive commands (@pxref{Autoload,,, elisp, The GNU Emacs Lisp
-Reference Manual}).
-
+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 inbuilt 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-load-autoloads}.
@node Emacs Usage
@subsection Usage