summaryrefslogtreecommitdiff
path: root/doc/lispref
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2023-12-22 16:49:49 +0200
committerEli Zaretskii <eliz@gnu.org>2023-12-22 16:49:49 +0200
commitbd0c75897153ea5ce1e4ba12c81c3b280a0b95e4 (patch)
treeb928561be25fe76ef91052af50e5021a94e4cd32 /doc/lispref
parent1ad126c0f28aae2b5d2da9b347a33e4300424de9 (diff)
downloademacs-bd0c75897153ea5ce1e4ba12c81c3b280a0b95e4.tar.gz
emacs-bd0c75897153ea5ce1e4ba12c81c3b280a0b95e4.tar.bz2
emacs-bd0c75897153ea5ce1e4ba12c81c3b280a0b95e4.zip
Improve documentation of new native-compilation commands
* lisp/progmodes/elisp-mode.el (emacs-lisp-mode-menu) (emacs-lisp-native-compile, emacs-lisp-native-compile-and-load): Doc fixes. * doc/lispref/compile.texi (Native-Compilation Functions): Document 'emacs-lisp-native-compile' and 'emacs-lisp-native-compile-and-load'.
Diffstat (limited to 'doc/lispref')
-rw-r--r--doc/lispref/compile.texi15
1 files changed, 13 insertions, 2 deletions
diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi
index 96d66445360..3a6a3733055 100644
--- a/doc/lispref/compile.texi
+++ b/doc/lispref/compile.texi
@@ -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.