diff options
| author | Andrea Corallo <akrl@sdf.org> | 2021-02-26 15:15:06 +0100 |
|---|---|---|
| committer | Andrea Corallo <akrl@sdf.org> | 2021-02-26 15:24:34 +0100 |
| commit | ad74b1b2b64cfe989213fc69337dbb0eda858d10 (patch) | |
| tree | 9a10534463a3518a1684626e49d9a6eb52e8ec03 /lisp/emacs-lisp/comp.el | |
| parent | 3266093af97420d2b8b4108f2fc0a7d02d4a34b3 (diff) | |
| download | emacs-ad74b1b2b64cfe989213fc69337dbb0eda858d10.tar.gz emacs-ad74b1b2b64cfe989213fc69337dbb0eda858d10.tar.bz2 emacs-ad74b1b2b64cfe989213fc69337dbb0eda858d10.zip | |
* Improve `comp-async-report-warnings-errors' docstring
* lisp/emacs-lisp/comp.el (comp-async-report-warnings-errors):
Improve docstring.
Diffstat (limited to 'lisp/emacs-lisp/comp.el')
| -rw-r--r-- | lisp/emacs-lisp/comp.el | 13 |
1 files changed, 12 insertions, 1 deletions
diff --git a/lisp/emacs-lisp/comp.el b/lisp/emacs-lisp/comp.el index c242c5c871e..184aef489dc 100644 --- a/lisp/emacs-lisp/comp.el +++ b/lisp/emacs-lisp/comp.el @@ -124,7 +124,18 @@ Usable to modify the compiler environment." :type 'list) (defcustom comp-async-report-warnings-errors t - "Whether to report warnings and errors from asynchronous native compilation." + "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." :type 'boolean) (defcustom comp-async-query-on-exit nil |