From patchwork Wed Dec 15 11:20:41 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: jgart X-Patchwork-Id: 35236 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 3EED327BBEA; Wed, 15 Dec 2021 11:52:37 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-3.7 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS, URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 00AD027BBE9 for ; Wed, 15 Dec 2021 11:52:37 +0000 (GMT) Received: from localhost ([::1]:56768 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mxSpn-0001r4-Ss for patchwork@mira.cbaines.net; Wed, 15 Dec 2021 06:52:35 -0500 Received: from eggs.gnu.org ([209.51.188.92]:50738) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mxSMG-0004vj-3w for guix-patches@gnu.org; Wed, 15 Dec 2021 06:22:04 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:48822) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mxSME-0006FN-FR for guix-patches@gnu.org; Wed, 15 Dec 2021 06:22:03 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mxSME-0001od-B9 for guix-patches@gnu.org; Wed, 15 Dec 2021 06:22:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#52505] [PATCH 1/2] doc: Explain the use of make clean-go when an ABI mismatch occurs. References: <20211215061623.GB25522@gac.attlocal.net> In-Reply-To: <20211215061623.GB25522@gac.attlocal.net> Resent-From: jgart Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 15 Dec 2021 11:22:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52505 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 52505@debbugs.gnu.org Cc: Julien Lepiller , Ryan Prior , Guix Together , Blake Shaw Received: via spool by 52505-submit@debbugs.gnu.org id=B52505.16395673166961 (code B ref 52505); Wed, 15 Dec 2021 11:22:02 +0000 Received: (at 52505) by debbugs.gnu.org; 15 Dec 2021 11:21:56 +0000 Received: from localhost ([127.0.0.1]:60366 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mxSM7-0001o5-T4 for submit@debbugs.gnu.org; Wed, 15 Dec 2021 06:21:56 -0500 Received: from mx1.dismail.de ([78.46.223.134]:21123) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mxSM5-0001no-Id for 52505@debbugs.gnu.org; Wed, 15 Dec 2021 06:21:55 -0500 Received: from mx1.dismail.de (localhost [127.0.0.1]) by mx1.dismail.de (OpenSMTPD) with ESMTP id 02073a36; Wed, 15 Dec 2021 12:21:46 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=dismail.de; h=from:to:cc :subject:date:message-id:mime-version:content-transfer-encoding; s=20190914; bh=DsrTBNTpzD5IgCj2wyB0n5PepEXMINtC3smSZvYhq9Q=; b= eQMljljBdpkSB1MmmJJWB7yghNgG+O17yeZG2w/Z6j4KSUyaO/4Cuo/v5sSnjVcJ 8G5UeiOqt/P1/3hRED29ojDwx8b3GG3TM5Mno3aX40/JFbWj83Z5rp9qaD4erN69 dAB18RY5Hf+5tlTJ9dZ1tIX05jSabPScGcJbVUPTsKOu5KRE28dHRzMt4KO+dTB0 S/3dOkgJKe2fetQfXGssk+B0Y5ZQBCfREXdUfFutMOn3OOuuIdDwUH5PUijithVy rLWpArHHRKDQ6APKad4TUjzyD5ZvD3Yzk5E6Gf+wii3F2Na9nLZ9nAf+4PS/eMLP psVF78FKeAuT9cjxoGFMKg== Received: from smtp1.dismail.de ( [10.240.26.11]) by mx1.dismail.de (OpenSMTPD) with ESMTP id 07bf09f0; Wed, 15 Dec 2021 12:21:46 +0100 (CET) Received: from smtp1.dismail.de (localhost [127.0.0.1]) by smtp1.dismail.de (OpenSMTPD) with ESMTP id a7d6c0f1; Wed, 15 Dec 2021 12:21:46 +0100 (CET) Received: by dismail.de (OpenSMTPD) with ESMTPSA id cc14e42c (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO); Wed, 15 Dec 2021 12:21:45 +0100 (CET) Date: Wed, 15 Dec 2021 06:20:41 -0500 Message-Id: <20211215112040.25851-1-jgart@dismail.de> X-Mailer: git-send-email 2.34.0 MIME-Version: 1.0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: "Guix-patches" Reply-to: jgart X-ACL-Warn: , jgart via Guix-patches X-Patchwork-Original-From: jgart via Guix-patches via From: jgart X-getmail-retrieved-from-mailbox: Patches From: Guix Together * doc/contributing.texi (Building from Git): Adds section on using make clean-go. Co-authored-by: jgart Co-authored-by: Julien Lepiller Co-authored-by: Ryan Prior Co-authored-by: Blake Shaw --- doc/contributing.texi | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/contributing.texi b/doc/contributing.texi index db1c4c6921..1bcb550aac 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -157,6 +157,18 @@ You are advised to run @command{make authenticate} after every changes to the repository. @end quotation +After updating the repository, @command{make} might fail with an error +similar to the following example: + +@example +error: failed to load 'gnu/packages/dunst.scm': +ice-9/eval.scm:293:34: In procedure abi-check: #>: record ABI mismatch; recompilation needed +@end example + +This means that one of the record types that Guix defines (in this +example, the @code{origin} record) has changed, and all of guix needs +to be recompiled to take that change into account. To do so, run +@command{make clean-go} followed by @command{make}. @node Running Guix Before It Is Installed @section Running Guix Before It Is Installed