GNU bug report logs - #70246
30.0.50; Update INSTALL for native compilation

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Package: emacs; Reported by: Stephen Berman <stephen.berman@HIDDEN>; dated Sat, 6 Apr 2024 20:54:01 UTC; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

Message received at 70246 <at> debbugs.gnu.org:


Received: (at 70246) by debbugs.gnu.org; 8 Apr 2024 12:01:37 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Apr 08 08:01:37 2024
Received: from localhost ([127.0.0.1]:45480 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rtngv-0008Gj-Ex
	for submit <at> debbugs.gnu.org; Mon, 08 Apr 2024 08:01:37 -0400
Received: from mout.gmx.net ([212.227.15.19]:56771)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stephen.berman@HIDDEN>) id 1rtngq-0008Fo-US
 for 70246 <at> debbugs.gnu.org; Mon, 08 Apr 2024 08:01:35 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1712577679; x=1713182479; i=stephen.berman@HIDDEN;
 bh=E9+NSO3nOljdctwokh8ZHhFiLWc/ZOh+VqiGB/aHzPI=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:
 Date;
 b=EtBrpukfGTfxx3SWvhUWhI0qZq0+to+qkeab4sSdy++f9bPp6J461wMEtCa/pvRA
 wPcW8sHo0+/lAkF+yjwvPhxEx8FTpGHfz5sKb8P90m6O332MRxJMwcET59mGvHsHK
 FSVqBMgfVTM9nx/b+FhiKNXIrjiQPL3x7STW+WvBiUaFpuJ/j38YhP67fQ7sN6fhT
 68cvBTaLU/sZMDEnIgfyIwJ9Dy9ICCIQHXRZn1DpN2Av4kv7LrDzReJFnw4vWOosH
 9qoGylS+g3JF01iclgiwgHmxSyX0EQRh5g1JLndKYFQ2K8SF0ZMrDVfARt4tKZaqt
 PW3sHgsdb3QTe2pW5Q==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs ([94.134.94.159]) by mail.gmx.net (mrgmx005
 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MYNNo-1sFCSy3rRi-00VR9Y; Mon, 08
 Apr 2024 14:01:19 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#70246: 30.0.50; Update INSTALL for native compilation
In-Reply-To: <86frvwyusr.fsf@HIDDEN> (Eli Zaretskii's message of "Mon, 08 Apr
 2024 14:10:12 +0300")
References: <87plv29pro.fsf@HIDDEN> <86il0t1z96.fsf@HIDDEN>
 <87r0fhpf52.fsf@HIDDEN> <86v84tz0ma.fsf@HIDDEN>
 <87frvxouin.fsf@HIDDEN> <86frvwyusr.fsf@HIDDEN>
Date: Mon, 08 Apr 2024 14:01:18 +0200
Message-ID: <87edbg83n5.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-Provags-ID: V03:K1:iYxFOSTZBHSbAaBLOTDNCr2qKLjGaf3+kIVyAbwrEFAvlhpWhqp
 dUtpcGgGR+jwS2xBlOPYtEgH+MjZZ7b1oURrhAVETrshlAXs/9PwJEO6pEXVA77Nc5zkrXf
 ZY8Vz8z8AghyFpjsSkXTF/O4eN6i4eJ/+8iiGlwnoJv/JECQAvcei/VEOadCLa2mXzXPb3S
 3UlPRzlwK2TY+R3tedciA==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:fdg3POilDqE=;vzJfYlRqkrBuCXh7IriF3EPNf0C
 sGUllohpn0dCC8yyWtQOqPYh3pCENQf6Bbzot7Qtxm29g+qLsBayHs5hk5EpEQWsCetdG3Yvm
 jGOY0WEirqwnU8hSPP1nKFXvnkDTM9hNrIwL1TKjtOPWmZaIbKt0oo31vUjfPoLs7zcztJPnY
 B9VjzI8+f0bsY0TNxu11/reNdFH4yDXHlS8imRwXBxD3aQroEvAD7pHwHZ6wyb2Pp6u6xKL5W
 1xSc3Z+QiAp8qy8grAOvbtEkJYEgThCyXMYZmRteplj9JLDxSSMLtuHkrnGbrLCg5gkIbsNsf
 bC8iRTNqCvZcgZqYrStWHsfDqUxncukIn2MoEvHK6zUd1ZkOYK5F8ss9V8SNEkBjHXPF08BQJ
 zTB2OXQ26zgJ+bxkndXUJYbBLg+AVzefRXY9XCgh1q0ikJYYmp3ODPGJVSjfezeZOLUyjPjR8
 mcBwGu08FNE2GDQckleEZxLWaGQkImlak/lUyu7L3qlYHdDOSLZaKb9MaeuvVQRM6NbOdLJij
 Sb4QJ1X7xbo6lavZ6rz7B+c3XuSvDogiO3/SoR9kBcJ51OV+8srjbOS7Xinl+dIotnPIFkrnS
 xxvXBiuDJZRN389fCG87ymHiQQg+T5BKAaDjaMGoSYIzP5l4u3b9uFZ3V6XpKLdHiREA/rBw5
 5+ihYW+a6Tva+db4QI4XPNzHtQpvurnm5OxRaZOv3VVHFZVl2PtaxvUh7R2OG2lhMl3marGd0
 eE4bCSwSkkVSPKdqgOMtOYyJiwT0uoTUjzqUG2UfEEu483+ImW8eLJg46xCJ5IUOyuQZ4X8Pb
 SlhBIcevJlmY3SkV73rl43LMWB6E5XlmfUUsjfuoGIZTk=
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.8 (/)
X-Debbugs-Envelope-To: 70246
Cc: 70246 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.2 (/)

On Mon, 08 Apr 2024 14:10:12 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:

>> From: Stephen Berman <stephen.berman@HIDDEN>
>> Cc: 70246 <at> debbugs.gnu.org
>> Date: Sun, 07 Apr 2024 21:14:08 +0200
>>
[...]
>> @@ -574,6 +601,11 @@ are installed in the following directories:
>>  		at the same time; in particular, you don't have to
>>  		make Emacs unavailable while installing a new version.
>>
>> +'/usr/local/lib/emacs/VERSION/native-lisp' holds the natively compiled
>> +		pre-loaded Emacs Lisp files.
>> +
>> +'~/.emacs.d/eln-cache/' holds the remaining natively compiled Lisp fil=
es.
>> +
>>  '/usr/local/share/emacs/VERSION/etc' holds the Emacs tutorial, the DOC
>>  		file, and other architecture-independent files Emacs
>>  		might need while running.
>
> Here you didn't make the change I suggested:
>
>> > +'/usr/local/lib/emacs/VERSION/native-lisp' holds the natively compil=
ed
>> > +		pre-loaded Emacs Lisp files.
>>
>> The above also contains the other Lisp files if using the
>> "--with-native-compilation=3Daot" configure-time option.
>>
>> > +'~/.emacs.d/eln-cache/' holds the remaining natively compiled Lisp f=
iles.
>>
>> Instead of "remaining" I'd say "just-in-time natively compiled Lisp
>> files".
>
> Without that, these are a bit inaccurate, and could be misinterpreted.

Oops, those were unintentional omissions.  I'm glad I asked you to
eyeball the patch again, and thanks for catching them!  Now corrected.

> Other that that, the patch LGTM, thanks.

Thanks, pushed as commit b9b2bc7192e to master.

Steve Berman
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70246; Package emacs. Full text available.

Message received at 70246 <at> debbugs.gnu.org:


Received: (at 70246) by debbugs.gnu.org; 8 Apr 2024 11:10:28 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Apr 08 07:10:28 2024
Received: from localhost ([127.0.0.1]:45371 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rtmtQ-0001VR-7i
	for submit <at> debbugs.gnu.org; Mon, 08 Apr 2024 07:10:28 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:51680)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1rtmtP-0001VG-0T
 for 70246 <at> debbugs.gnu.org; Mon, 08 Apr 2024 07:10:27 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1rtmtC-0003IM-AB; Mon, 08 Apr 2024 07:10:14 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date:
 mime-version; bh=FTME+i+n5yfSWVKxxhF38DiNkSKLIuZz1fterd0yv4M=; b=LM1YT00CyJ6D
 1bbWwLHZeH9gZTgO+sj/Xth1ZlP63+jRiAaPzrXv0hkZzZoVWZYbprHuwioYB/lA3Lbcuzc+gZ1VI
 QQwlMvnigrmoxuDS3Qmb0rkm2LYjfRjmngOWS3C/ge0aMyM7fa7cjcV9TIsOf9EMHZltHqaGDPs8f
 GNRfR77goRpJvE/xOu7ZdgOIrh3gM+R1u0VAd8yxJRGiodhMLzdIZlB2Bt547x/23mrURMufYt24/
 7yhCF26SU+epXACf0FMATs3h37UnnxUviY8M00kcuPDXffP/gRP8iGoDrc27ZzzmbzGDzjmfqL0E2
 Rcz0vLELsCPR3quS5czcmA==;
Date: Mon, 08 Apr 2024 14:10:12 +0300
Message-Id: <86frvwyusr.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Stephen Berman <stephen.berman@HIDDEN>
In-Reply-To: <87frvxouin.fsf@HIDDEN> (message from Stephen Berman on Sun, 07
 Apr 2024 21:14:08 +0200)
Subject: Re: bug#70246: 30.0.50; Update INSTALL for native compilation
References: <87plv29pro.fsf@HIDDEN> <86il0t1z96.fsf@HIDDEN>
 <87r0fhpf52.fsf@HIDDEN> <86v84tz0ma.fsf@HIDDEN> <87frvxouin.fsf@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 70246
Cc: 70246 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Stephen Berman <stephen.berman@HIDDEN>
> Cc: 70246 <at> debbugs.gnu.org
> Date: Sun, 07 Apr 2024 21:14:08 +0200
> 
> > The bottom line is that the Lisp and Info files will be taken from the
> > source tree, not from the build tree.  So if you have more than one
> > build from the same source tree, then they all share the Lisp and Info
> > files.  Therefore, if you modify anything in the source tree, you must
> > rebuild all the out-of-tree builds, otherwise those you don't rebuild
> > will be inconsistent with the modified sources.
> 
> Yes, but if you instead make copies of the sources (or different repo
> branches) to build different configurations and make changes that you
> want to test in all configurations, then you have to make those changes
> in each copy or branch and rebuild them all, too.  So there are
> trade-offs in both procedures.

My point was not that there aren't tradeoffs, my point was that
building out of source has certain subtleties that need to be
understood to avoid surprises.

> @@ -574,6 +601,11 @@ are installed in the following directories:
>  		at the same time; in particular, you don't have to
>  		make Emacs unavailable while installing a new version.
> 
> +'/usr/local/lib/emacs/VERSION/native-lisp' holds the natively compiled
> +		pre-loaded Emacs Lisp files.
> +
> +'~/.emacs.d/eln-cache/' holds the remaining natively compiled Lisp files.
> +
>  '/usr/local/share/emacs/VERSION/etc' holds the Emacs tutorial, the DOC
>  		file, and other architecture-independent files Emacs
>  		might need while running.

Here you didn't make the change I suggested:

> > +'/usr/local/lib/emacs/VERSION/native-lisp' holds the natively compiled
> > +		pre-loaded Emacs Lisp files.
> 
> The above also contains the other Lisp files if using the
> "--with-native-compilation=aot" configure-time option.
> 
> > +'~/.emacs.d/eln-cache/' holds the remaining natively compiled Lisp files.
> 
> Instead of "remaining" I'd say "just-in-time natively compiled Lisp
> files".

Without that, these are a bit inaccurate, and could be misinterpreted.

Other that that, the patch LGTM, thanks.
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70246; Package emacs. Full text available.

Message received at 70246 <at> debbugs.gnu.org:


Received: (at 70246) by debbugs.gnu.org; 8 Apr 2024 02:28:39 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Apr 07 22:28:38 2024
Received: from localhost ([127.0.0.1]:45063 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rtekQ-0001ju-9B
	for submit <at> debbugs.gnu.org; Sun, 07 Apr 2024 22:28:38 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:47724)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1rtekN-0001it-Rk
 for 70246 <at> debbugs.gnu.org; Sun, 07 Apr 2024 22:28:36 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1rtekA-00075J-Te; Sun, 07 Apr 2024 22:28:22 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From:
 Date; bh=YMU11RHrZfWYeK3/JbDfgqJ6Um5uKD3hRQgXpIUS0VQ=; b=J7t5wj5U9J2rS+8rxsiW
 nAcIffnXkqe5I8cSdd5lux43U65iLxaULuf1vcInEcOh51ih3tgmkomWRStsDiY4ZNKzh+5QV9xDV
 aWn6Bn+jAa4Ko0TW0S+FfIy/XQ5L0ULqnSCoVTN6a+3wmOUSIyTjnhCpHb31RmhbuDsPzpPFqmeZY
 OAu4mnmzgRk8jQ3Ord54eLvCWLJ/Sit7/pw179KSWrN1gGJNvifXloZnAAy1QZhNhEepWtKE7Sn5n
 pNwluGPiWYXDtLLJuj2XRvCTfTZRU3W07STX74JNGgk/RS/rTQpOXq/pJPvldEuage7m3dYj8Bo+T
 2B5VKpJT0QARYA==;
Date: Mon, 08 Apr 2024 05:28:19 +0300
Message-Id: <86il0sziyk.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: =?utf-8?Q?Bj=C3=B6rn?= Bidar <bjorn.bidar@HIDDEN>
In-Reply-To: <87cyr1gefc.fsf@> (message from =?utf-8?Q?Bj=C3=B6rn?= Bidar on
 Sun, 07 Apr 2024 22:28:55 +0300)
Subject: Re: bug#70246: 30.0.50; Update INSTALL for native compilation
References: <87plv29pro.fsf@HIDDEN> <86il0t1z96.fsf@HIDDEN> <87cyr1gefc.fsf@>
MIME-version: 1.0
Content-type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 70246
Cc: 70246 <at> debbugs.gnu.org, stephen.berman@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Björn Bidar <bjorn.bidar@HIDDEN>
> Cc: Stephen Berman <stephen.berman@HIDDEN>,  70246 <at> debbugs.gnu.org
> Date: Sun, 07 Apr 2024 22:28:55 +0300
> 
> Eli Zaretskii <eliz@HIDDEN> writes:
> 
> >> +'/usr/local/share/emacs/VERSION/native-lisp' holds the natively compiled
> >> +		pre-loaded Emacs Lisp files.
> >
> > This is incorrect: native-lisp is installed under /usr/lib/emacs/VERSION,
> > not under /usr/share/emacs/VERSION.
> I would add a note that it might be /usr/lib64/emacs/30.0.50 depending
> on the system.

Not by default, AFAIU.  I think you are looking at an installation of
a distro, in which case those who built the distro used the --prefix
option to install in different places.

The file INSTALL describes the defaults set by the configure script,
it cannot possibly describe what distros or individual users do on
their systems.
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70246; Package emacs. Full text available.

Message received at 70246 <at> debbugs.gnu.org:


Received: (at 70246) by debbugs.gnu.org; 7 Apr 2024 19:29:14 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Apr 07 15:29:14 2024
Received: from localhost ([127.0.0.1]:44688 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rtYCU-0003My-Gn
	for submit <at> debbugs.gnu.org; Sun, 07 Apr 2024 15:29:14 -0400
Received: from thaodan.de ([185.216.177.71]:43632)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <bjorn.bidar@HIDDEN>) id 1rtYCT-0003Md-Mc
 for 70246 <at> debbugs.gnu.org; Sun, 07 Apr 2024 15:29:10 -0400
Received: from odin (dsl-trebng12-50dc75-154.dhcp.inet.fi [80.220.117.154])
 by thaodan.de (Postfix) with ESMTPSA id 9AB08D08D87;
 Sun,  7 Apr 2024 22:28:56 +0300 (EEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=thaodan.de; s=mail;
 t=1712518136; bh=l5es/cuzQNiz55qJkpKcq0xDRe80PtIVLcBQlEdHam0=;
 h=From:To:Cc:Subject:In-Reply-To:References:Date;
 b=DXAPitr0x224dvQu6TGckAIRYu+3ZsB5LzKW++Bbuzy0DQu51sgsBqLpZRNaWA50I
 Vx+6eUuIiC/IrDcVKfOL2VbYbmmVV60EdLCwRfvHajTNaYYJlA8oscNsDABLUUtZja
 bJxCmhsOYTFIcsfz0Hmm+yDo0TBe08j9CR0p8+LwKrEG6dAyXXcNwyEuzQIsvn/Zp4
 L+hLiJnOlOEpAD2dBaH3dhMtNJmF0xgFH/0FjkO7YFLDuAFeKJwKw0xcUGsqIPgHeK
 /YXnCRrz/8AAIOmF4POZjd9dlmviDwrlQzS1xEK8Imht/9f9oXTypmRF6NOqVVswzC
 eCHgGgia/J52/ib3USPDnVVmcBv1mcZezBog0ikFQBf+kemm6kCDmY8SBi6v3dLsUX
 sIrO0mD5lfFPVPqrIrkX4+yfLBErSPJSwYW9XP+ewOcpeiGrXAfpjw9SqybEJPjflF
 HP7mjjDwDWRdmxS8+GB5eaYCuYjEIQRiGMlCY1UiWwNJuI+xEEC3Wn71gDGrL37xVq
 xtqAaai5NYZ6fHiNa8dcFznf9mrofPulx8flKketOrWS7Hg9uARJGj7eHtm5d/KpAo
 pE5vYqPUu1CX22aUqxTJEBE6pAL1BcsimZ5qjjTPF+BOrkcK6oDYQLR/hG0JwEgUl1
 KHK4ZwJUDxi5DotEzP7QtRkM=
From: =?utf-8?Q?Bj=C3=B6rn?= Bidar <bjorn.bidar@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#70246: 30.0.50; Update INSTALL for native compilation
In-Reply-To: <86il0t1z96.fsf@HIDDEN> (Eli Zaretskii's message of "Sun, 07 Apr
 2024 09:08:05 +0300")
References: <87plv29pro.fsf@HIDDEN> <86il0t1z96.fsf@HIDDEN>
Autocrypt: addr=bjorn.bidar@HIDDEN; prefer-encrypt=nopreference; keydata=
 mDMEZNfpPhYJKwYBBAHaRw8BAQdACBEmr+0xwIIHZfIDlZmm7sa+lHHSb0g9FZrN6qE6ru60JUJq
 w7ZybiBCaWRhciA8Ympvcm4uYmlkYXJAdGhhb2Rhbi5kZT6IlgQTFgoAPgIbAwULCQgHAgIiAgYV
 CgkICwIEFgIDAQIeBwIXgBYhBFHxdut1RzAepymoq1wbdKFlHF9oBQJk1/YmAhkBAAoJEFwbdKFl
 HF9oB9cBAJoIIGQKXm4cpap+Flxc/EGnYl0123lcEyzuduqvlDT0AQC3OlFKm/OiqJ8IMTrzJRZ8
 phFssTkSrrFXnM2jm5PYDoiTBBMWCgA7FiEEUfF263VHMB6nKairXBt0oWUcX2gFAmTX6T4CGwMF
 CwkIBwICIgIGFQoJCAsCBBYCAwECHgcCF4AACgkQXBt0oWUcX2hbCQEAtru7kvM8hi8zo6z9ux2h
 K+B5xViKuo7Z8K3IXuK5ugwA+wUfKzomzdBPhfxDsqLcEziGRxoyx0Q3ld9aermBUccHtBxCasO2
 cm4gQmlkYXIgPG1lQHRoYW9kYW4uZGU+iJMEExYKADsCGwMFCwkIBwICIgIGFQoJCAsCBBYCAwEC
 HgcCF4AWIQRR8XbrdUcwHqcpqKtcG3ShZRxfaAUCZNf2FQAKCRBcG3ShZRxfaCzSAP4hZ7cSp0YN
 XYpcjHdsySh2MuBhhoPeLGXs+2kSiqBiOwD/TP8AgPEg/R+SI9GI9on7fBJJ0mp2IT8kZ2rhDOjg
 gA6IkwQTFgoAOxYhBFHxdut1RzAepymoq1wbdKFlHF9oBQJk1+ntAhsDBQsJCAcCAiICBhUKCQgL
 AgQWAgMBAh4HAheAAAoJEFwbdKFlHF9oBgwA/iQHwe0VL4Df4GGTYlNjMSHFlIkBmN4UfYGLYj3E
 TrOUAQC51M+M3cjsL8WHdpBz6VAo6df9d+rVwhQ9vQuFHqevArg4BGTX6T4SCisGAQQBl1UBBQEB
 B0Cbohc3JEfn005/cm0AOGjSsW1ZxAkgaoVNjbpqk4MgNAMBCAeIeAQYFgoAIBYhBFHxdut1RzAe
 pymoq1wbdKFlHF9oBQJk1+k+AhsMAAoJEFwbdKFlHF9ooHABAKGmrGBic/Vys3BBrOQiRB3Z7izO
 HwhqTRpAqFZtXS2nAQDZhp/5aYw1TZjTzkm1KVt9QiYnjd/MvxRE9iaY6x4mDbgzBGTX6T4WCSsG
 AQQB2kcPAQEHQAgRJq/tMcCCB2XyA5WZpu7GvpRx0m9IPRWazeqhOq7uiO8EGBYKACAWIQRR8Xbr
 dUcwHqcpqKtcG3ShZRxfaAUCZNf71AIbIgCBCRBcG3ShZRxfaHYgBBkWCgAdFiEEUfF263VHMB6n
 KairXBt0oWUcX2gFAmTX+9QACgkQXBt0oWUcX2jeSwD6AtWn0cuo8IF35YRo4o3cDRJnUfJnbvJy
 GxyCDThR+zYBAKG6/jdwmZkBQZKslnDAbMMd2WfiZZT5JW3IWC4EaKMO7HkBAKYPGZ3UbfkRvfFK
 S+pQ9CgtNfkSJQBtT1Ob7Y6nsacgAQCpyXN7yppmhW/oBgivITPy9Lkg+V4NK9WZYZCU9Q7LBA==
Date: Sun, 07 Apr 2024 22:28:55 +0300
Message-ID: <87cyr1gefc.fsf@>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Score: 1.2 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 Content preview:  Eli Zaretskii <eliz@HIDDEN> writes: >> Date: Sat, 06 Apr
 2024 22:53:31 +0200 >> From: Stephen Berman via "Bug reports for GNU Emacs,
 >> the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN> >> >> The
 INSTALL file in the Emacs so [...] 
 Content analysis details:   (1.2 points, 10.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -0.0 SPF_PASS               SPF: sender matches SPF record
 -0.0 SPF_HELO_PASS          SPF: HELO matches SPF record
 1.2 INVALID_MSGID          Message-Id is not valid, according to RFC 2822
X-Debbugs-Envelope-To: 70246
Cc: 70246 <at> debbugs.gnu.org, Stephen Berman <stephen.berman@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 0.2 (/)

Eli Zaretskii <eliz@HIDDEN> writes:

>> Date: Sat, 06 Apr 2024 22:53:31 +0200
>> From:  Stephen Berman via "Bug reports for GNU Emacs,
>>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
>> 
>> The INSTALL file in the Emacs sources makes no reference to native
>> compilation.  The attached patch is an attempt to fill this gap (but I'm
>> not sure about the default locations of installed natively compiled Lisp
>> files, since I do not install Emacs when I build and do not have a
>> distribution installation of Emacs built with native compilation to
>> check).
>
> Thanks.  This LGTM, except the changes to item 6: there, I would only
> mention the possibility of building out of the source tree.  Whether
> running uninstalled is possible in this case depends where is the
> build tree relative to the source tree, so I'd rather not describe all
> the gory details there because they are too complex to explain (what
> you wrote is inaccurate); I'd just say that running uninstalled is
> fully supported only when Emacs is built in the source tree.
>
>> +'/usr/local/share/emacs/VERSION/native-lisp' holds the natively compiled
>> +		pre-loaded Emacs Lisp files.
>
> This is incorrect: native-lisp is installed under /usr/lib/emacs/VERSION,
> not under /usr/share/emacs/VERSION.
I would add a note that it might be /usr/lib64/emacs/30.0.50 depending
on the system.
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70246; Package emacs. Full text available.

Message received at 70246 <at> debbugs.gnu.org:


Received: (at 70246) by debbugs.gnu.org; 7 Apr 2024 19:14:24 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Apr 07 15:14:24 2024
Received: from localhost ([127.0.0.1]:44664 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rtXyC-00029R-3R
	for submit <at> debbugs.gnu.org; Sun, 07 Apr 2024 15:14:24 -0400
Received: from mout.gmx.net ([212.227.15.19]:54087)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stephen.berman@HIDDEN>) id 1rtXy9-00029C-LC
 for 70246 <at> debbugs.gnu.org; Sun, 07 Apr 2024 15:14:22 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1712517248; x=1713122048; i=stephen.berman@HIDDEN;
 bh=GJNmts8iN2Vb78RV3wdgub6pwSEPSanPG4qB1fMrM/Q=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:
 Date;
 b=Vgfc+2yrNwaC1oprvzTCzUfiFsgrbJY2juEL2fjP7TklPrIXIOh1C7rlZ62/AQrG
 lsjhEG4fQEDuP4O2e42HTVQZYhZI2Dh5C7IcIGtc9fJxp2kVTrT/KLiiv58G+CD5J
 z5TC55gOMiZ1uhV0YWgnHG5E6PgoH3+zKGgaiw8di4bu46HMNwWu4OckVTO+LcGrx
 ZAJZ3YDg6n4+i6NzvqKm8FvFgY798ertmGPWE10y9ehP+s4EKq+WtLbGvbBa7GtqX
 ef4gyvlK8aIezHgHo5zNbsEeQm1IgWkCMpq1+gQ8zUnklPTsJZR3smIxvbXWisB2X
 2xteY52BgOgQkIKX7A==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs ([94.134.95.232]) by mail.gmx.net (mrgmx005
 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MEm2D-1rzpdr1rh5-00GG93; Sun, 07
 Apr 2024 21:14:08 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#70246: 30.0.50; Update INSTALL for native compilation
In-Reply-To: <86v84tz0ma.fsf@HIDDEN> (Eli Zaretskii's message of "Sun, 07 Apr
 2024 17:52:13 +0300")
References: <87plv29pro.fsf@HIDDEN> <86il0t1z96.fsf@HIDDEN>
 <87r0fhpf52.fsf@HIDDEN> <86v84tz0ma.fsf@HIDDEN>
Date: Sun, 07 Apr 2024 21:14:08 +0200
Message-ID: <87frvxouin.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
X-Provags-ID: V03:K1:swDbnKwFdXfQtRc/6dEzKVLOUuYwRIZfwzrtoUz5+bnFm9QJB9c
 wjvalxggee7jOhmrQqRAqLAqdj99AGH/ulCgo+4gBQJUH2rI3WvBIpc7rFBP7z84+DVETEa
 usEuS1b0XNgVCheJyundj3o4vm4KQYtQditH6dMSsyJ4+e34THs9I2IPRgRubxSUoeRKn0B
 9hMh7E+u6bQwOdkrt7njw==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:uVNeQULbtJo=;IjQZ306Pid1guKMWp/nlPGQQqJN
 PZ745UcTBiMz9R5hpudxLOebWiy4xqeJUmJ1ZBgxJSnK5eq1lQP+2mFD56ok4Q/JYSfBVd9XI
 3s5p7Poa+zzQwjkTmw4mVaezqdT4KHzMplX68vxTVy8aZLhKNMvu7OYp5Tu44uCwdOUHa2MpH
 N3/dcVfZXJ4nc38YvcGlzfcorTrDQTKhnhfCcfNy99GmJYvd61DLYozfFvHSoTNjNJzVYc/28
 OmRRZ6jQbABU8joLZCHSIegMhtIzD5dVIeUorYRpwrxbtwj7+3DM2GT+zgQMFqqJsEr1HLpgZ
 NxKnjCo8wT3Rymd7noPdTYAqe/n4A692fcAjTPRAt9gAR9z88SQzDjFDaa+w80mW+SylFTuKp
 TbYNX4MXMdEwywgruWMUPzNa+oik330U+rY/RJvNxK5LQ/T1SAZaeKFsOxOuU+pMOgkmZXrke
 MeHZsZZ9vmmcIW2dz5KmO6bLqzUjdjYuLznQMrOfZuHpr4XGnIK+/CoUVseK4w52LMlvnfJGb
 9rZT6N7ISlZkXMaCDtEJaOMqeN69EHD7TpqbrO59W6PbTVCKp8aLBzIIgs69jZculsz8eo5Qi
 KFBBm5HG+bngHLN0U41dyNc5LeLT082IDqL7PY7yNigizmjEUCQaSR/MF3jS60mp9vvOnYVY4
 985052LUV8pbvCKoPfkfJtWa/y/8Q6hJvoYMK9bUiHgZfhyToYexTT1W+FbG2GAkIar8jk957
 jrQ1/35UK8TGtsJ+KgS2wKuJYNMGkoptwWZa74EiqqdvJDatXjSOROKvSXoi0TP2uILnEMRcK
 hRlXHf3ub0vz2g8NkF6M750bmCrq+4AONi3zlUSct+C4M=
X-Spam-Score: 2.9 (++)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 Content preview:  On Sun, 07 Apr 2024 17:52:13 +0300 Eli Zaretskii wrote: >>
 From: Stephen Berman >> Cc: 70246 <at> debbugs.gnu.org >> Date: Sun, 07 Apr 2024
 13:48:41 +0200 >> >> On Sun, 07 Apr 2024 09:08:05 +0300 Eli Zaretskii wrote:
 >> >> > Thanks. This LGTM, except the ch [...] 
 Content analysis details:   (2.9 points, 10.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 3.6 RCVD_IN_SBL_CSS        RBL: Received via a relay in Spamhaus SBL-CSS
 [94.134.95.232 listed in zen.spamhaus.org]
 -0.0 SPF_PASS               SPF: sender matches SPF record
 0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
 provider (stephen.berman[at]gmx.net)
 0.0 SPF_HELO_NONE          SPF: HELO does not publish an SPF Record
 -0.0 RCVD_IN_MSPIKE_H2      RBL: Average reputation (+2)
 [212.227.15.19 listed in wl.mailspike.net]
 -0.7 RCVD_IN_DNSWL_LOW      RBL: Sender listed at https://www.dnswl.org/,
 low trust [212.227.15.19 listed in list.dnswl.org]
X-Debbugs-Envelope-To: 70246
Cc: 70246 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 1.9 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 
 Content preview:  On Sun, 07 Apr 2024 17:52:13 +0300 Eli Zaretskii wrote: >>
    From: Stephen Berman >> Cc: 70246 <at> debbugs.gnu.org >> Date: Sun, 07 Apr 2024
    13:48:41 +0200 >> >> On Sun, 07 Apr 2024 09:08:05 +0300 Eli Zaretskii wrote:
    >> >> > Thanks. This LGTM, except the ch [...] 
 
 Content analysis details:   (1.9 points, 10.0 required)
 
  pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -0.7 RCVD_IN_DNSWL_LOW      RBL: Sender listed at https://www.dnswl.org/,
                             low trust
                             [212.227.15.19 listed in list.dnswl.org]
  3.6 RCVD_IN_SBL_CSS        RBL: Received via a relay in Spamhaus SBL-CSS
                             [94.134.95.232 listed in zen.spamhaus.org]
 -0.0 RCVD_IN_MSPIKE_H2      RBL: Average reputation (+2)
                             [212.227.15.19 listed in wl.mailspike.net]
 -0.0 SPF_PASS               SPF: sender matches SPF record
  0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
                             provider (stephen.berman[at]gmx.net)
  0.0 SPF_HELO_NONE          SPF: HELO does not publish an SPF Record
 -1.0 MAILING_LIST_MULTI     Multiple indicators imply a widely-seen list
                             manager

--=-=-=
Content-Type: text/plain
Content-Transfer-Encoding: quoted-printable

On Sun, 07 Apr 2024 17:52:13 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:

>> From: Stephen Berman <stephen.berman@HIDDEN>
>> Cc: 70246 <at> debbugs.gnu.org
>> Date: Sun, 07 Apr 2024 13:48:41 +0200
>>
>> On Sun, 07 Apr 2024 09:08:05 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:
>>
>> > Thanks.  This LGTM, except the changes to item 6: there, I would only
>> > mention the possibility of building out of the source tree.  Whether
>> > running uninstalled is possible in this case depends where is the
>> > build tree relative to the source tree, so I'd rather not describe al=
l
>> > the gory details there because they are too complex to explain (what
>> > you wrote is inaccurate);
>>
>> There was a mistake at the end of 6b; what I meant to write is "but the
>> ../lib-src and ../native-lisp directories in the build directory
>> (because the compiled files in these directories are
>> machine-dependent)."  If there were any other inaccuracies in what I
>> wrote, can you please point them out to me (for my own edification)?
>
> See below.
>
>> >                           I'd just say that running uninstalled is
>> > fully supported only when Emacs is built in the source tree.
>>
>> So instead of having 6{a,b,c} as in my patch, are the following
>> additions to the current version (at the end of the first paragraph of
>> 6) ok?
>>
>> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
>> , ../native-lisp (if built with support for native compilation).
>>
>> If you build Emacs in a directory separate from the source directory
>> ("out-of-tree"), run 'make' in the build directory.  Then you can
>> execute the 'src/emacs' file under that directory "in place".  However,
>> running Emacs uninstalled is fully supported only when it is built in
>> the source tree.
>> =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
>
> Yes, but see below.
>
>> But, again for my own edification, can you elaborate what "fully
>> supported" means here?
>
> It means that (a) Emacs will find all the files it needs for running,
> which includes programs and files in lib-src/, Lisp *.el/*.elc/*.eln
> files, Info files, and files in the etc/ subdirectory in the tree from
> which it is run; and (b) when any of the source files are edited and
> Emacs is rebuilt, the next invocation will use the updated files,
> including recompiling the *.eln files as needed.

AFAIK all that happens with my uninstalled out-of-tree builds, but maybe
there's some subtlety I'm not aware of.

>> I've been running Emacs uninstalled from a build
>> directory outside of the source tree for many years, and that statement
>> suggests my builds are deficient (though perhaps only in unobvious ways
>> that are not crucial for using Emacs), and if so, I'd like to know how
>> and why.
>
> What Emacs does at startup to decide where its files are installed is
> complex and hard to explain without describing the entire algorithm
> (which is both inappropriate for INSTALL and subject to change without
> notice).

Yes, INSTALL is certainly not the place for such details.

>           If you are interested, look in emacs.c:init_cmdargs and
> lread.c:load_path_default.

Ok, thanks for the pointers.

> The bottom line is that the Lisp and Info files will be taken from the
> source tree, not from the build tree.  So if you have more than one
> build from the same source tree, then they all share the Lisp and Info
> files.  Therefore, if you modify anything in the source tree, you must
> rebuild all the out-of-tree builds, otherwise those you don't rebuild
> will be inconsistent with the modified sources.

Yes, but if you instead make copies of the sources (or different repo
branches) to build different configurations and make changes that you
want to test in all configurations, then you have to make those changes
in each copy or branch and rebuild them all, too.  So there are
trade-offs in both procedures.

>> >> +'/usr/local/share/emacs/VERSION/native-lisp' holds the natively com=
piled
>> >> +		pre-loaded Emacs Lisp files.
>> >
>> > This is incorrect: native-lisp is installed under /usr/lib/emacs/VERS=
ION,
>> > not under /usr/share/emacs/VERSION.
>>
>> I guess you meant /usr/local/lib/emacs/VERSION for the default location=
?
>
> Yes.
>
>> +By default, Emacs natively compiles only pre-loaded Lisp files during
>> +the build process; other Lisp files are natively compiled
>> +"just-in-time", i.e, when they are loaded in the running Emacs.  If yo=
u
>                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> "when they are first time loaded into the running Emacs".
>
>>  6) Run 'make' in the top directory of the Emacs distribution to finish
>> -building Emacs in the standard way.  The final executable file is
>> -named 'src/emacs'.  You can execute this file "in place" without
>> -copying it, if you wish; then it automatically uses the sibling
>> -directories ../lisp, ../lib-src, ../info.
>> +building Emacs in the standard way.  The final executable file is name=
d
>> +'src/emacs'.  You can execute this file "in place" without copying it,
>> +if you wish; then it automatically uses the sibling directories ../lis=
p,
>> +../lib-src, ../info, ../native-lisp (if built with support for native
>> +compilation).
>> +
>> +If you build Emacs in a directory separate from the source directory
>> +("out-of-tree"), run 'make' in the build directory.  Then you can
>> +execute the 'src/emacs' file under that directory "in place".  However=
,
>> +running Emacs uninstalled is fully supported only when it is built in
>> +the source tree.
>
> I think the last sentence should be better phrased as
>
>   However, running Emacs uninstalled in this case will still use the
>   ../lisp and ../info subdirectories of the source tree, while using
>   the ../lib-src and ../native-lisp subdirectories from the build tree.
>
>> +'/usr/local/lib/emacs/VERSION/native-lisp' holds the natively compiled
>> +		pre-loaded Emacs Lisp files.
>
> The above also contains the other Lisp files if using the
> "--with-native-compilation=3Daot" configure-time option.
>
>> +'~/.emacs.d/eln-cache/' holds the remaining natively compiled Lisp fil=
es.
>
> Instead of "remaining" I'd say "just-in-time natively compiled Lisp
> files".
>
> Thanks.

Thanks again for the review and suggestions, which I've incorporated
into the attached patch, and if you confirm it's good to go, I'll commit
it to master.

Steve Berman


--=-=-=
Content-Type: text/x-patch
Content-Disposition: attachment
Content-Description: INSTALL patch
Content-Transfer-Encoding: quoted-printable

diff --git a/INSTALL b/INSTALL
index 2aaa02f37d7..32802d428d2 100644
=2D-- a/INSTALL
+++ b/INSTALL
@@ -264,6 +264,25 @@ to force GTK+ to run under Broadway, start Emacs like=
 this:
 The GNUstep build also supports the Wayland window system.  If that is
 what you want, see nextstep/INSTALL.

+* Native compilation of Lisp files
+
+In addition to byte-compiling files of Lisp code, Emacs can also produce
+"native code", which usually runs several times faster than the
+corresponding byte-compiled code.  To build Emacs with this feature,
+your system must have not only GCC (the C compiler) and Binutils (the
+assembler and linker) but also the 'libgccjit' shared library, which is
+part of the GCC distribution.  If these components are available,
+building Emacs will automatically produce natively compiled Lisp code.
+
+By default, Emacs natively compiles only pre-loaded Lisp files during
+the build process; other Lisp files are natively compiled
+"just-in-time", i.e., the first time they are loaded into the running
+Emacs.  If you want Emacs to natively compile all Lisp files during the
+build ("ahead of time"), use the 'configure' option
+'--with-native-compilation=3Daot'.  If you do not want natively compiled
+Lisp code even if your system satisfies the build requirements, use the
+'configure' option '--with-native-compilation=3Dno'.
+
 DETAILED BUILDING AND INSTALLATION:

 (This is for a Unix or Unix-like system.  For GNUstep and macOS,
@@ -553,10 +572,18 @@ need to create them if you have nothing to put in th=
em.
 wish to add to various termcap entries.  (This is unlikely to be necessar=
y.)

 6) Run 'make' in the top directory of the Emacs distribution to finish
-building Emacs in the standard way.  The final executable file is
-named 'src/emacs'.  You can execute this file "in place" without
-copying it, if you wish; then it automatically uses the sibling
-directories ../lisp, ../lib-src, ../info.
+building Emacs in the standard way.  The final executable file is named
+'src/emacs'.  You can execute this file "in place" without copying it,
+if you wish; then it automatically uses the sibling directories ../lisp,
+../lib-src, ../info, ../native-lisp (if built with support for native
+compilation).
+
+If you build Emacs in a directory separate from the source directory
+("out-of-tree"), run 'make' in the build directory.  Then you can
+execute the 'src/emacs' file under that directory "in place".  However,
+in this case the Emacs executable, while still using the ../lisp and
+../info subdirectories of the source tree, will use the ../lib-src and
+../native-lisp subdirectories from the build tree.

 Or you can "install" the executable and the other files into their
 installed locations, with 'make install'.  By default, Emacs's files
@@ -574,6 +601,11 @@ are installed in the following directories:
 		at the same time; in particular, you don't have to
 		make Emacs unavailable while installing a new version.

+'/usr/local/lib/emacs/VERSION/native-lisp' holds the natively compiled
+		pre-loaded Emacs Lisp files.
+
+'~/.emacs.d/eln-cache/' holds the remaining natively compiled Lisp files.
+
 '/usr/local/share/emacs/VERSION/etc' holds the Emacs tutorial, the DOC
 		file, and other architecture-independent files Emacs
 		might need while running.

--=-=-=--
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70246; Package emacs. Full text available.

Message received at 70246 <at> debbugs.gnu.org:


Received: (at 70246) by debbugs.gnu.org; 7 Apr 2024 14:52:35 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Apr 07 10:52:34 2024
Received: from localhost ([127.0.0.1]:44311 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rtTsl-0001Rn-Re
	for submit <at> debbugs.gnu.org; Sun, 07 Apr 2024 10:52:34 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:52550)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1rtTsk-0001RP-8L
 for 70246 <at> debbugs.gnu.org; Sun, 07 Apr 2024 10:52:30 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1rtTsX-0005tT-Rd; Sun, 07 Apr 2024 10:52:17 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date:
 mime-version; bh=2DwJkEPKUTfUdl0tpxcBYkAzWuhdHq0vPMaB/s/SC0Y=; b=bBnAsVEKx6tk
 g60MiYY2mLP5gH4bg/ync/lMcOZsWvN+RA2crv1KFTwMUF7HU7HRoeLu7T6xTVN0Ti9nN7N6chta/
 2YSee7MD28joX+4MmJCBqk4h1221K32gnp1OQFCEmK/OwYCjNDxX1x4UJtDRZtARQzTz+Z0XUhh3k
 +fD4oTrHAt21kCBSGkugnzWul8NX2G2utGYP5q1BdwfNm3O9xkVyGIY4LEWXHDwiCxUrp/I3yO6+0
 RAACbEqnox8a6f/ghehvDZkd5wJxtsOxz39KWpdtjZWvcc64ZvWDp4/Fi/okJL9I1WbXGVJqHtyYN
 VEB1hTLH642y+PMKhno+pw==;
Date: Sun, 07 Apr 2024 17:52:13 +0300
Message-Id: <86v84tz0ma.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Stephen Berman <stephen.berman@HIDDEN>
In-Reply-To: <87r0fhpf52.fsf@HIDDEN> (message from Stephen Berman on Sun, 07
 Apr 2024 13:48:41 +0200)
Subject: Re: bug#70246: 30.0.50; Update INSTALL for native compilation
References: <87plv29pro.fsf@HIDDEN> <86il0t1z96.fsf@HIDDEN>
 <87r0fhpf52.fsf@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 70246
Cc: 70246 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Stephen Berman <stephen.berman@HIDDEN>
> Cc: 70246 <at> debbugs.gnu.org
> Date: Sun, 07 Apr 2024 13:48:41 +0200
> 
> On Sun, 07 Apr 2024 09:08:05 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:
> 
> > Thanks.  This LGTM, except the changes to item 6: there, I would only
> > mention the possibility of building out of the source tree.  Whether
> > running uninstalled is possible in this case depends where is the
> > build tree relative to the source tree, so I'd rather not describe all
> > the gory details there because they are too complex to explain (what
> > you wrote is inaccurate);
> 
> There was a mistake at the end of 6b; what I meant to write is "but the
> ../lib-src and ../native-lisp directories in the build directory
> (because the compiled files in these directories are
> machine-dependent)."  If there were any other inaccuracies in what I
> wrote, can you please point them out to me (for my own edification)?

See below.

> >                           I'd just say that running uninstalled is
> > fully supported only when Emacs is built in the source tree.
> 
> So instead of having 6{a,b,c} as in my patch, are the following
> additions to the current version (at the end of the first paragraph of
> 6) ok?
> 
> =======================================================================
> , ../native-lisp (if built with support for native compilation).
> 
> If you build Emacs in a directory separate from the source directory
> ("out-of-tree"), run 'make' in the build directory.  Then you can
> execute the 'src/emacs' file under that directory "in place".  However,
> running Emacs uninstalled is fully supported only when it is built in
> the source tree.
> =======================================================================

Yes, but see below.

> But, again for my own edification, can you elaborate what "fully
> supported" means here?

It means that (a) Emacs will find all the files it needs for running,
which includes programs and files in lib-src/, Lisp *.el/*.elc/*.eln
files, Info files, and files in the etc/ subdirectory in the tree from
which it is run; and (b) when any of the source files are edited and
Emacs is rebuilt, the next invocation will use the updated files,
including recompiling the *.eln files as needed.

> I've been running Emacs uninstalled from a build
> directory outside of the source tree for many years, and that statement
> suggests my builds are deficient (though perhaps only in unobvious ways
> that are not crucial for using Emacs), and if so, I'd like to know how
> and why.

What Emacs does at startup to decide where its files are installed is
complex and hard to explain without describing the entire algorithm
(which is both inappropriate for INSTALL and subject to change without
notice).  If you are interested, look in emacs.c:init_cmdargs and
lread.c:load_path_default.

The bottom line is that the Lisp and Info files will be taken from the
source tree, not from the build tree.  So if you have more than one
build from the same source tree, then they all share the Lisp and Info
files.  Therefore, if you modify anything in the source tree, you must
rebuild all the out-of-tree builds, otherwise those you don't rebuild
will be inconsistent with the modified sources.

> >> +'/usr/local/share/emacs/VERSION/native-lisp' holds the natively compiled
> >> +		pre-loaded Emacs Lisp files.
> >
> > This is incorrect: native-lisp is installed under /usr/lib/emacs/VERSION,
> > not under /usr/share/emacs/VERSION.
> 
> I guess you meant /usr/local/lib/emacs/VERSION for the default location?

Yes.

> +By default, Emacs natively compiles only pre-loaded Lisp files during
> +the build process; other Lisp files are natively compiled
> +"just-in-time", i.e, when they are loaded in the running Emacs.  If you
                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
"when they are first time loaded into the running Emacs".

>  6) Run 'make' in the top directory of the Emacs distribution to finish
> -building Emacs in the standard way.  The final executable file is
> -named 'src/emacs'.  You can execute this file "in place" without
> -copying it, if you wish; then it automatically uses the sibling
> -directories ../lisp, ../lib-src, ../info.
> +building Emacs in the standard way.  The final executable file is named
> +'src/emacs'.  You can execute this file "in place" without copying it,
> +if you wish; then it automatically uses the sibling directories ../lisp,
> +../lib-src, ../info, ../native-lisp (if built with support for native
> +compilation).
> +
> +If you build Emacs in a directory separate from the source directory
> +("out-of-tree"), run 'make' in the build directory.  Then you can
> +execute the 'src/emacs' file under that directory "in place".  However,
> +running Emacs uninstalled is fully supported only when it is built in
> +the source tree.

I think the last sentence should be better phrased as

  However, running Emacs uninstalled in this case will still use the
  ../lisp and ../info subdirectories of the source tree, while using
  the ../lib-src and ../native-lisp subdirectories from the build tree.

> +'/usr/local/lib/emacs/VERSION/native-lisp' holds the natively compiled
> +		pre-loaded Emacs Lisp files.

The above also contains the other Lisp files if using the
"--with-native-compilation=aot" configure-time option.

> +'~/.emacs.d/eln-cache/' holds the remaining natively compiled Lisp files.

Instead of "remaining" I'd say "just-in-time natively compiled Lisp
files".

Thanks.
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70246; Package emacs. Full text available.

Message received at 70246 <at> debbugs.gnu.org:


Received: (at 70246) by debbugs.gnu.org; 7 Apr 2024 11:49:04 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Apr 07 07:49:04 2024
Received: from localhost ([127.0.0.1]:41726 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rtR17-0001Ui-FL
	for submit <at> debbugs.gnu.org; Sun, 07 Apr 2024 07:49:03 -0400
Received: from mout.gmx.net ([212.227.17.20]:58079)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stephen.berman@HIDDEN>) id 1rtR15-0001Tu-A1
 for 70246 <at> debbugs.gnu.org; Sun, 07 Apr 2024 07:48:56 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1712490522; x=1713095322; i=stephen.berman@HIDDEN;
 bh=RQ2FKJ86Fh0025MjIvq1LZVTl5tpPkwpZGX3oXdrdKs=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:
 Date;
 b=GNOmcl4nT0vu3iHRwhQu3t6ySuPnd81g3Xquj38mhpKye1R7lRUiZr0u6S/PUbdm
 FjRBCEg1LLiW7qK+qE4M/rBTCGvkT5ZewbXDOoTkTEdQeFctyAzgvcAUjnYqW7xkX
 23xe4jvIr/e3xgOUe/y/n+CFl57/7cU98ou4VtBI8XgYtNYoFK6bSiLJfUqejUD1P
 qHxtQBwZKkIlhkS4OLUvEV4Z5DT6jjW9wYfK43YrddIQFtFDCLqWiz6Q3jDfROz21
 6FluCwIti7efXSHqraiMq56Sn+v33bpJKB/rvk7F86TSrP7Y9oZxyVDpDSP3jM/IE
 rJN5FqAOsjAu9HhMow==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs ([94.134.95.232]) by mail.gmx.net (mrgmx104
 [212.227.17.168]) with ESMTPSA (Nemesis) id 1N2mBQ-1swIDO0d9Y-0135uI; Sun, 07
 Apr 2024 13:48:42 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: Eli Zaretskii <eliz@HIDDEN>
Subject: Re: bug#70246: 30.0.50; Update INSTALL for native compilation
In-Reply-To: <86il0t1z96.fsf@HIDDEN> (Eli Zaretskii's message of "Sun, 07 Apr
 2024 09:08:05 +0300")
References: <87plv29pro.fsf@HIDDEN> <86il0t1z96.fsf@HIDDEN>
Date: Sun, 07 Apr 2024 13:48:41 +0200
Message-ID: <87r0fhpf52.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
X-Provags-ID: V03:K1:P83T+p4q8Te7kM9ZBywkRCQXi6w4vQDfRk5Q+emIm8X9nberckA
 2/ew+Bin+dzv0hkt/eQmkBbnC4bh3rSK9TEp+TskRVckzzZHZejjpWAAWeNN+2aq0XFui0q
 lyhMoRmFEFioO8skVSI0upgrlYUtXi0dpo8IR8HF7M+r426syhGlUc9kiVRhfZZLqa5+znG
 F/MndDubkYFA5eQ5bUPuw==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:xS6/bGZ3ipg=;ZOKePuO7cpLe+43VIibTas/Unrs
 fcF1slpYI74VR0QTPDRY9VycGRg97a3GH6CWBM4KHCeMfYvGC4npcoNUbakzZYe7cZS/SZDm7
 kYi6f+f+BQErBRuJRYmRtXgGPl/9rulK7SF7LAtNd0j4gAunZuN0XTj02nmh6uC9gYz/wLupi
 Qq4K/IiEiSZ5CvslZlYGAIfi4PVK2wEdA1MCgeruaNR/1BfDeoowQdkC1UUjQqWWiwlUArXMW
 AwomL4cqvpytmsGekvSA6M94y4ahicuKVnWKhzUupkZ+QiA5L7A1J3x2T0qXPFx39eiKmg3ZP
 LW3h0PfLnNEDVznRusCR58xryCB/yXNluTTcxFdgVKq2H/7Ez0BrOqCNX8txL0/wao+Bfl4eL
 vrAlv4NCEF1cRUm2/yfgQ8CFQpCMdsMiahLXskvNGfSPqW2eHSCrXOgPvd6/PN+i4e0sKzNls
 GDSRf2zeiQH/0f0qMBCcu8WWs+uAmiSWGlbQLA1eO+xsx9RPHsRFemB88nguL7VRR+WA6P5Jf
 nsN7Y33Ua9H3/xPKBXWvLtSSs5B4e53dY63+vmq+FCPJiGG10Pp+gwjgMzgT85IZDa+I72pO6
 ovqhcZNMcIeEgw92HqDnhCZgeyAQTxJopi/29RQf4Od7GqgqF26HXT6Y7BZTl3Pr8TXynArJA
 GIFZEb9UoozvWg5OcJ22zGy5pY1xaSsjqpjRp14y9hvzU7yUQnWPxgLy2UTLmTX2WLtnTuhiV
 J6MaeIPeU0XDlMm2bCu1ZIpjbNYqURO8IlkG1uG6IM2YU9zZMceOASSkOr2Z2O02zsK6d0aHl
 +2YLzY604mLFGT10+Qt4PGl/6KnxS5qDE5G9yaHXaOazk=
X-Spam-Score: 2.8 (++)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 Content preview:  On Sun, 07 Apr 2024 09:08:05 +0300 Eli Zaretskii wrote: >>
 Date: Sat, 06 Apr 2024 22:53:31 +0200 >> From: Stephen Berman via "Bug reports
 for GNU Emacs, >> the Swiss army knife of text editors" >> >> The INSTALL
 file in the Emacs sources makes no referen [...] 
 Content analysis details:   (2.8 points, 10.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 3.6 RCVD_IN_SBL_CSS        RBL: Received via a relay in Spamhaus SBL-CSS
 [94.134.95.232 listed in zen.spamhaus.org]
 -0.0 SPF_PASS               SPF: sender matches SPF record
 0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
 provider (stephen.berman[at]gmx.net)
 0.0 SPF_HELO_NONE          SPF: HELO does not publish an SPF Record
 -0.0 RCVD_IN_MSPIKE_H3      RBL: Good reputation (+3)
 [212.227.17.20 listed in wl.mailspike.net]
 -0.7 RCVD_IN_DNSWL_LOW      RBL: Sender listed at https://www.dnswl.org/,
 low trust [212.227.17.20 listed in list.dnswl.org]
 -0.0 RCVD_IN_MSPIKE_WL      Mailspike good senders
X-Debbugs-Envelope-To: 70246
Cc: 70246 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: 1.8 (+)
X-Spam-Report: Spam detection software, running on the system "debbugs.gnu.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 the administrator of that system for details.
 
 Content preview:  On Sun, 07 Apr 2024 09:08:05 +0300 Eli Zaretskii wrote: >>
    Date: Sat, 06 Apr 2024 22:53:31 +0200 >> From: Stephen Berman via "Bug reports
    for GNU Emacs, >> the Swiss army knife of text editors" >> >> The INSTALL
    file in the Emacs sources makes no referen [...] 
 
 Content analysis details:   (1.8 points, 10.0 required)
 
  pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -0.7 RCVD_IN_DNSWL_LOW      RBL: Sender listed at https://www.dnswl.org/,
                             low trust
                             [212.227.17.20 listed in list.dnswl.org]
  3.6 RCVD_IN_SBL_CSS        RBL: Received via a relay in Spamhaus SBL-CSS
                             [94.134.95.232 listed in zen.spamhaus.org]
 -0.0 RCVD_IN_MSPIKE_H3      RBL: Good reputation (+3)
                             [212.227.17.20 listed in wl.mailspike.net]
 -0.0 SPF_PASS               SPF: sender matches SPF record
  0.0 FREEMAIL_FROM          Sender email is commonly abused enduser mail
                             provider (stephen.berman[at]gmx.net)
  0.0 SPF_HELO_NONE          SPF: HELO does not publish an SPF Record
 -0.0 RCVD_IN_MSPIKE_WL      Mailspike good senders
 -1.0 MAILING_LIST_MULTI     Multiple indicators imply a widely-seen list
                             manager

--=-=-=
Content-Type: text/plain
Content-Transfer-Encoding: quoted-printable

On Sun, 07 Apr 2024 09:08:05 +0300 Eli Zaretskii <eliz@HIDDEN> wrote:

>> Date: Sat, 06 Apr 2024 22:53:31 +0200
>> From:  Stephen Berman via "Bug reports for GNU Emacs,
>>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
>>
>> The INSTALL file in the Emacs sources makes no reference to native
>> compilation.  The attached patch is an attempt to fill this gap (but I'=
m
>> not sure about the default locations of installed natively compiled Lis=
p
>> files, since I do not install Emacs when I build and do not have a
>> distribution installation of Emacs built with native compilation to
>> check).
>
> Thanks.  This LGTM, except the changes to item 6: there, I would only
> mention the possibility of building out of the source tree.  Whether
> running uninstalled is possible in this case depends where is the
> build tree relative to the source tree, so I'd rather not describe all
> the gory details there because they are too complex to explain (what
> you wrote is inaccurate);

There was a mistake at the end of 6b; what I meant to write is "but the
../lib-src and ../native-lisp directories in the build directory
(because the compiled files in these directories are
machine-dependent)."  If there were any other inaccuracies in what I
wrote, can you please point them out to me (for my own edification)?

>                           I'd just say that running uninstalled is
> fully supported only when Emacs is built in the source tree.

So instead of having 6{a,b,c} as in my patch, are the following
additions to the current version (at the end of the first paragraph of
6) ok?

=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
, ../native-lisp (if built with support for native compilation).

If you build Emacs in a directory separate from the source directory
("out-of-tree"), run 'make' in the build directory.  Then you can
execute the 'src/emacs' file under that directory "in place".  However,
running Emacs uninstalled is fully supported only when it is built in
the source tree.
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D

But, again for my own edification, can you elaborate what "fully
supported" means here?  I've been running Emacs uninstalled from a build
directory outside of the source tree for many years, and that statement
suggests my builds are deficient (though perhaps only in unobvious ways
that are not crucial for using Emacs), and if so, I'd like to know how
and why.

>> +'/usr/local/share/emacs/VERSION/native-lisp' holds the natively compil=
ed
>> +		pre-loaded Emacs Lisp files.
>
> This is incorrect: native-lisp is installed under /usr/lib/emacs/VERSION=
,
> not under /usr/share/emacs/VERSION.

I guess you meant /usr/local/lib/emacs/VERSION for the default location?

The above changes are in the attached patch (which also corrects two
typos in my previous patch in the first paragraph under the heading
"Native compilation of Lisp files").

Steve Berman


--=-=-=
Content-Type: text/x-patch
Content-Disposition: attachment
Content-Description: INSTALL patch
Content-Transfer-Encoding: quoted-printable

diff --git a/INSTALL b/INSTALL
index 2aaa02f37d7..edc7f0699e2 100644
=2D-- a/INSTALL
+++ b/INSTALL
@@ -264,6 +264,25 @@ to force GTK+ to run under Broadway, start Emacs like=
 this:
 The GNUstep build also supports the Wayland window system.  If that is
 what you want, see nextstep/INSTALL.

+* Native compilation of Lisp files
+
+In addition to byte-compiling files of Lisp code, Emacs can also produce
+"native code", which usually runs several times faster than the
+corresponding byte-compiled code.  To build Emacs with this feature,
+your system must have not only GCC (the C compiler) and Binutils (the
+assembler and linker) but also the 'libgccjit' shared library, which is
+part of the GCC distribution.  If these components are available,
+building Emacs will automatically produce natively compiled Lisp code.
+
+By default, Emacs natively compiles only pre-loaded Lisp files during
+the build process; other Lisp files are natively compiled
+"just-in-time", i.e, when they are loaded in the running Emacs.  If you
+want Emacs to natively compile all Lisp files during the build ("ahead
+of time"), use the 'configure' option '--with-native-compilation=3Daot'.
+If you do not want natively compiled Lisp code even if your system
+satisfies the build requirements, use the 'configure' option
+'--with-native-compilation=3Dno'.
+
 DETAILED BUILDING AND INSTALLATION:

 (This is for a Unix or Unix-like system.  For GNUstep and macOS,
@@ -553,10 +572,17 @@ need to create them if you have nothing to put in th=
em.
 wish to add to various termcap entries.  (This is unlikely to be necessar=
y.)

 6) Run 'make' in the top directory of the Emacs distribution to finish
-building Emacs in the standard way.  The final executable file is
-named 'src/emacs'.  You can execute this file "in place" without
-copying it, if you wish; then it automatically uses the sibling
-directories ../lisp, ../lib-src, ../info.
+building Emacs in the standard way.  The final executable file is named
+'src/emacs'.  You can execute this file "in place" without copying it,
+if you wish; then it automatically uses the sibling directories ../lisp,
+../lib-src, ../info, ../native-lisp (if built with support for native
+compilation).
+
+If you build Emacs in a directory separate from the source directory
+("out-of-tree"), run 'make' in the build directory.  Then you can
+execute the 'src/emacs' file under that directory "in place".  However,
+running Emacs uninstalled is fully supported only when it is built in
+the source tree.

 Or you can "install" the executable and the other files into their
 installed locations, with 'make install'.  By default, Emacs's files
@@ -574,6 +600,11 @@ are installed in the following directories:
 		at the same time; in particular, you don't have to
 		make Emacs unavailable while installing a new version.

+'/usr/local/lib/emacs/VERSION/native-lisp' holds the natively compiled
+		pre-loaded Emacs Lisp files.
+
+'~/.emacs.d/eln-cache/' holds the remaining natively compiled Lisp files.
+
 '/usr/local/share/emacs/VERSION/etc' holds the Emacs tutorial, the DOC
 		file, and other architecture-independent files Emacs
 		might need while running.

--=-=-=--
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70246; Package emacs. Full text available.

Message received at 70246 <at> debbugs.gnu.org:


Received: (at 70246) by debbugs.gnu.org; 7 Apr 2024 06:08:22 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sun Apr 07 02:08:21 2024
Received: from localhost ([127.0.0.1]:41427 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rtLhV-00032d-Jl
	for submit <at> debbugs.gnu.org; Sun, 07 Apr 2024 02:08:21 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:59502)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1rtLhU-00031v-4x
 for 70246 <at> debbugs.gnu.org; Sun, 07 Apr 2024 02:08:20 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1rtLhH-0006d6-Pe; Sun, 07 Apr 2024 02:08:07 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date:
 mime-version; bh=iNO2oJOZTKy63/x+PkYw0unL42toPBT9rdLjMbRix4g=; b=YCsmUlVGPS5B
 z1C+WEjeR40lLlkkJMPxn7jlXExCaK3cjyIfUENYqQroSvMGwttqJmgOG1H6+vBM6RMDcS62N/lt4
 2/WeJxZLzbcAj8f/cQpoduRDTpomss7D38OTVvMoKvRtfuuQUfFAXo5jT/hM24l1yM13SvdeGd5+l
 e6xw7IUkG1sqP06E6vyr+VeRvikr6veDQF+N5DQsR44jgLN9/ZhPcC7KvOGkqQ1z2rvc/un77tUM2
 uA3aoO18k7zlh1iCRhx1uFD0m9nkV6I/36dI5m/7ayg1Smitfhe/2sQg2iSRD57H4SOJWgthebhzR
 HyrGD+O4OlhIaVxaTUsDxg==;
Date: Sun, 07 Apr 2024 09:08:05 +0300
Message-Id: <86il0t1z96.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Stephen Berman <stephen.berman@HIDDEN>
In-Reply-To: <87plv29pro.fsf@HIDDEN> (bug-gnu-emacs@HIDDEN)
Subject: Re: bug#70246: 30.0.50; Update INSTALL for native compilation
References: <87plv29pro.fsf@HIDDEN>
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 70246
Cc: 70246 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> Date: Sat, 06 Apr 2024 22:53:31 +0200
> From:  Stephen Berman via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs@HIDDEN>
> 
> The INSTALL file in the Emacs sources makes no reference to native
> compilation.  The attached patch is an attempt to fill this gap (but I'm
> not sure about the default locations of installed natively compiled Lisp
> files, since I do not install Emacs when I build and do not have a
> distribution installation of Emacs built with native compilation to
> check).

Thanks.  This LGTM, except the changes to item 6: there, I would only
mention the possibility of building out of the source tree.  Whether
running uninstalled is possible in this case depends where is the
build tree relative to the source tree, so I'd rather not describe all
the gory details there because they are too complex to explain (what
you wrote is inaccurate); I'd just say that running uninstalled is
fully supported only when Emacs is built in the source tree.

> +'/usr/local/share/emacs/VERSION/native-lisp' holds the natively compiled
> +		pre-loaded Emacs Lisp files.

This is incorrect: native-lisp is installed under /usr/lib/emacs/VERSION,
not under /usr/share/emacs/VERSION.
Information forwarded to bug-gnu-emacs@HIDDEN:
bug#70246; Package emacs. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 6 Apr 2024 20:53:53 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Apr 06 16:53:53 2024
Received: from localhost ([127.0.0.1]:41068 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1rtD2u-0006v4-Hb
	for submit <at> debbugs.gnu.org; Sat, 06 Apr 2024 16:53:53 -0400
Received: from lists.gnu.org ([2001:470:142::17]:42490)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <stephen.berman@HIDDEN>) id 1rtD2p-0006um-Vs
 for submit <at> debbugs.gnu.org; Sat, 06 Apr 2024 16:53:51 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10])
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <stephen.berman@HIDDEN>)
 id 1rtD2e-0004hL-2J
 for bug-gnu-emacs@HIDDEN; Sat, 06 Apr 2024 16:53:36 -0400
Received: from mout.gmx.net ([212.227.17.22])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <stephen.berman@HIDDEN>)
 id 1rtD2b-0006ne-RQ
 for bug-gnu-emacs@HIDDEN; Sat, 06 Apr 2024 16:53:35 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmx.net;
 s=s31663417; t=1712436811; x=1713041611; i=stephen.berman@HIDDEN;
 bh=lpga54yniCrZwh+w0p/RChI/sqYpWyDADigvggz+oBY=;
 h=X-UI-Sender-Class:From:To:Subject:Date;
 b=PxHxsRJsg/w85HZuCJmoaApD/7gR0g2h5X7P16Tv7vI0/InZqgBHdYXrLd2Ku09E
 VITP3m0vxYgIfX4s2irrqBhiZRmFxvTnTkCzgQl8SX4Wgy3AUtsyUxfaBQL5qmjC2
 F99Nrg3xBmLaVTj/xUnN7L+qFcARPQbv30M//yHTPX8/M7GOcw4pVOtNAVHdLUksG
 trr4fITgo+wwVkfmC73seAdeentu1XYP4JReCI6vonmdPI7BMMoEGdb0KoW0HfQQC
 N2owIPbKez6dWRN/XPZzK8j8EXvbhSd3P5eY2yG0Lx41DcqeoVOTTFikS1voDcG2/
 QZFEJDmzsS+LkA0YXA==
X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a
Received: from strobelfs ([94.134.94.0]) by mail.gmx.net (mrgmx104
 [212.227.17.168]) with ESMTPSA (Nemesis) id 1Msq24-1sm96h2XDk-00tAPx for
 <bug-gnu-emacs@HIDDEN>; Sat, 06 Apr 2024 22:53:31 +0200
From: Stephen Berman <stephen.berman@HIDDEN>
To: bug-gnu-emacs@HIDDEN
Subject: 30.0.50; Update INSTALL for native compilation
X-Debbugs-Cc: 
Date: Sat, 06 Apr 2024 22:53:31 +0200
Message-ID: <87plv29pro.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
X-Provags-ID: V03:K1:N1YPv0vzdfxFGRQw9zcRTgxrPX6nVteroVPiKfCAs9DAveNLc07
 fIx3JTtazDgknzlq610km1DF0J/XcJol/8t/l9tFPtW6bTzmPSMNA/xxdGGB29S205nU0mV
 npuh0+6wpQBHrlHqf8csc9uQFmFWCrEi6wxw8GSlNpkewMrRi9r88QZFfOwzC5Y3ClDiLsi
 6eVU24a7+lNq8ph0hsTbA==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:bFC4pxUIkx0=;KgHveBJhm7vMLUBYkcdS6Jf057V
 SqZt/glt1UPRedelEWKFgEnX/fp3/L146agEQlsZNZ5MLiXFRtC5im01QQQfodfoytqovbeD5
 j/E3MNRGTBFbD65jFbirv1X6L4IYUaOqwPP6bRuKGMHHYfj3famrJsXMrZYsVTY6Jgv33mOdy
 anUUGO6harWVNPQcs+9ZgooljcsKGdL5suSrqszfUtMlZoQUP3FpDapnVmZb4zcxWTIWPyz+8
 itebAOxUPgtHQ39mYPEwB1IxD8+mal1MOf57Pq/aw1TkdyNlsFs+8Y8xWlPi7kqL8fzZZnE7h
 yqVOlr5eRUniTDrCZlmht+wa13GTH91sUTEcrFQP31itEDOby5AHpmh4BsUWZQqNbgxLa8Wo+
 pPlPCrZKBU4PTtbl9nd/DcK8gabVDDOs/BGJ6DnnN9XEjbDGANvFytRGtAc+DbAmH3yVBBlOn
 Qd+Sqi47tWOBE7Wm/VSHto9u0UKDGqLbOVJkzUE2TYjw7RdjuVgIZ9PbnGcu8/gSJ/OcOv74w
 PPB1Yd9wl5COTq7HcWU9R6NnO6Dj4E7zeggRPQytEabQmYAmMhXDfCRiiKIRvOSGu7jPX3c/8
 ns1TU75WyMhM2mHIPhCPJ2H8Q6WxXux/W0j5qsr/VQX+um8TsWc35Ik9Jdx4r+3H3DLVsFRy3
 EyZ+4CzpxOGcCKY0jOj/Nh/yrE1NllTQDntz6NvPSNbJBAd2XE8R8AsM65NqsAwuKauT1z2J8
 FfTUtSICHiuE3pLgxZVVdjywXypx4NsjMV4zxhcw0VPLwbg7p6fr+0u+ZTntm1Ge5DyrBLtUY
 lN7O8xhnIvVfpFS7Fqz/AgLGLIIqzLgn8gyaVD0fHp1sE=
Received-SPF: pass client-ip=212.227.17.22;
 envelope-from=stephen.berman@HIDDEN; helo=mout.gmx.net
X-Spam_score_int: -27
X-Spam_score: -2.8
X-Spam_bar: --
X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001,
 RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

--=-=-=
Content-Type: text/plain

The INSTALL file in the Emacs sources makes no reference to native
compilation.  The attached patch is an attempt to fill this gap (but I'm
not sure about the default locations of installed natively compiled Lisp
files, since I do not install Emacs when I build and do not have a
distribution installation of Emacs built with native compilation to
check).

In GNU Emacs 30.0.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version
 3.24.41, cairo version 1.18.0) of 2024-03-31 built on strobelfs
Repository revision: 09f381d70d8852d90cdd3c8d7e1e2786dbc61f92
Repository branch: master
Windowing system distributor 'The X.Org Foundation', version 11.0.12101011
System Description: Linux From Scratch r12.1-30

Configured using:
 'configure 'CFLAGS=-Og -g3' PKG_CONFIG_PATH=/opt/qt5/lib/pkgconfig'

Configured features:
ACL CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GPM GSETTINGS HARFBUZZ JPEG
LCMS2 LIBSYSTEMD LIBXML2 MODULES NATIVE_COMP NOTIFY INOTIFY PDUMPER PNG
RSVG SECCOMP SOUND SQLITE3 THREADS TIFF TOOLKIT_SCROLL_BARS WEBP X11
XDBE XIM XINPUT2 XPM GTK3 ZLIB


--=-=-=
Content-Type: text/x-patch
Content-Disposition: attachment
Content-Description: INSTALL patch
Content-Transfer-Encoding: quoted-printable

diff --git a/INSTALL b/INSTALL
index 2aaa02f37d7..0682320924a 100644
=2D-- a/INSTALL
+++ b/INSTALL
@@ -264,6 +264,26 @@ to force GTK+ to run under Broadway, start Emacs like=
 this:
 The GNUstep build also supports the Wayland window system.  If that is
 what you want, see nextstep/INSTALL.

+* Native compilation of Lisp files
+
+In addition to byte-compiling files of Lisp code, Emacs can also produce
+"native code", which usually runs several times faster than the
+corresponding byte-compiled code.  To build Emacs with this feature,
+your system must have not only have GCC (the C compiler) and Binutils
+(the assembler and linker) but also the 'libgccjit' shared library,
+which is part of the GCC distribution.  If these components are
+available, building Emacs will automatically produce natively-compiled
+Lisp code.
+
+By default, Emacs natively compiles only pre-loaded Lisp files during
+the build process; other Lisp files are natively compiled
+"just-in-time", i.e, when they are loaded in the running Emacs.  If you
+want Emacs to natively compile all Lisp files during the build ("ahead
+of time"), use the 'configure' option '--with-native-compilation=3Daot'.
+If you do not want natively compiled Lisp code even if your system
+satisfies the build requirements, use the 'configure' option
+'--with-native-compilation=3Dno'.
+
 DETAILED BUILDING AND INSTALLATION:

 (This is for a Unix or Unix-like system.  For GNUstep and macOS,
@@ -552,13 +572,25 @@ need to create them if you have nothing to put in th=
em.
 5) Refer to the file './etc/TERMS' for information on fields you may
 wish to add to various termcap entries.  (This is unlikely to be necessar=
y.)

-6) Run 'make' in the top directory of the Emacs distribution to finish
-building Emacs in the standard way.  The final executable file is
-named 'src/emacs'.  You can execute this file "in place" without
-copying it, if you wish; then it automatically uses the sibling
-directories ../lisp, ../lib-src, ../info.
-
-Or you can "install" the executable and the other files into their
+6) After building Emacs, you can invoke the Emacs executable "in place",
+i.e., from the directory where it was built, or you can first install it
+and then invoke the installed executable.
+
+6a) Run 'make' in the top directory of the Emacs distribution to finish
+building Emacs in the standard way.  The final executable file is named
+'src/emacs'.  You can execute this file "in place" without copying it,
+if you wish; then it automatically uses the sibling directories ../lisp,
+../lib-src, ../info, ../native-lisp (if built with support for native
+compilation).
+
+6b) If you built Emacs in a directory outside of the source directory
+("out-of-tree"), it still uses the ../lisp and ../info directories in
+the source directory (because byte-compiled Lisp files and Info files
+are machine-independent), but the ../lib-src and ../native-lisp files in
+the build directory (because these compiled files are
+machine-dependent).
+
+6c) Or you can "install" the executable and the other files into their
 installed locations, with 'make install'.  By default, Emacs's files
 are installed in the following directories:

@@ -574,6 +606,11 @@ are installed in the following directories:
 		at the same time; in particular, you don't have to
 		make Emacs unavailable while installing a new version.

+'/usr/local/share/emacs/VERSION/native-lisp' holds the natively compiled
+		pre-loaded Emacs Lisp files.
+
+'~/.emacs.d/eln-cache/' holds the remaining natively compiled Lisp files.
+
 '/usr/local/share/emacs/VERSION/etc' holds the Emacs tutorial, the DOC
 		file, and other architecture-independent files Emacs
 		might need while running.

--=-=-=--
Acknowledgement sent to Stephen Berman <stephen.berman@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#70246; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Mon, 8 Apr 2024 12:15:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.