; Mention in NEWS the need to use --bindir

* etc/NEWS: Mention the need to use --bindir= at configure time
when installing outside of the ${prefix} tree.  (Bug#46790)

diff --git a/etc/NEWS b/etc/NEWS
index 770c96b07ba06acb7e03897e932ec921ca49c98e..962cfe58d10969b150a4ad2f31cdf78e702d8554 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -18,6 +18,24 @@ with a prefix argument or by typing 'C-u C-h C-n'.
 \f
 * Installation Changes in Emacs 28.2
 
+** To install the Emacs binary in a non-standard directory, use '--bindir='.
+If you install Emacs in a way that places the Emacs executable file in
+a directory other than ${prefix}/bin, you will now need to specify
+that at configure time, if you build Emacs with native-compilation
+support.  To this end, add the '--bindir=DIRECTORY' switch to the
+command line of the 'configure' script, where DIRECTORY is the
+directory in which you will install the executable file 'emacs'.  This
+is required even if you place a symlink under ${prefix}/bin that
+points to the real executable file in some other DIRECTORY.
+
+It is no longer enough to specify 'bindir=DIRECTORY' on the command
+line of the "make install" command.
+
+The reason for this new requirement is that Emacs needs to locate at
+startup the directory with its '*.eln' natively-compiled files for the
+preloaded Lisp packages, and the relative name of that directory needs
+therefore to be recorded in the executable as part of the build.
+
 \f
 * Startup Changes in Emacs 28.2