From patchwork Sun Feb 6 23:03:23 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?q?Pierre-Henry_Fr=C3=B6hring?= X-Patchwork-Id: 37035 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 3F45927BBEA; Sun, 6 Feb 2022 23:09:11 +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=-2.9 required=5.0 tests=BAYES_00,MAILING_LIST_MULTI, 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 01C1927BBE9 for ; Sun, 6 Feb 2022 23:09:11 +0000 (GMT) Received: from localhost ([::1]:38896 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nGqec-0004SR-64 for patchwork@mira.cbaines.net; Sun, 06 Feb 2022 18:09:10 -0500 Received: from eggs.gnu.org ([209.51.188.92]:42154) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nGqeV-0004S3-7h for guix-patches@gnu.org; Sun, 06 Feb 2022 18:09:03 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:46299) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nGqeU-0001mU-V8 for guix-patches@gnu.org; Sun, 06 Feb 2022 18:09:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nGqeT-0002Ur-RL for guix-patches@gnu.org; Sun, 06 Feb 2022 18:09:01 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#53827] [PATCH] Add a TLDR entry for building Guix from Git. References: <20220206213344.3117861-1-contact@phfrohring.com> In-Reply-To: <20220206213344.3117861-1-contact@phfrohring.com> Resent-From: Pierre-Henry =?utf-8?b?RnLDtmhyaW5n?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 06 Feb 2022 23:09:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 53827 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 53827@debbugs.gnu.org Cc: Pierre-Henry =?utf-8?b?RnLDtmhyaW5n?= Received: via spool by 53827-submit@debbugs.gnu.org id=B53827.16441888949533 (code B ref 53827); Sun, 06 Feb 2022 23:09:01 +0000 Received: (at 53827) by debbugs.gnu.org; 6 Feb 2022 23:08:14 +0000 Received: from localhost ([127.0.0.1]:40195 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nGqdi-0002Tg-30 for submit@debbugs.gnu.org; Sun, 06 Feb 2022 18:08:14 -0500 Received: from relay12.mail.gandi.net ([217.70.178.232]:50751) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nGqdR-0002Sc-V2 for 53827@debbugs.gnu.org; Sun, 06 Feb 2022 18:08:12 -0500 Received: (Authenticated sender: contact@phfrohring.com) by relay12.mail.gandi.net (Postfix) with ESMTPSA id 4D109200004; Sun, 6 Feb 2022 23:07:51 +0000 (UTC) From: Pierre-Henry =?utf-8?b?RnLDtmhyaW5n?= Date: Mon, 7 Feb 2022 00:03:23 +0100 Message-Id: <20220206230321.3142016-1-contact@phfrohring.com> 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" X-getmail-retrieved-from-mailbox: Patches Add a TLDR version of the `Building from Git' section of the Guix reference manual. --- doc/guix-cookbook.texi | 77 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) 2.34.0 diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi index d2ce525998..001c22f648 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,81 @@ 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. TLDR version of: +@pxref{Building from Git,,, guix, GNU Guix reference manual} + +@node Context +@section Context + +@itemize +@item +Guix is installed using binary installation. +@item +Git is installed +@end itemize + +@node Source +@section Source + +@example +mkdir ~/src; 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 + +The @code{localstatedir} value is the prefix of @code{/guix/db}. For +example, if: + +@example +$ find / -type d -path "*/guix/db" 2>/dev/null +/var/guix/db +@end example + +then the value of @code{localstatedir} is @code{/var}. + +@example +guix shell --pure -D guix +./bootstrap +./configure --localstatedir=/var +@end example + +@node Compile +@section Compile + +@example +make +make check +exit +@end example + +@node Test +@section Test + +@code{./pre-inst-env} lets you distinguish between this installation of +Guix and any other. + +@example +cd ~/src/guix +guix shell --pure -D guix +./pre-inst-env guix build hello +@end example + + @c ********************************************************************* @node Packaging @chapter Packaging --