summary refs log tree commit diff
path: root/doc/guix.texi
diff options
context:
space:
mode:
authorzimoun <zimon.toutoune@gmail.com>2022-10-15 15:34:56 +0200
committerLiliana Marie Prikler <liliana.prikler@gmail.com>2022-10-15 15:34:56 +0200
commit4cb5144df0d352b49bddcd4e6d284481fb3d9f36 (patch)
treee996713bbf159729de91d4e2ec7be7b32cfbd0b8 /doc/guix.texi
parent18f95f933535da7a5882a5e1f2cdb3c3c2d0f59f (diff)
downloadguix-4cb5144df0d352b49bddcd4e6d284481fb3d9f36.tar.gz
doc: Explain Emacs native-compilation.
* doc/guix.texi ("Application Setup")["Emacs Packages"]: Add a note
explaining that Emacs can compile packages to native code now.

Signed-off-by: Liliana Marie Prikler <liliana.prikler@gmail.com>
Diffstat (limited to 'doc/guix.texi')
-rw-r--r--doc/guix.texi13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index dbf4ca9be9..bdff4004d0 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -2096,6 +2096,19 @@ want to avoid auto-loading the Emacs packages installed with Guix, you
 can do so by running Emacs with the @option{--no-site-file} option
 (@pxref{Init File,,, emacs, The GNU Emacs Manual}).
 
+@quotation Note
+Emacs can now compile packages natively.  Under the default
+configuration, this means that Emacs packages will now be
+just-in-time (JIT) compiled as you use them, and the results
+stored in a subdirectory of your @code{user-emacs-directory}.
+
+Furthermore, the build system for Emacs packages transparently
+supports native compilation, but note, that
+@code{emacs-minimal}---the default Emacs for building
+packages---has been configured without native compilation.
+To natively compile your emacs packages ahead of time, use a
+transformation like @option{--with-input=emacs-minimal=emacs}.
+@end quotation
 
 @node Upgrading Guix
 @section Upgrading Guix