emacs-28 a280df4cab: ; Mention in NEWS the need to use --bindir

[Eli Zaretskii]

branch: emacs-28
commit a280df4cab8e492123ded9e236c671b275183d53
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; 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)
---
 etc/NEWS | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/etc/NEWS b/etc/NEWS
index 770c96b07b..962cfe58d1 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -18,6 +18,24 @@ with a prefix argument or by typing 'C-u C-h C-n'.
 
 * 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.
+
 
 * Startup Changes in Emacs 28.2