diff --git a/doc/lispref/compile.texi b/doc/lispref/compile.texi index 3670225dc49..9bb7b590a2c 100644 --- a/doc/lispref/compile.texi +++ b/doc/lispref/compile.texi @@ -979,7 +979,9 @@ Its value should be a number between @minus{}1 and 3. Values between 0 and 3 specify the optimization levels equivalent to the corresponding compiler @option{-O0}, @option{-O1}, etc.@: command-line options of the compiler. The value @minus{}1 means disable -native-compilation; functions and files will be only byte-compiled. +native-compilation: functions and files will be only byte-compiled; +however, the @file{*.eln} files will still be produced, they will just +contain the compiled code in bytecode form. The default value is 2. @end defopt diff --git a/etc/PROBLEMS b/etc/PROBLEMS index 14c1df25b16..e4558d5fc2f 100644 --- a/etc/PROBLEMS +++ b/etc/PROBLEMS @@ -2970,6 +2970,72 @@ please call support for your X-server and see if you can get a fix. If you do, please send it to bug-gnu-emacs@gnu.org so we can list it here. +* Runtime problems specific to Cygwin + +** Fork failures in a build with native compilation + +To prevent fork failures, shared libraries on Cygwin need to be +rebased occasionally, for the reasons explained here: + + https://cygwin.com/cygwin-ug-net/highlights.html#ov-hi-process-problems + +This includes the .eln files produced by an Emacs built with native +compilation. + +Rebasing is handled by Cygwin's autorebase postinstall script every +time you run the Cygwin setup program (which you should do with no +Cygwin processes running). This script knows about the .eln files +installed in the standard places (e.g., +/usr/lib/emacs/28.1/native-lisp), but it does not know about those in +your user cache (e.g., /home//.emacs.d/eln-cache). In order +for these to be automatically rebased, you must create a file + + /var/lib/rebase/userpath.d/ + +with one line for each directory containing .eln files. If you are +running an installed Emacs, it should suffice to list your cache +directory. For example, if there is an Emacs user "kbrown", then +there should be a file + + /var/lib/rebase/userpath.d/kbrown + +containing the single line + + /home/kbrown/.emacs.d/eln-cache + +If you are running an Emacs that you have built but not installed, +then you will need an additional line giving the path to the +native-lisp subdirectory of your build directory. + +If more than one user will be using Emacs on your system, there should +be a file like this for each user. + +Rebasing is not currently done when new .eln files are created, so +fork failures are still possible between runs of Cygwin's setup +program. If you ever see a fork failure whose error message refers to +a .eln file, you should be able to fix it temporarily by exiting emacs +and issuing the command + + find ~/.emacs.d/eln-cache -name '*.eln' | rebase -O -T - + +This is called an "ephemeral" rebase. Again, if you are running an +Emacs that has not been installed, you need to add the native-lisp +subdirectory of your build directory to this command. Alternatively, +stop all Cygwin processes and run Cygwin's setup program to let the +autorebase postinstall script run. + +It is hoped that the measures above will make native compilation +usable on 64-bit Cygwin, with only an occasional minor annoyance. In +the 32-bit case, however, the limited address space makes frequent +fork failures extremely likely. It is therefore strongly recommended +that you not build Emacs with native compilation on 32-bit Cygwin. +Indeed, the configure script will not allow this unless you use the +--with-cygwin32-native-compilation option. + +See bug#50666 (https://debbugs.gnu.org/cgi/bugreport.cgi?bug=50666) +for further discussion. + + * Runtime problems specific to macOS ** Error message when opening Emacs on macOS diff --git a/lisp/emacs-lisp/comp.el b/lisp/emacs-lisp/comp.el index 73285e0f24d..c722c0b259c 100644 --- a/lisp/emacs-lisp/comp.el +++ b/lisp/emacs-lisp/comp.el @@ -45,7 +45,9 @@ (defcustom native-comp-speed 2 "Optimization level for native compilation, a number between -1 and 3. - -1 functions are kept in bytecode form and no native compilation is performed. + -1 functions are kept in bytecode form and no native compilation is performed + (but *.eln files are still produced, and include the compiled code in + bytecode form). 0 native compilation is performed with no optimizations. 1 light optimizations. 2 max optimization level fully adherent to the language semantic. diff --git a/lisp/find-dired.el b/lisp/find-dired.el index 2f3f6b689aa..63f2148e47c 100644 --- a/lisp/find-dired.el +++ b/lisp/find-dired.el @@ -170,7 +170,12 @@ except that the car of the variable `find-ls-option' specifies what to use in place of \"-ls\" as the final argument. Collect output in the \"*Find*\" buffer. To kill the job before -it finishes, type \\[kill-find]." +it finishes, type \\[kill-find]. + +For more information on how to write valid find expressions for +ARGS, see Info node `(find) Finding Files'. If you are not +using GNU findutils (on macOS and *BSD systems), see instead the +man page for \"find\"." (interactive (list (read-directory-name "Run find in directory: " nil "" t) (read-string "Run find (with args): " find-args '(find-args-history . 1))))