diff options
author | Stefan Kangas <stefan@marxist.se> | 2021-12-08 13:04:14 +0100 |
---|---|---|
committer | Stefan Kangas <stefan@marxist.se> | 2021-12-08 13:04:14 +0100 |
commit | 05af96456c0c056b61be30e53e2592a8d155de54 (patch) | |
tree | 1bff5bc7e8ac836b99ef10631dd990ea016d8230 /doc | |
parent | 58cf601aada8cc80663c4e5e9a69ac7ce7f70b51 (diff) | |
parent | ce5bca491344520cab2cdd998441761765fc66f3 (diff) | |
download | emacs-05af96456c0c056b61be30e53e2592a8d155de54.tar.gz |
Merge from origin/emacs-28
ce5bca4913 Document native-comp-async-report-warning-errors more
1933cd5307 Doc fix; Epiphany has been renamed to GNOME Web
b80d7568e4 * lisp/dired-aux.el (dired-check-process): Doc fix. (Bug#...
0f30227f97 ; * lisp/net/browse-url.el (browse-url-epiphany): Fix typo.
d34009db66 Remove dead link from newsticker
# Conflicts:
# lisp/net/browse-url.el
Diffstat (limited to 'doc')
-rw-r--r-- | doc/lispref/compile.texi | 12 |
1 files changed, 11 insertions, 1 deletions
diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi index 523758c10f5..1ca1f66b95d 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi @@ -924,7 +924,11 @@ of the main Emacs process. This leaves the main Emacs process free to use while the compilation runs in the background. This is the method used by Emacs to natively-compile any Lisp file or byte-compiled Lisp file that is loaded into Emacs, when no natively-compiled file for it -is available. +is available. Note that because of this use of a subprocess, native +compilation may produce warning and errors which byte-compilation does +not, and lisp code may thus need to be modified to work correctly. See +@code{native-comp-async-report-warnings-errors} in @pxref{Native-Compilation +Variables} for more details. @defun native-compile-async files &optional recursively load selector This function compiles the named @var{files} asynchronously. The @@ -1038,6 +1042,12 @@ Emacs session in a buffer named @file{*Warnings*}. The default value @code{t} means display the resulting buffer. To log warnings without popping up the @file{*Warnings*} buffer, set this variable to @code{silent}. + + A common cause for asynchronous native-compilation to produce +warnings is compiling a file that is missing some @code{require} of a +necessary feature. The feature may be loaded into the main emacs, but +because native compilation always starts from a subprocess with a +pristine environment, that may not be true for the subprocess. @end defopt @defopt native-comp-async-query-on-exit |