From: Eli Zaretskii <eliz@gnu.org>
Date: Tue, 11 May 2021 14:41:42 +0000 (+0300)
Subject: Mention native compilation in the user manual
X-Git-Tag: emacs-28.0.90~2516
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=f84a385d79aaf406539cc4ce30c41642b64ed499;p=emacs.git

Mention native compilation in the user manual

* doc/emacs/building.texi (Lisp Libraries): Mention native
compilation.
---

diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index 7194eb90ca9..8de93867baa 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -1486,6 +1486,13 @@ Emacs Lisp code goes in a separate file whose name ends in
 @file{foo.elc}.  @xref{Byte Compilation,, Byte Compilation, elisp, the
 Emacs Lisp Reference Manual}.
 
+@cindex native compilation
+  Emacs Lisp code can also be compiled into @dfn{native code}: machine
+code not unlike the one produced by a C or Fortran compiler.  Native
+code runs even faster than byte-code.  Natively-compiled Emacs Lisp
+code is stored in files whose names end in @samp{.eln}.  @xref{Native
+Compilation,, Byte Compilation, elisp, the Emacs Lisp Reference Manual}.
+
 @findex load-file
   To @dfn{load} an Emacs Lisp file, type @kbd{M-x load-file}.  This
 command reads a file name using the minibuffer, and executes the