From 4cb5144df0d352b49bddcd4e6d284481fb3d9f36 Mon Sep 17 00:00:00 2001 From: zimoun Date: Sat, 15 Oct 2022 15:34:56 +0200 Subject: 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 --- doc/guix.texi | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'doc') 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 -- cgit v1.2.3