From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id iPx1KNY/AGIInQAAgWs5BA (envelope-from ) for ; Sun, 06 Feb 2022 22:38:30 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id KMkqJdY/AGIeAgAAauVa8A (envelope-from ) for ; Sun, 06 Feb 2022 22:38:30 +0100 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 3386C2A3D3 for ; Sun, 6 Feb 2022 22:38:30 +0100 (CET) Received: from localhost ([::1]:34524 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nGpEr-0007F5-BT for larch@yhetil.org; Sun, 06 Feb 2022 16:38:29 -0500 Received: from eggs.gnu.org ([209.51.188.92]:54218) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nGpCU-0005Le-Mw for guix-patches@gnu.org; Sun, 06 Feb 2022 16:36:04 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:46073) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nGpCU-0005Pq-DW for guix-patches@gnu.org; Sun, 06 Feb 2022 16:36:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nGpCU-00068j-4y for guix-patches@gnu.org; Sun, 06 Feb 2022 16:36:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. Resent-From: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 06 Feb 2022 21:36:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 53827 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 53827@debbugs.gnu.org Cc: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.164418330523522 (code B ref -1); Sun, 06 Feb 2022 21:36:01 +0000 Received: (at submit) by debbugs.gnu.org; 6 Feb 2022 21:35:05 +0000 Received: from localhost ([127.0.0.1]:39970 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nGpBY-00067K-RJ for submit@debbugs.gnu.org; Sun, 06 Feb 2022 16:35:05 -0500 Received: from lists.gnu.org ([209.51.188.17]:33260) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nGpBW-000674-BE for submit@debbugs.gnu.org; Sun, 06 Feb 2022 16:35:02 -0500 Received: from eggs.gnu.org ([209.51.188.92]:53994) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nGpBV-0004rO-R6 for guix-patches@gnu.org; Sun, 06 Feb 2022 16:35:01 -0500 Received: from relay3-d.mail.gandi.net ([217.70.183.195]:42801) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nGpBS-000559-PT for guix-patches@gnu.org; Sun, 06 Feb 2022 16:35:01 -0500 Received: (Authenticated sender: contact@phfrohring.com) by mail.gandi.net (Postfix) with ESMTPSA id 1A9D860004; Sun, 6 Feb 2022 21:34:40 +0000 (UTC) From: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= Date: Sun, 6 Feb 2022 22:33:46 +0100 Message-Id: <20220206213344.3117861-1-contact@phfrohring.com> X-Mailer: git-send-email 2.34.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=217.70.183.195; envelope-from=contact@phfrohring.com; helo=relay3-d.mail.gandi.net X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action 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" 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=1644183510; h=from:from:sender:sender: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:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=UO30m4/DWmoNcoQ3WiRgkFSy8b4DC+XcargtxRBH/5k=; b=FR4JHS576lpBZN9MBDcRoVCF32Az2Bu3pzAbKwEW7v5ImVcJ36vlv64E9vuiQSK1Xsq4rf SZH2IOLhtGzeAxxyUzuSdq0y8f6RdUsLb4lpilEAyAK/vQnKflvuQwHOy95hBrmxpT0yUP ddZnsrpPs9Ii6ffbR7mmreUNo/CkAqv6JTVNyOfkrh+A1hCZe6/P1NuqEIV7GIlPmS2LJj OmIhQ3r9G6x7EdCPYcUtlpFBCivRjZQp6Q0DY2D5v2RkSTByzjSMWKV8QVAHRTE+NKaXWN ww2cryM2R+uVS14kPC7RWy/R1gpjL7a+enZmiz5NnOoUvsTGIUOs7IFpgxCR0w== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1644183510; a=rsa-sha256; cv=none; b=U6nTMsx+joLwzAYVQXu6B6cahZqnivKMTHIP1C3NeqnsIkMt9WRYrnKttQYj9lo6mDhAs/ Ti2VusVfPvj9hHUnIO80X/eem7xpXH+AbzfH9uZulp293VerUr3NuPiBzLM4+DT7POQLWl GWpl9EehQ6DckuxvL6FSSId8c0zw5NuC45tgOcl6NCaGsd/KOm4Kky3gQSl7izwboS/6/W 4vc/FDwtZWb6DjvA005Mg05NyDuDEUhUWSBNr1GLstxZtFMUU9nhACqfiUZf3z+SK2UfwP 5tzulcdik49aYEt7e7YzMzWrHe4mP6XIayFgK/WpjZCA7tZPzFr9gbBfaIfe1w== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; 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: -1.93 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; 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: 3386C2A3D3 X-Spam-Score: -1.93 X-Migadu-Scanner: scn1.migadu.com X-TUID: LE+yptAinsj/ --- doc/guix-cookbook.texi | 68 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi index d2ce525998..2d004d7a6b 100644 --- a/doc/guix-cookbook.texi +++ b/doc/guix-cookbook.texi @@ -66,6 +66,7 @@ Weblate} (@pxref{Translating Guix,,, guix, GNU Guix reference manual}). @menu * Scheme tutorials:: Meet your new favorite language! +* Building from Git:: Hack Guix itself * Packaging:: Packaging tutorials * System Configuration:: Customizing the GNU System * Advanced package management:: Power to the users! @@ -301,7 +302,73 @@ You'll find more books, tutorials and other resources at @url{https://schemers.org/}. +@c ********************************************************************* +@node Building from Git +@chapter Building from Git + +Build Guix from Git and start hacking. + +@node Context +@section Context + +@itemize +@item +Guix is installed using binary installation. +@end itemize + +@node Source +@section Source + +@example +cd ~/src +git clone https://git.savannah.gnu.org/git/guix.git +@end example + +@node Authentication +@section Authentication + +@example +git fetch origin keyring:keyring +guix git authenticate 9edb3f66fd807b096b48283debdcddccfea34bad \ + "BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA" +@end example + +@node Development environment +@section Development environment + +@example +guix environment guix --pure --ad-hoc fd +./bootstrap +guix_db_prefix=$(fd -p '.*/guix/db$' /) +guix_db_prefix=$@{guix_db_prefix%/guix/db@} +./configure --localstatedir="$guix_db_prefix" +exit +make authenticate +@end example + +@node Compile +@section Compile + +@example +guix environment guix --pure +make +make check +exit +@end example + +@node Test +@section Test + +@code{./pre-inst-env} let's you distinguish between this installation of +Guix and any other. + +@example +cd ~/src/guix +guix environment guix --pure +./pre-inst-env guix build hello +@end example + + @c ********************************************************************* @node Packaging @chapter Packaging -- 2.34.0