01/02: doc: Explain Emacs native-compilation.

[guix-commits]

lilyp pushed a commit to branch master
in repository guix.

commit 4cb5144df0d352b49bddcd4e6d284481fb3d9f36
Author: zimoun <zimon.toutoune@gmail.com>
AuthorDate: Sat Oct 15 15:34:56 2022 +0200

    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>
---
 doc/guix.texi | 13 +++++++++++++
 1 file changed, 13 insertions(+)

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