summaryrefslogtreecommitdiff
path: root/lisp/emacs-lisp/comp.el
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2021-02-26 16:50:41 +0200
committerEli Zaretskii <eliz@gnu.org>2021-02-26 16:50:41 +0200
commit5540d73441a8fb518cc876ba01561d0875739283 (patch)
treeb537828e0359741f7ac0fe6f0cc3af62f0818bbf /lisp/emacs-lisp/comp.el
parentad74b1b2b64cfe989213fc69337dbb0eda858d10 (diff)
downloademacs-5540d73441a8fb518cc876ba01561d0875739283.tar.gz
emacs-5540d73441a8fb518cc876ba01561d0875739283.tar.bz2
emacs-5540d73441a8fb518cc876ba01561d0875739283.zip
Fix last change
* lisp/emacs-lisp/comp.el (comp-async-report-warnings-errors): Improve wording of the doc string.
Diffstat (limited to 'lisp/emacs-lisp/comp.el')
-rw-r--r--lisp/emacs-lisp/comp.el22
1 files changed, 12 insertions, 10 deletions
diff --git a/lisp/emacs-lisp/comp.el b/lisp/emacs-lisp/comp.el
index 184aef489dc..d559fa02514 100644
--- a/lisp/emacs-lisp/comp.el
+++ b/lisp/emacs-lisp/comp.el
@@ -126,16 +126,18 @@ Usable to modify the compiler environment."
(defcustom comp-async-report-warnings-errors t
"Whether to report warnings and errors from asynchronous native compilation.
-When native compilation happens asynchronously this can produce
-warnings and errors, some of these diagnostic messages might not be
-emitted by the first synchronous byte-compilation. The typical case
-for that is byte-compiling a file that is missing to require a
-necessary feature while having it already loaded into the environment.
-
-As asynchronous native compilation always starts from a fresh
-environment it is more sensitive into highlighting issues about non
-consistent source files and might not be able to compile correctly
-these."
+When native compilation happens asynchronously, it can produce
+warnings and errors, some of which might not be emitted by a
+byte-compilation. The typical case for that is native-compiling
+a file that is missing some `require' of a necessary feature,
+while having it already loaded into the environment when
+byte-compiling.
+
+As asynchronous native compilation always starts from a pristine
+environment, it is more sensitive to such omissions, and might be
+unable to compile such Lisp source files correctly.
+
+Set this variable to nil if these warnings annoy you."
:type 'boolean)
(defcustom comp-async-query-on-exit nil