From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id QNMhNJsleGa5zgAA62LTzQ:P1 (envelope-from ) for ; Sun, 23 Jun 2024 13:39:40 +0000 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id QNMhNJsleGa5zgAA62LTzQ (envelope-from ) for ; Sun, 23 Jun 2024 15:39:39 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20230601 header.b=FL5hkJXe; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1719149979; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=vvBmjt97FqmEMQ8qLnMn6iMvORBzuprLY+B8VsXilaM=; b=IA6yyVLh6V43Kn7XqAKaLNnF0oEuxrcV1HbFrbuZdjHxVdV2sXtSTQSGQcjeWZezrN2XNM u39FCSSuRTA65banjnuQWA/JaB4HdwGk0gAp7abxml3omnTlIG/H3vZzFzO2PL2QrTXDGQ BKWg49xUFRhl0mTcIBxPN/DhbeHMcjyOyec74YwsNSojNZVLWzpsPNyIDbW65zpudWXbLF 0JrOrKYHDmdKaL+FtFW/2hwuY1L9JOX59lA/KNArTp9p6hCRfBqGFw9Lw/FWcSq5+tuYwt gwfyzAKJMprAq+kP0byv5VaW7+IbEMyyKYK2OQjqU+ksMsWzRCakoZfI2Z538g== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1719149979; a=rsa-sha256; cv=none; b=LENlKLaqbSIPM8CDjNK9b5St2F/CmsDMzyhsSmn+yOvKIfbpu3nFRn9An52mKWmNGdvKi9 4QzjjAMQbThkInZloifFKwZ+nJiWeR10w8jlo6i0d7O22kGxXSwvrFK/dJcH+d1xXFYe/B JDkSXacOhJlJ5p4JHWhLuGpz4hNJpa14L0uUF7l15RtQo+9oN2SXp6sFOBvQecABhcwhz8 6Mi32e/8w/uKkKKQM9qYj/26os25A1N3s32YRvnZigQDmcB9xVDeudqBN/v0TeuG2T3F+s kxQhs/5B5K24h7o1C8plOyC+1mpUivjmeqgAW8k6YwMn/WuoH5169+ybJoQlow== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20230601 header.b=FL5hkJXe; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id A8546615E1 for ; Sun, 23 Jun 2024 15:39:39 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sLNQu-0004cb-K9; Sun, 23 Jun 2024 09:39:04 -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 ) id 1sLNQs-0004bp-Kk for bug-guix@gnu.org; Sun, 23 Jun 2024 09:39:02 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sLNQs-0006SJ-Co for bug-guix@gnu.org; Sun, 23 Jun 2024 09:39:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sLNQs-0003iO-Km; Sun, 23 Jun 2024 09:39:02 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#71730: [PATCH] doc: Update note on Emacs packages. References: In-Reply-To: Resent-From: Liliana Marie Prikler Original-Sender: "Debbugs-submit" Resent-CC: andrew@trop.in, cox.katherine.e+guix@gmail.com, liliana.prikler@gmail.com, bug-guix@gnu.org Resent-Date: Sun, 23 Jun 2024 13:39:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71730 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: 71730@debbugs.gnu.org Cc: Adam Porter , andrew@trop.in, cox.katherine.e+guix@gmail.com, liliana.prikler@gmail.com X-Debbugs-Original-Xcc: andrew@trop.in, cox.katherine.e+guix@gmail.com, liliana.prikler@gmail.com Received: via spool by 71730-submit@debbugs.gnu.org id=B71730.171914990914199 (code B ref 71730); Sun, 23 Jun 2024 13:39:02 +0000 Received: (at 71730) by debbugs.gnu.org; 23 Jun 2024 13:38:29 +0000 Received: from localhost ([127.0.0.1]:59552 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sLNQK-0003gv-JT for submit@debbugs.gnu.org; Sun, 23 Jun 2024 09:38:28 -0400 Received: from mail-wm1-f66.google.com ([209.85.128.66]:53318) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sLNQJ-0003ge-16 for 71730@debbugs.gnu.org; Sun, 23 Jun 2024 09:38:27 -0400 Received: by mail-wm1-f66.google.com with SMTP id 5b1f17b1804b1-42189d3c7efso38380195e9.2 for <71730@debbugs.gnu.org>; Sun, 23 Jun 2024 06:38:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1719149841; x=1719754641; darn=debbugs.gnu.org; h=mime-version:cc:to:subject:date:from:message-id:from:to:cc:subject :date:message-id:reply-to; bh=vvBmjt97FqmEMQ8qLnMn6iMvORBzuprLY+B8VsXilaM=; b=FL5hkJXeMgA0rX9Szay2oH/mnjAKjCmPcrXjte3nT4oryGl6VKXYTsLIiHh0/u8URX qWkyHcn7uRzfZWCGmjPo79ktelru45VAxAtY6+dN1B9CVZjkZw6bqK35qaXE3gg+xd0X yznPUAtps7duN4q7HXLNvsKyK5Gpw8NSRDNscslumZ0as9q00i9SJVj7mw6AU7fjiX5K wwCtgGkiSz8nl4WGdGu2OTyWriBJy++OYdGZTDqKDtOaLiX8o1CUymp7vXkrJ70jMwRb Ep1dLC6wme9p/s8vqfFCAYhT5vud/K73ktTvtp0ZSr5qAzqPA8GEs6ehT/vJ0mTJzOar HqJQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1719149841; x=1719754641; h=mime-version:cc:to:subject:date:from:message-id:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=vvBmjt97FqmEMQ8qLnMn6iMvORBzuprLY+B8VsXilaM=; b=PKPq68F3rAj+cFAtI1JgfWYZYISh0zF5T4l7MnGmHY7YpbgR9WI6Y7I+lXLEyfI/dG 78cLK4dBY/YFto2d8kFrQG682TzkVKnQ79Kwo3bMf12KAOURCNYZdkj9A1os+eVwieT8 WNzU+4WPu7FagIl/30ob+JEaONOl9GcSWXxRu+7pAkT6hWeLPb+wjEK6fZHfu5pbqH5i U7zOqf/q7CT6JbBehGVGrFaM1lz12E0EFy4rejDqmFSsEzPQUDU7wrjWvT6/ayUGYOp3 nBcVy5IaKNtWOTHPsNkPCxCOXsDNPyitNsQny3as/8q8h5dweiCSguKmqV4z95PTZOVE kn4Q== X-Gm-Message-State: AOJu0Yzoe98XAkWGX0pC+pksGqS3zLmBVRNItEeY0Zh/rV6YhVcEaZzv EBGgmK/KhJKNdpnSRzcmwanGanUzWeaopgcjKGcKP0LTvgJpZf41o1Gph08W X-Google-Smtp-Source: AGHT+IEBCEcmGVAihiCfLnjTkTSavJJCGY6vedALzOUpIz7IZk0dht+rxGCrcTKFuqSxux7lP7pW6Q== X-Received: by 2002:a05:6000:118f:b0:360:7a52:3078 with SMTP id ffacd0b85a97d-366e95eb72cmr1475772f8f.46.1719149840361; Sun, 23 Jun 2024 06:37:20 -0700 (PDT) Received: from lumine.fritz.box (85-127-52-93.dsl.dynamic.surfer.at. [85.127.52.93]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-366383f670csm7425294f8f.11.2024.06.23.06.37.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 23 Jun 2024 06:37:19 -0700 (PDT) Message-ID: <53c155ebad457dcc74e5d402d4948c7fb9536b1f.1719149100.git.liliana.prikler@gmail.com> From: Liliana Marie Prikler Date: Sun, 23 Jun 2024 15:17:07 +0200 MIME-Version: 1.0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: bug-guix-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -0.76 X-Spam-Score: -0.76 X-Migadu-Queue-Id: A8546615E1 X-Migadu-Scanner: mx11.migadu.com X-TUID: ytKycTS3CKto * doc/guix.texi ("Emacs packages"): Expand note to talk about differences between native compilation upstream and as used in Guix. --- doc/guix.texi | 31 ++++++++++++++++++++++--------- 1 file changed, 22 insertions(+), 9 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 9bbf85e32b..67c5cef757 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -1878,15 +1878,28 @@ Application Setup File,,, emacs, The GNU Emacs Manual}). @quotation Note -Emacs can now compile packages natively. Under the default -configuration, this means that Emacs packages will now be -just-in-time (JIT) compiled as you use them, and the results -stored in a subdirectory of your @code{user-emacs-directory}. - -Furthermore, the build system for Emacs packages transparently -supports native compilation, but note, that -@code{emacs-minimal}---the default Emacs for building -packages---has been configured without native compilation. +Most Emacs variants are now capable of doing native compilation. +The approach taken by Guix Emacs however differs greatly +from the approach taken upstream. + +Upstream Emacs compiles packages just-in-time and typically places +shared object files in a special folder within your +@code{user-emacs-directory}. +These shared objects within said folder are organized in a +flat hierarchy, and their file names contain two hashes to +verify the original file name and contents of the source code. + +Guix Emacs on the other hand prefers to compile packages ahead-of-time. +Shared objects retain much of the original file name and no hashes +are added to verify the original file name or the contents of the file. +Crucially, this allows Guix Emacs and packages built against it +to be grafted (@pxref{Security Updates, grafts}), but at the same time, +Guix Emacs lacks the hash-based verification of source code baked +into upstream Emacs. As this naming schema is trivial to exploit, +we disable just-in-time compilation. + +Further note, that @code{emacs-minimal}---the default Emacs +for building packages---has been configured without native compilation. To natively compile your emacs packages ahead of time, use a transformation like @option{--with-input=emacs-minimal=emacs}. @end quotation base-commit: 11c403ec0554be0e1c888ec6f8147a232e09adbd -- 2.45.1