diff options
Diffstat (limited to 'doc/lispref/compile.texi')
-rw-r--r-- | doc/lispref/compile.texi | 21 |
1 files changed, 16 insertions, 5 deletions
diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi index a51691bddcf..0c86c02c90f 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990--1994, 2001--2023 Free Software Foundation, Inc. +@c Copyright (C) 1990--1994, 2001--2024 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @node Byte Compilation @chapter Byte Compilation @@ -422,7 +422,7 @@ execution of the compiled file. For example, @lisp (eval-when-compile (unless (fboundp 'some-new-thing) - (defmacro 'some-new-thing () + (defmacro some-new-thing () (compatibility code)))) @end lisp @@ -878,8 +878,7 @@ well. You can natively-compile either a single function or macro definition, or a whole file of Lisp code, with the @code{native-compile} function. Natively-compiling a file will -produce both the corresponding @file{.elc} file with byte code and the -@file{.eln} file with native code. +produce the @file{.eln} file with native code. @findex native-comp-limple-mode @vindex native-comp-verbose @@ -971,6 +970,18 @@ compilation subprocesses in parallel, under the control of Variables}). @end defun +@deffn Command emacs-lisp-native-compile +This command compiles the file visited by the current buffer into +native code, if the file was changed since the last time it was +natively-compiled. +@end deffn + +@deffn Command emacs-lisp-native-compile-and-load +This command compiles the file visited by the current buffer into +native code, like @code{emacs-lisp-native-compile}, but it also loads +the native code when the compilation finishes. +@end deffn + The following function allows Lisp programs to test whether native-compilation is available at runtime. @@ -1116,7 +1127,7 @@ functions provided by the @file{.elc} file. @end defvar @cindex trampolines, in native compilation - Setting the value of @code{native-comp-jit-compilation} to@code{nil} + Setting the value of @code{native-comp-jit-compilation} to @code{nil} disables JIT native compilation. However, even when JIT native compilation is disabled, Emacs might still need to start asynchronous native compilation subprocesses to produce @dfn{trampolines}. To |