summaryrefslogtreecommitdiff
path: root/lisp/emacs-lisp
diff options
context:
space:
mode:
authorPhilipp Stephani <phst@google.com>2022-06-21 19:10:14 +0200
committerPhilipp Stephani <phst@google.com>2022-06-21 19:11:05 +0200
commitdbbf38d43f1f49a38efd260bda655e0b3cd2b6d5 (patch)
tree9dd49312d01f9b91bbce866539281f8a83c0a827 /lisp/emacs-lisp
parent16d48cf8a0153917d5047b557860668acb461e15 (diff)
downloademacs-dbbf38d43f1f49a38efd260bda655e0b3cd2b6d5.tar.gz
emacs-dbbf38d43f1f49a38efd260bda655e0b3cd2b6d5.tar.bz2
emacs-dbbf38d43f1f49a38efd260bda655e0b3cd2b6d5.zip
Document and test 'no-byte-compile' behavior.
* lisp/emacs-lisp/bytecomp.el (byte-compile-file): Document behavior if 'no-byte-compile' is set. * test/lisp/emacs-lisp/bytecomp-tests.el (byte-compile-file/no-byte-compile): New unit test. * test/lisp/emacs-lisp/bytecomp-resources/no-byte-compile.el: New test file.
Diffstat (limited to 'lisp/emacs-lisp')
-rw-r--r--lisp/emacs-lisp/bytecomp.el3
1 files changed, 3 insertions, 0 deletions
diff --git a/lisp/emacs-lisp/bytecomp.el b/lisp/emacs-lisp/bytecomp.el
index 04c107a7cfa..4fd65bb5d53 100644
--- a/lisp/emacs-lisp/bytecomp.el
+++ b/lisp/emacs-lisp/bytecomp.el
@@ -2089,6 +2089,9 @@ If compilation is needed, this functions returns the result of
The output file's name is generated by passing FILENAME to the
function `byte-compile-dest-file' (which see).
The value is non-nil if there were no errors, nil if errors.
+If the file sets the file variable `no-byte-compile', it is not
+compiled, any existing output file is removed, and the return
+value is `no-byte-compile'.
See also `emacs-lisp-byte-compile-and-load'."
(declare (advertised-calling-convention (filename) "28.1"))