From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id 4BcLJRRuumGlWwAAgWs5BA (envelope-from ) for ; Wed, 15 Dec 2021 23:37:08 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id SOHOIBRuumGUIAAAB5/wlQ (envelope-from ) for ; Wed, 15 Dec 2021 22:37:08 +0000 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 53024140B6 for ; Wed, 15 Dec 2021 23:37:08 +0100 (CET) Received: from localhost ([::1]:38620 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mxctW-0003w7-UC for larch@yhetil.org; Wed, 15 Dec 2021 17:37:06 -0500 Received: from eggs.gnu.org ([209.51.188.92]:58186) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mxctS-0003tS-Ij for guix-patches@gnu.org; Wed, 15 Dec 2021 17:37:02 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:50621) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mxctS-000783-Am for guix-patches@gnu.org; Wed, 15 Dec 2021 17:37:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mxctS-0001nh-7d for guix-patches@gnu.org; Wed, 15 Dec 2021 17:37:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#52505] [PATCH v2 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 22:37: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.16396077956875 (code B ref 52505); Wed, 15 Dec 2021 22:37:02 +0000 Received: (at 52505) by debbugs.gnu.org; 15 Dec 2021 22:36:35 +0000 Received: from localhost ([127.0.0.1]:33932 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mxct1-0001mp-60 for submit@debbugs.gnu.org; Wed, 15 Dec 2021 17:36:35 -0500 Received: from mx1.dismail.de ([78.46.223.134]:27769) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mxcsy-0001mR-CG for 52505@debbugs.gnu.org; Wed, 15 Dec 2021 17:36:33 -0500 Received: from mx1.dismail.de (localhost [127.0.0.1]) by mx1.dismail.de (OpenSMTPD) with ESMTP id 61ccaa8d; Wed, 15 Dec 2021 23:36:24 +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=/5Npv7HCxhtHTrtDNdHzbVD+K/LqtVrnFNaJHMkcsRs=; b= CkR5XCe6JGDxBnj6roC6P9hr8mDlwK53eamV0QHPt8cZiJONWDODo5CAbY50gLdg mosxdDEWy4xEBEs+BfD19wyAVCZD3kFBHQL4B8l0IM9YJvbQTnmY8gVC1eLWvQS2 5egQ5OvRRVMOc2M9n5D1LlrvqqCQ3p18j6FCLrAvAOQULLS22thQn4IdC22goXrv VgOSd4QoMh+MsYihGrCFWcSMaSMncN3gCpVsj+OP1I20CuZgezO38xrpbh+rQ19Z K8wwf6A9JL1wIJvV9HY3zbu5q4a/WRGRnHWt/x/sNE9AMSH0vffBgq8jQVHPVsXp Y2dGeovCNWeDuwd78s9MfQ== Received: from smtp2.dismail.de ( [10.240.26.12]) by mx1.dismail.de (OpenSMTPD) with ESMTP id 3e3d0f43; Wed, 15 Dec 2021 23:36:24 +0100 (CET) Received: from smtp2.dismail.de (localhost [127.0.0.1]) by smtp2.dismail.de (OpenSMTPD) with ESMTP id f668058a; Wed, 15 Dec 2021 23:36:24 +0100 (CET) Received: by dismail.de (OpenSMTPD) with ESMTPSA id d7bbc637 (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO); Wed, 15 Dec 2021 23:36:23 +0100 (CET) Date: Wed, 15 Dec 2021 17:34:55 -0500 Message-Id: <20211215223455.4990-1-jgart@dismail.de> X-Mailer: git-send-email 2.34.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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+larch=yhetil.org@gnu.org Sender: "Guix-patches" Reply-to: jgart X-ACL-Warn: , jgart via Guix-patches From: jgart via Guix-patches via X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1639607828; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: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=kf0cWD4SOeOfgePVm9DXTyqirUb2XNvAxHAHipQQA2o=; b=Z8CTJRjucjIcNhPM+e/JYYWmtKB7afZCkKML6+h9xD+Hn+zlKSWHYLqGBWA7SOqzNBd2RK doyn99+yv2h3gDUvfnAbLWf9lzEbMNWxgSKgItwrooCc6rYmaIo9iUoO2zefWomAN/KdPr NFAeRWaCkodVXvTQ2q32Sqpoq6cb2gRh88y0cVT4ym5YRWrctYKMdSGDnOUmFMeJ6t3LWw VJwWvKZR7abIRyGg7hapTcq7NVe7oTyFRB932q6D7A8CWAxM7L1H+ODCwh2mUShI8+MdQD MDb8XVK/rAGnu5aSQgIV355EpvE84HJ7fMOdBofyrAD36aUuQdDyEkO9jll7tQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1639607828; a=rsa-sha256; cv=none; b=SxE13TkitZs9LGSt+XfHs5LgiDWAr3wL9HLmAj6xBVK+747TirxgxYVIm0bY/+Mpw+xHdd EtGZp2VOaG1Z1j7dj0rt7d9XVzz4M9vEVMrCCOfZwjhZeukwFMizT8DK1DK4nCGCFRk2SV wkWxzSfYZoDTZT8eazx34luiC0Ep03kIvyNVR32wRVoV51Iy44/kekZv/RfDB+jX/yddeF dHd0da+z4blJjikgFshc9gfvc8VIWMzCc4d/rDHAvRADJUEan+hQq42JWzllHckUA+Uy7N +wJpij3m/3r5bmRB/nQd1cC4rDINy6Ly2SmUSnbBdwHgOcEQbduMVn3ENY5czg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=dismail.de header.s=20190914 header.b=CkR5XCe6; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.98 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=dismail.de header.s=20190914 header.b=CkR5XCe6; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 53024140B6 X-Spam-Score: -3.98 X-Migadu-Scanner: scn0.migadu.com X-TUID: WKrrNKffh/qZ From: Guix Together Hi all, Here is version 2 with your requested changes. Let me know if there is anything else I might have missed. Thank you for the review. all best, jgart * 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..164e353884 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 -- 2.34.0