X-Loop: help-debbugs@HIDDEN
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?= <contact@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Sun, 06 Feb 2022 21:36:01 +0000
Resent-Message-ID: <handler.53827.B.164418330523522 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: report 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: 53827 <at> debbugs.gnu.org
Cc: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>
X-Debbugs-Original-To: guix-patches@HIDDEN
Received: via spool by submit <at> 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 <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nGpBY-00067K-RJ
for submit <at> 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 <contact@HIDDEN>) id 1nGpBW-000674-BE
for submit <at> 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 <contact@HIDDEN>)
id 1nGpBV-0004rO-R6
for guix-patches@HIDDEN; 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 <contact@HIDDEN>)
id 1nGpBS-000559-PT
for guix-patches@HIDDEN; Sun, 06 Feb 2022 16:35:01 -0500
Received: (Authenticated sender: contact@HIDDEN)
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?= <contact@HIDDEN>
Date: Sun, 6 Feb 2022 22:33:46 +0100
Message-Id: <20220206213344.3117861-1-contact@HIDDEN>
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@HIDDEN; 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-Spam-Score: -1.7 (-)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.7 (--)
---
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
Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) Content-Type: text/plain; charset=utf-8 X-Loop: help-debbugs@HIDDEN From: help-debbugs@HIDDEN (GNU bug Tracking System) To: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN> Subject: bug#53827: Acknowledgement ([PATCH] Add a TLDR entry to the cookbook for building Guix from Git.) Message-ID: <handler.53827.B.164418330523522.ack <at> debbugs.gnu.org> References: <20220206213344.3117861-1-contact@HIDDEN> X-Gnu-PR-Message: ack 53827 X-Gnu-PR-Package: guix-patches X-Gnu-PR-Keywords: patch Reply-To: 53827 <at> debbugs.gnu.org Date: Sun, 06 Feb 2022 21:36:02 +0000 Thank you for filing a new bug report with debbugs.gnu.org. This is an automatically generated reply to let you know your message has been received. Your message is being forwarded to the package maintainers and other interested parties for their attention; they will reply in due course. Your message has been sent to the package maintainer(s): guix-patches@HIDDEN If you wish to submit further information on this problem, please send it to 53827 <at> debbugs.gnu.org. Please do not send mail to help-debbugs@HIDDEN unless you wish to report a problem with the Bug-tracking system. --=20 53827: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D53827 GNU Bug Tracking System Contact help-debbugs@HIDDEN with problems
X-Loop: help-debbugs@HIDDEN
Subject: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git.
Resent-From: Maxime Devos <maximedevos@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Sun, 06 Feb 2022 22:03:02 +0000
Resent-Message-ID: <handler.53827.B53827.164418495926344 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>, 53827 <at> debbugs.gnu.org
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.164418495926344
(code B ref 53827); Sun, 06 Feb 2022 22:03:02 +0000
Received: (at 53827) by debbugs.gnu.org; 6 Feb 2022 22:02:39 +0000
Received: from localhost ([127.0.0.1]:40007 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nGpcE-0006qq-O4
for submit <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:02:38 -0500
Received: from michel.telenet-ops.be ([195.130.137.88]:38652)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <maximedevos@HIDDEN>) id 1nGpcD-0006qj-Cf
for 53827 <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:02:37 -0500
Received: from [172.20.10.5] ([188.188.37.53])
by michel.telenet-ops.be with bizsmtp
id ry2R2600618o4tG06y2bKM; Sun, 06 Feb 2022 23:02:36 +0100
Message-ID: <2c51e2236116c55e112199a2dbfb143361e88ae8.camel@HIDDEN>
From: Maxime Devos <maximedevos@HIDDEN>
Date: Sun, 06 Feb 2022 23:02:25 +0100
In-Reply-To: <20220206213344.3117861-1-contact@HIDDEN>
References: <20220206213344.3117861-1-contact@HIDDEN>
Content-Type: multipart/signed; micalg="pgp-sha512";
protocol="application/pgp-signature"; boundary="=-qC/v8585gPasuqLH7fSt"
User-Agent: Evolution 3.38.3-1
MIME-Version: 1.0
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r22;
t=1644184956; bh=YnOnmSUrmhnU/Cwl3g6cm1aQi3TfdAwq5ld6OVuvN5E=;
h=Subject:From:To:Date:In-Reply-To:References;
b=hKNnyrKhF2xJxfDiwSRU75+ZRZbDgRdo6XUsp5XYFXosATSfbJ9M56ZML7LQAW3UH
WRBgZG3EYX6mQKv/kKf5OfFqLUc4Og1mmHCP+CbqWIXCvmu0YJ0gZKe1w3/bJ+C3kt
ASUUg7zG+15Y5Ml+QA/2Xtbu9urs9aL5kRWfde2YC0bRIeZUmC0RuM76BdFJh7fxQt
TrByZZsY0+AGgflZrGqTcobefp41nZHMHIYu1Et5BJf97jo1BHi3jw2q686gGK4BSA
Ckfsu6/eqfszR5H1cZJIZHH2r32ShsAtDCoOgKWNZDBHyq7KJlzibpIRj6WqBH65dd
WQYOuAmhDLJYg==
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
--=-qC/v8585gPasuqLH7fSt
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Pierre-Henry Fr=C3=B6hring schreef op zo 06-02-2022 om 22:33 [+0100]:
> +@node Building from Git
> +@chapter Building from Git
> +
> +Build Guix from Git and start hacking.
> +
> +@node Context
> +@section Context
This is all explained in the main manual in more detail, can a cross-
reference to =E2=80=98(guix)Building from Git=E2=80=99 be added?
--=-qC/v8585gPasuqLH7fSt
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: This is a digitally signed message part
Content-Transfer-Encoding: 7bit
-----BEGIN PGP SIGNATURE-----
iI0EABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYgBFcRccbWF4aW1lZGV2
b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7mYBAP4sPzZeG21/Aad4a0ydnd3rZEOi
Cr1rBUXbQLE0P4PvsAEA9DiP/Qp/9Qoo1c8VAbOMN1erlR0HOVpZtT1ZsdJrZAY=
=ERMG
-----END PGP SIGNATURE-----
--=-qC/v8585gPasuqLH7fSt--
X-Loop: help-debbugs@HIDDEN
Subject: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git.
Resent-From: Maxime Devos <maximedevos@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Sun, 06 Feb 2022 22:03:02 +0000
Resent-Message-ID: <handler.53827.B53827.164418496726365 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>, 53827 <at> debbugs.gnu.org
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.164418496726365
(code B ref 53827); Sun, 06 Feb 2022 22:03:02 +0000
Received: (at 53827) by debbugs.gnu.org; 6 Feb 2022 22:02:47 +0000
Received: from localhost ([127.0.0.1]:40011 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nGpcM-0006rB-U7
for submit <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:02:47 -0500
Received: from albert.telenet-ops.be ([195.130.137.90]:39224)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <maximedevos@HIDDEN>) id 1nGpcL-0006r2-6o
for 53827 <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:02:45 -0500
Received: from [172.20.10.5] ([188.188.37.53])
by albert.telenet-ops.be with bizsmtp
id ry2j2600H18o4tG06y2jt4; Sun, 06 Feb 2022 23:02:44 +0100
Message-ID: <2e8bc664e39df799c170991789c497422fa5095b.camel@HIDDEN>
From: Maxime Devos <maximedevos@HIDDEN>
Date: Sun, 06 Feb 2022 23:02:43 +0100
In-Reply-To: <20220206213344.3117861-1-contact@HIDDEN>
References: <20220206213344.3117861-1-contact@HIDDEN>
Content-Type: multipart/signed; micalg="pgp-sha512";
protocol="application/pgp-signature"; boundary="=-p4CxNEQlnaHzaGA9VV37"
User-Agent: Evolution 3.38.3-1
MIME-Version: 1.0
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r22;
t=1644184964; bh=1n9DDoTK1Tbr8EiC2gRzdAW0SThwbFm9sOXMG1xieXE=;
h=Subject:From:To:Date:In-Reply-To:References;
b=amxnURVQ6jG2fizMJdFOBDS49TD7uVUkOXtfHrFdlfB7Lo8E1c9kzsiZQ/Fb0dPqg
p5S/PvTzlG3F1E/VYUMb0j+8Kq3J5fIi3+fmSlO8McfUqqNtCBdH2q0MIz1yuZ/5zZ
/+729xe+N1il59MtAeTLmYwdgjnCSWOgbdNRkE1cRCRrqAPFvsJBUadWRWTBDn2Wrc
a/hejx+aTgYqf8WHJNrt/6EZsmIMDWUtcTk0VjYiLq7CKSf6w3OOh+HiyB2aIV34qV
3eJ8HKjtT70lgP2Wg0+kf8t/kMMIeHKkrdJJIiU49KpZ74Y4k/0Ma7ikaRZaDcMly9
jCORrqfssghow==
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
--=-p4CxNEQlnaHzaGA9VV37
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Pierre-Henry Fr=C3=B6hring schreef op zo 06-02-2022 om 22:33 [+0100]:
> +@code{./pre-inst-env} let's you distinguish between this installation of
"lets", not "let's"
--=-p4CxNEQlnaHzaGA9VV37
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: This is a digitally signed message part
Content-Transfer-Encoding: 7bit
-----BEGIN PGP SIGNATURE-----
iI0EABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYgBFgxccbWF4aW1lZGV2
b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7iW+AQDEEyjC0moyECahZI51S6X1MQ6P
u7yEwheK31jwzZvjBAEA/PCOUjZVucTC34f5LUKPHATToPK+TByS6I7Kz3BYzAg=
=Bi6e
-----END PGP SIGNATURE-----
--=-p4CxNEQlnaHzaGA9VV37--
X-Loop: help-debbugs@HIDDEN
Subject: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git.
Resent-From: Maxime Devos <maximedevos@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Sun, 06 Feb 2022 22:04:02 +0000
Resent-Message-ID: <handler.53827.B53827.164418498926432 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>, 53827 <at> debbugs.gnu.org
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.164418498926432
(code B ref 53827); Sun, 06 Feb 2022 22:04:02 +0000
Received: (at 53827) by debbugs.gnu.org; 6 Feb 2022 22:03:09 +0000
Received: from localhost ([127.0.0.1]:40017 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nGpcj-0006sG-4O
for submit <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:03:09 -0500
Received: from laurent.telenet-ops.be ([195.130.137.89]:38774)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <maximedevos@HIDDEN>) id 1nGpch-0006s8-9t
for 53827 <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:03:07 -0500
Received: from [172.20.10.5] ([188.188.37.53])
by laurent.telenet-ops.be with bizsmtp
id ry362600418o4tG01y367G; Sun, 06 Feb 2022 23:03:06 +0100
Message-ID: <9bc9c87058cfa3db9fbd8f39abd364015d421b23.camel@HIDDEN>
From: Maxime Devos <maximedevos@HIDDEN>
Date: Sun, 06 Feb 2022 23:03:05 +0100
In-Reply-To: <20220206213344.3117861-1-contact@HIDDEN>
References: <20220206213344.3117861-1-contact@HIDDEN>
Content-Type: multipart/signed; micalg="pgp-sha512";
protocol="application/pgp-signature"; boundary="=-S25ZxZRpPrgqgOOUoRbi"
User-Agent: Evolution 3.38.3-1
MIME-Version: 1.0
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r22;
t=1644184986; bh=+sc3slxtMr2KwGxfQY9Hy7rAR8AeBnFtuixFoYN/eJI=;
h=Subject:From:To:Date:In-Reply-To:References;
b=FeXw+OnP2xPv+4cr1lf+5vn9NFIIalvTM6Z61yg5hYRyLc1tN4kOgmnV1QKtCGP1T
fmOTbj7WRsIST4Hn2eKJOJYb5zccY5cKcs0tcRWXKtcLxcDOCQ2OD1rno4VvnRqnWZ
kHzhn42j5NcHi26dN5+V+ZpkJZI1rX5x2I/m68BkwIL80Bv97bXImdTYUnbQvQrnOo
lbc3phqV7HqJvhZ+jgm89JgHr0gm73beLmtyVMk17x7Sn/+IkjXCOqgxEYnJvXb74b
7SlGHH+hkKDCUWjJssOZrkv32addxdtfDFll4q0ZpTS5x7Da91DOP/Fe6miUvgCYZl
Hd8PPtd8hRriw==
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
--=-S25ZxZRpPrgqgOOUoRbi
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Pierre-Henry Fr=C3=B6hring schreef op zo 06-02-2022 om 22:33 [+0100]:
> +guix environment guix --pure
Nowadays it's "guix shell":
"guix shell --pure -D guix"
--=-S25ZxZRpPrgqgOOUoRbi
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: This is a digitally signed message part
Content-Transfer-Encoding: 7bit
-----BEGIN PGP SIGNATURE-----
iI0EABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYgBFmRccbWF4aW1lZGV2
b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7meOAQDLxKFIiSaLPW5U68z8rB125o7V
YE+8xbF1dUcCHBZb3wEAlJOr9pzSyKicnN28D8+mZmUDwMCwCXPfoZYt/zLkjwQ=
=MhQD
-----END PGP SIGNATURE-----
--=-S25ZxZRpPrgqgOOUoRbi--
X-Loop: help-debbugs@HIDDEN
Subject: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git.
Resent-From: Maxime Devos <maximedevos@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Sun, 06 Feb 2022 22:07:01 +0000
Resent-Message-ID: <handler.53827.B53827.164418519526766 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>, 53827 <at> debbugs.gnu.org
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.164418519526766
(code B ref 53827); Sun, 06 Feb 2022 22:07:01 +0000
Received: (at 53827) by debbugs.gnu.org; 6 Feb 2022 22:06:35 +0000
Received: from localhost ([127.0.0.1]:40029 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nGpg2-0006xe-Qe
for submit <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:06:35 -0500
Received: from laurent.telenet-ops.be ([195.130.137.89]:41432)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <maximedevos@HIDDEN>) id 1nGpg2-0006xW-0Q
for 53827 <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:06:34 -0500
Received: from [172.20.10.5] ([188.188.37.53])
by laurent.telenet-ops.be with bizsmtp
id ry6Y2600Y18o4tG01y6YUa; Sun, 06 Feb 2022 23:06:32 +0100
Message-ID: <c89c9ce54ca883af6355964ebcf5807009db10c0.camel@HIDDEN>
From: Maxime Devos <maximedevos@HIDDEN>
Date: Sun, 06 Feb 2022 23:06:32 +0100
In-Reply-To: <20220206213344.3117861-1-contact@HIDDEN>
References: <20220206213344.3117861-1-contact@HIDDEN>
Content-Type: multipart/signed; micalg="pgp-sha512";
protocol="application/pgp-signature"; boundary="=-9sHQ68BcDSBuhocdHLfC"
User-Agent: Evolution 3.38.3-1
MIME-Version: 1.0
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r22;
t=1644185193; bh=Vt44qUZ2xNdIe1lt+yuR8OlqED6ulUWF5kC9MpElzPY=;
h=Subject:From:To:Date:In-Reply-To:References;
b=EHldMSnzmy3jl1XO2d57x/g06c7x4hR+y+x6t2NgsMN5t2Aq9/flfcM5uFlP8YM/z
jCjxE7oNjQ89uEFHm+b08tqsaaWZRZApp7ljwv1AsofEGz9BWiVynTYBlj82aVLEAH
GBRkvFHNjwcF/j5G0vq+A2HkR2maXJTT5FCJM5tSJT1KJ0/3/iZ9wjoaSxewRndowm
cY++hVnqaP/JG1rDWrdQUHb0gUDQpDLTqBwiqCSq00id0bKuZxZGDtPU7WqZj9Z5Ne
2R/rPPoIPd1dGT2Eow/ohVl3/3TCtg64IMUKepQ23jXWbRCopFKudGL4WODmZXsfeX
t3Fffu3cE9uEA==
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
--=-9sHQ68BcDSBuhocdHLfC
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Pierre-Henry Fr=C3=B6hring schreef op zo 06-02-2022 om 22:33 [+0100]:
> +guix environment guix --pure --ad-hoc fd
> +./bootstrap
> +guix_db_prefix=3D$(fd -p '.*/guix/db$' /)
> +guix_db_prefix=3D$@{guix_db_prefix%/guix/db@}
What's this 'fd' and guix_db_prefix about?
If this is necessary, shouldn't it be documented in the main manual.
> +./configure --localstatedir=3D"$guix_db_prefix"
> +exit
> +make authenticate
This "make authenticate" gives a false sense of security -- the MITM
attacker could have changed the Makefile.am to let the 'authenticate'
target be a no-op. Likewise, authentication must happen before
./bootstrap and ./configure otherwise it's too late.
Also, didn't this authentication already happen in
> +@node Authentication
> +@section Authentication
> +
> +@example
> +git fetch origin keyring:keyring
> +guix git authenticate 9edb3f66fd807b096b48283debdcddccfea34bad \
> + "BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA"
Greetings,
Maxime.
--=-9sHQ68BcDSBuhocdHLfC
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: This is a digitally signed message part
Content-Transfer-Encoding: 7bit
-----BEGIN PGP SIGNATURE-----
iI0EABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYgBGaBccbWF4aW1lZGV2
b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7gPdAPwNwtKDmYn9Gc1Xyz3Xoo2A/cga
BmvyFfWf7MKP017c2AEAn2+HrM6vCNl7nPXJnnBs0bsneSBnDMlWTtbg4sAvXAw=
=DQhP
-----END PGP SIGNATURE-----
--=-9sHQ68BcDSBuhocdHLfC--
X-Loop: help-debbugs@HIDDEN
Subject: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git.
Resent-From: Maxime Devos <maximedevos@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Sun, 06 Feb 2022 22:08:02 +0000
Resent-Message-ID: <handler.53827.B53827.164418526226872 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>, 53827 <at> debbugs.gnu.org
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.164418526226872
(code B ref 53827); Sun, 06 Feb 2022 22:08:02 +0000
Received: (at 53827) by debbugs.gnu.org; 6 Feb 2022 22:07:42 +0000
Received: from localhost ([127.0.0.1]:40034 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nGph8-0006zM-42
for submit <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:07:42 -0500
Received: from albert.telenet-ops.be ([195.130.137.90]:43036)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <maximedevos@HIDDEN>) id 1nGph6-0006zD-Gw
for 53827 <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:07:41 -0500
Received: from [172.20.10.5] ([188.188.37.53])
by albert.telenet-ops.be with bizsmtp
id ry7f2600718o4tG06y7fNv; Sun, 06 Feb 2022 23:07:39 +0100
Message-ID: <8ed430e5525be810207a5cd307a6e65b14676a3d.camel@HIDDEN>
From: Maxime Devos <maximedevos@HIDDEN>
Date: Sun, 06 Feb 2022 23:07:38 +0100
In-Reply-To: <20220206213344.3117861-1-contact@HIDDEN>
References: <20220206213344.3117861-1-contact@HIDDEN>
Content-Type: multipart/signed; micalg="pgp-sha512";
protocol="application/pgp-signature"; boundary="=-Tt5wEL2UDFPKlG61aw+K"
User-Agent: Evolution 3.38.3-1
MIME-Version: 1.0
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r22;
t=1644185259; bh=UBd/0TeDD8H5nneeoF0/jEzpYKvrNneepXd+qteQgGc=;
h=Subject:From:To:Date:In-Reply-To:References;
b=LxRjUX+9VIKkJr42t+j36HCDyN/n7ABQG3pvrmkvtuoVPZGoZunhWXndYAa3t1mp+
WCmzjy9LGOFUlbDV+WDgofJjOcYeFAoN4b0+cXlijoLFKrkxngCHpc1snaDjO1utPj
jtOxIS+FDA3iUR7LNoQvlvu152Pc71meQfOzm5+n5TTZRdBCZfJ4dVMqw0RGRG4L5p
Kcjq4mwTQ4ZSWl9fNLPo4uUiWCfr5StcxGbV7UQK09Q4Gp5IIzPu+tqflBbfnNEC17
PXMHEP7Z52WkaJh5Ml4uUUcDPNDK7fRMOebD0HOrSUhnT/7COsQny+P303H1zN4saa
/Fx5e+TLo8naA==
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
--=-Tt5wEL2UDFPKlG61aw+K
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Pierre-Henry Fr=C3=B6hring schreef op zo 06-02-2022 om 22:33 [+0100]:
> +cd ~/src
That directory does not exist on my machine, it needs to be created
first ('mkdir').
> +git clone https://git.savannah.gnu.org/git/guix.git
Before we can "git clone", git needs to be installed ("guix install
git", or "guix shell git").
Greetings,
Maxime.
--=-Tt5wEL2UDFPKlG61aw+K
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: This is a digitally signed message part
Content-Transfer-Encoding: 7bit
-----BEGIN PGP SIGNATURE-----
iI0EABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYgBGqxccbWF4aW1lZGV2
b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7s28AP9SSiUOP/6gb5pg71djnJvU09HE
+feBh2bzQPo6UXSDBAEAyeVUts+fNqmcqfENs8gCi+NA2lxYkQYG6M3ZLhnFxA4=
=3tYe
-----END PGP SIGNATURE-----
--=-Tt5wEL2UDFPKlG61aw+K--
X-Loop: help-debbugs@HIDDEN
Subject: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git.
Resent-From: Maxime Devos <maximedevos@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Sun, 06 Feb 2022 22:10:01 +0000
Resent-Message-ID: <handler.53827.B53827.164418536627083 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>, 53827 <at> debbugs.gnu.org
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.164418536627083
(code B ref 53827); Sun, 06 Feb 2022 22:10:01 +0000
Received: (at 53827) by debbugs.gnu.org; 6 Feb 2022 22:09:26 +0000
Received: from localhost ([127.0.0.1]:40046 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nGpio-00072l-KW
for submit <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:09:26 -0500
Received: from laurent.telenet-ops.be ([195.130.137.89]:44106)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <maximedevos@HIDDEN>) id 1nGpim-00072d-UX
for 53827 <at> debbugs.gnu.org; Sun, 06 Feb 2022 17:09:25 -0500
Received: from [172.20.10.5] ([188.188.37.53])
by laurent.telenet-ops.be with bizsmtp
id ry9P2600L18o4tG01y9QlD; Sun, 06 Feb 2022 23:09:24 +0100
Message-ID: <3a55d575fdd527952e57ab346a019196f17d3aa3.camel@HIDDEN>
From: Maxime Devos <maximedevos@HIDDEN>
Date: Sun, 06 Feb 2022 23:09:23 +0100
In-Reply-To: <20220206213344.3117861-1-contact@HIDDEN>
References: <20220206213344.3117861-1-contact@HIDDEN>
Content-Type: multipart/signed; micalg="pgp-sha512";
protocol="application/pgp-signature"; boundary="=-OFimo3GjFfGVB82lovUU"
User-Agent: Evolution 3.38.3-1
MIME-Version: 1.0
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=telenet.be; s=r22;
t=1644185364; bh=eRSF/i0+tLzNsdf6m+HT8sWL+R4Ff6hsAbfzIZm+dl8=;
h=Subject:From:To:Date:In-Reply-To:References;
b=cPk56X73vNSolWBWiWdm8KwF2mcATGxNMGYW2GgZbc/xcoEvflWBUjoX7Kc2UvH/f
XlNwyF2Y62+Szjk0ged/MSIektmNwwEyP5c0gx/OghoZA3DIsx5nQXZe3yV5EdGiCL
A/jDbxHsgW2w6nMgOZjIGYlb0pcwlvjHz+RP9I5YDZxfHTv06QS2t+czb3IWgGGQQV
MHKHa5HPV5qUYfwx9RmIENSCH5uky4QN+sxtMeo6R+y7/Ve6awWoQrCsnSVj+LAjn2
8iZ9sqaVPZfNZlZl3laF5izKt9aUSUMDmpQBPGyYABuZ7YUA39lqu75gnZkM2L4sds
vgj/GXWqDP74w==
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
--=-OFimo3GjFfGVB82lovUU
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Pierre-Henry Fr=C3=B6hring schreef op zo 06-02-2022 om 22:33 [+0100]:
> ---
> =C2=A0doc/guix-cookbook.texi | 68 +++++++++++++++++++++++++++++++++++++++=
+++
> =C2=A01 file changed, 68 insertions(+)
Commit message is missing.
Greetings,
Maxime
--=-OFimo3GjFfGVB82lovUU
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: This is a digitally signed message part
Content-Transfer-Encoding: 7bit
-----BEGIN PGP SIGNATURE-----
iI0EABYKADUWIQTB8z7iDFKP233XAR9J4+4iGRcl7gUCYgBHExccbWF4aW1lZGV2
b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7go4AP9Fe9g8eM1q4MJo8Kt/JziOuWOF
w/F8+cVA7iBLkv4wzgEA0YxsCnFtm8CsOLkdCeJmLL5RkG5fQiUDCaAMPpo9/Qk=
=TEhW
-----END PGP SIGNATURE-----
--=-OFimo3GjFfGVB82lovUU--
X-Loop: help-debbugs@HIDDEN
Subject: [bug#53827] [PATCH] Add a TLDR entry for building Guix from Git.
References: <20220206213344.3117861-1-contact@HIDDEN>
In-Reply-To: <20220206213344.3117861-1-contact@HIDDEN>
Resent-From: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Sun, 06 Feb 2022 23:09:01 +0000
Resent-Message-ID: <handler.53827.B53827.16441888949533 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: 53827 <at> debbugs.gnu.org
Cc: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>
Received: via spool by 53827-submit <at> 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 <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nGqdi-0002Tg-30
for submit <at> 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 <contact@HIDDEN>) id 1nGqdR-0002Sc-V2
for 53827 <at> debbugs.gnu.org; Sun, 06 Feb 2022 18:08:12 -0500
Received: (Authenticated sender: contact@HIDDEN)
by relay12.mail.gandi.net (Postfix) with ESMTPSA id 4D109200004;
Sun, 6 Feb 2022 23:07:51 +0000 (UTC)
From: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>
Date: Mon, 7 Feb 2022 00:03:23 +0100
Message-Id: <20220206230321.3142016-1-contact@HIDDEN>
X-Mailer: git-send-email 2.34.0
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Spam-Score: -0.0 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
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(+)
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
--
2.34.0
X-Loop: help-debbugs@HIDDEN
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?= <contact@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Sun, 06 Feb 2022 23:11:02 +0000
Resent-Message-ID: <handler.53827.B53827.16441890319770 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Maxime Devos <maximedevos@HIDDEN>, 53827 <at> debbugs.gnu.org
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.16441890319770
(code B ref 53827); Sun, 06 Feb 2022 23:11:02 +0000
Received: (at 53827) by debbugs.gnu.org; 6 Feb 2022 23:10:31 +0000
Received: from localhost ([127.0.0.1]:40203 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nGqfv-0002XV-Al
for submit <at> debbugs.gnu.org; Sun, 06 Feb 2022 18:10:31 -0500
Received: from relay9-d.mail.gandi.net ([217.70.183.199]:53027)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <contact@HIDDEN>) id 1nGqft-0002XH-3T
for 53827 <at> debbugs.gnu.org; Sun, 06 Feb 2022 18:10:29 -0500
Received: (Authenticated sender: contact@HIDDEN)
by mail.gandi.net (Postfix) with ESMTPSA id 38FE3FF802;
Sun, 6 Feb 2022 23:10:22 +0000 (UTC)
Message-ID: <f5576c4687658f3b82c9dcd0340b6a275b35eef2.camel@HIDDEN>
From: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>
Date: Mon, 07 Feb 2022 00:10:21 +0100
In-Reply-To: <3a55d575fdd527952e57ab346a019196f17d3aa3.camel@HIDDEN>
References: <20220206213344.3117861-1-contact@HIDDEN>
<3a55d575fdd527952e57ab346a019196f17d3aa3.camel@HIDDEN>
Content-Type: text/plain; charset="UTF-8"
User-Agent: Evolution 3.38.3-1
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
Thank you for your comments.
An updated patch is on its way.
On Sun, 2022-02-06 at 23:09 +0100, Maxime Devos wrote:
> Pierre-Henry Fröhring schreef op zo 06-02-2022 om 22:33 [+0100]:
> > ---
> > doc/guix-cookbook.texi | 68
> > ++++++++++++++++++++++++++++++++++++++++++
> > 1 file changed, 68 insertions(+)
>
> Commit message is missing.
>
> Greetings,
> Maxime
X-Loop: help-debbugs@HIDDEN
Subject: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git.
Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= <ludo@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Tue, 15 Feb 2022 09:21:01 +0000
Resent-Message-ID: <handler.53827.B53827.16449168518892 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Maxime Devos <maximedevos@HIDDEN>
Cc: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>, 53827 <at> debbugs.gnu.org
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.16449168518892
(code B ref 53827); Tue, 15 Feb 2022 09:21:01 +0000
Received: (at 53827) by debbugs.gnu.org; 15 Feb 2022 09:20:51 +0000
Received: from localhost ([127.0.0.1]:43502 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nJu0x-0002JM-E5
for submit <at> debbugs.gnu.org; Tue, 15 Feb 2022 04:20:51 -0500
Received: from hera.aquilenet.fr ([185.233.100.1]:40374)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <ludo@HIDDEN>) id 1nJu0v-0002J9-RA
for 53827 <at> debbugs.gnu.org; Tue, 15 Feb 2022 04:20:50 -0500
Received: from localhost (localhost [127.0.0.1])
by hera.aquilenet.fr (Postfix) with ESMTP id BC8C91CA;
Tue, 15 Feb 2022 10:20:43 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at aquilenet.fr
Received: from hera.aquilenet.fr ([127.0.0.1])
by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024)
with ESMTP id KLzd_qJgGRbW; Tue, 15 Feb 2022 10:20:42 +0100 (CET)
Received: from ribbon (unknown [IPv6:2001:660:6102:320:e120:2c8f:8909:cdfe])
by hera.aquilenet.fr (Postfix) with ESMTPSA id 33FF0838;
Tue, 15 Feb 2022 10:20:42 +0100 (CET)
From: Ludovic =?UTF-8?Q?Court=C3=A8s?= <ludo@HIDDEN>
References: <20220206213344.3117861-1-contact@HIDDEN>
<2c51e2236116c55e112199a2dbfb143361e88ae8.camel@HIDDEN>
Date: Tue, 15 Feb 2022 10:20:41 +0100
In-Reply-To: <2c51e2236116c55e112199a2dbfb143361e88ae8.camel@HIDDEN>
(Maxime Devos's message of "Sun, 06 Feb 2022 23:02:25 +0100")
Message-ID: <8735kkqydy.fsf_-_@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spamd-Bar: /
Authentication-Results: hera.aquilenet.fr;
none
X-Rspamd-Server: hera
X-Rspamd-Queue-Id: BC8C91CA
X-Spamd-Result: default: False [-0.10 / 15.00]; ARC_NA(0.00)[];
RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_HAS_DN(0.00)[];
RCPT_COUNT_THREE(0.00)[3]; TO_DN_SOME(0.00)[];
TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain];
FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+];
RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[];
MID_RHS_MATCH_FROM(0.00)[]
X-Spam-Score: 1.0 (+)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.0 (/)
Hi,
Maxime Devos <maximedevos@HIDDEN> skribis:
> Pierre-Henry Fr=C3=B6hring schreef op zo 06-02-2022 om 22:33 [+0100]:
>> +@node Building from Git
>> +@chapter Building from Git
>> +
>> +Build Guix from Git and start hacking.
>> +
>> +@node Context
>> +@section Context
>
> This is all explained in the main manual in more detail, can a cross-
> reference to =E2=80=98(guix)Building from Git=E2=80=99 be added?
Yes, I wonder: what do you think Pierre-Henry is wrong with the
same-named section of the manual?
https://guix.gnu.org/manual/devel/en/html_node/Building-from-Git.html
It is more verbose, but the important commands are in @example boxes,
which should allow the reader to skip straight to the main parts.
WDYT?
Ludo=E2=80=99.
X-Loop: help-debbugs@HIDDEN
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?= <contact@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Tue, 15 Feb 2022 10:11:01 +0000
Resent-Message-ID: <handler.53827.B53827.164491983522590 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Ludovic =?UTF-8?Q?Court=C3=A8s?= <ludo@HIDDEN>, Maxime Devos <maximedevos@HIDDEN>
Cc: 53827 <at> debbugs.gnu.org
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.164491983522590
(code B ref 53827); Tue, 15 Feb 2022 10:11:01 +0000
Received: (at 53827) by debbugs.gnu.org; 15 Feb 2022 10:10:35 +0000
Received: from localhost ([127.0.0.1]:43572 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nJun5-0005sH-Bg
for submit <at> debbugs.gnu.org; Tue, 15 Feb 2022 05:10:35 -0500
Received: from relay5-d.mail.gandi.net ([217.70.183.197]:37415)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <contact@HIDDEN>) id 1nJun3-0005s0-94
for 53827 <at> debbugs.gnu.org; Tue, 15 Feb 2022 05:10:34 -0500
Received: (Authenticated sender: contact@HIDDEN)
by mail.gandi.net (Postfix) with ESMTPSA id 9196A1C000D;
Tue, 15 Feb 2022 10:10:26 +0000 (UTC)
Message-ID: <089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@HIDDEN>
From: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>
Date: Tue, 15 Feb 2022 11:10:24 +0100
In-Reply-To: <8735kkqydy.fsf_-_@HIDDEN>
References: <20220206213344.3117861-1-contact@HIDDEN>
<2c51e2236116c55e112199a2dbfb143361e88ae8.camel@HIDDEN>
<8735kkqydy.fsf_-_@HIDDEN>
Content-Type: text/plain; charset="UTF-8"
User-Agent: Evolution 3.38.3-1
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
Hello Ludovic,
I try to make Guix our default package manager. It's really wonderful
so far. To that end, I need TLDRs so that less experienced
developpers can get going /fast/. Deeper understanding will come in
time.
I also need to convince that Guix is /easy/ to third parties. I need
to /show/ that /installing/, /configuring/ and /using/ Guix is fast
and efficient. I found out that TLDRs are great tools for that.
I need to have small TLDRs so that when things go wrong, it's easy to
know where and fix either the TLDR or the manual steps. Also,
sometimes, things go wrong and are not documented. /E.g./ setting
~LC_ALL=C.UTF-8~ will make Guix complain even after installing ~guix
install glibc-utf8-locales~. I can factor this knowledge inside these
TLDR fast.
Now, if I compare the official documentation:
https://guix.gnu.org/manual/devel/en/html_node/Building-from-Git.html
with the TLDR version of it:
https://transient.blog/1/tutoriel-guix-devel/ea10580e-9750-463a-aff4-9a3e90809ad4/54fcc4f606
Then, even after taking into account the great work accomplished in
the documentation, I find the TLDR version more convincing.
Pierre-Henry
On Tue, 2022-02-15 at 10:20 +0100, Ludovic Courtès wrote:
> Hi,
>
> Maxime Devos <maximedevos@HIDDEN> skribis:
>
> > Pierre-Henry Fröhring schreef op zo 06-02-2022 om 22:33 [+0100]:
> > > +@node Building from Git
> > > +@chapter Building from Git
> > > +
> > > +Build Guix from Git and start hacking.
> > > +
> > > +@node Context
> > > +@section Context
> >
> > This is all explained in the main manual in more detail, can a
> > cross-
> > reference to ‘(guix)Building from Git’ be added?
>
> Yes, I wonder: what do you think Pierre-Henry is wrong with the
> same-named section of the manual?
>
>
> https://guix.gnu.org/manual/devel/en/html_node/Building-from-Git.html
>
> It is more verbose, but the important commands are in @example boxes,
> which should allow the reader to skip straight to the main parts.
>
> WDYT?
>
> Ludo’.
X-Loop: help-debbugs@HIDDEN
Subject: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git.
Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= <ludo@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Wed, 16 Feb 2022 13:37:01 +0000
Resent-Message-ID: <handler.53827.B53827.164501857130541 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>
Cc: 53827 <at> debbugs.gnu.org, Maxime Devos <maximedevos@HIDDEN>
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.164501857130541
(code B ref 53827); Wed, 16 Feb 2022 13:37:01 +0000
Received: (at 53827) by debbugs.gnu.org; 16 Feb 2022 13:36:11 +0000
Received: from localhost ([127.0.0.1]:47770 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nKKTb-0007wX-FE
for submit <at> debbugs.gnu.org; Wed, 16 Feb 2022 08:36:11 -0500
Received: from hera.aquilenet.fr ([185.233.100.1]:55268)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <ludo@HIDDEN>) id 1nKKTZ-0007wI-5M
for 53827 <at> debbugs.gnu.org; Wed, 16 Feb 2022 08:36:10 -0500
Received: from localhost (localhost [127.0.0.1])
by hera.aquilenet.fr (Postfix) with ESMTP id 315E2B62;
Wed, 16 Feb 2022 14:36:02 +0100 (CET)
X-Virus-Scanned: Debian amavisd-new at aquilenet.fr
Received: from hera.aquilenet.fr ([127.0.0.1])
by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024)
with ESMTP id VLakckxkwy8y; Wed, 16 Feb 2022 14:36:01 +0100 (CET)
Received: from ribbon (91-160-117-201.subs.proxad.net [91.160.117.201])
by hera.aquilenet.fr (Postfix) with ESMTPSA id 0F86B388;
Wed, 16 Feb 2022 14:36:01 +0100 (CET)
From: Ludovic =?UTF-8?Q?Court=C3=A8s?= <ludo@HIDDEN>
References: <20220206213344.3117861-1-contact@HIDDEN>
<2c51e2236116c55e112199a2dbfb143361e88ae8.camel@HIDDEN>
<8735kkqydy.fsf_-_@HIDDEN>
<089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@HIDDEN>
Date: Wed, 16 Feb 2022 14:36:00 +0100
In-Reply-To: <089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@HIDDEN>
("Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?="'s message of "Tue, 15 Feb 2022
11:10:24 +0100")
Message-ID: <877d9vx7b3.fsf_-_@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spamd-Bar: /
Authentication-Results: hera.aquilenet.fr;
none
X-Rspamd-Server: hera
X-Rspamd-Queue-Id: 315E2B62
X-Spamd-Result: default: False [-0.10 / 15.00]; ARC_NA(0.00)[];
RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_HAS_DN(0.00)[];
RCPT_COUNT_THREE(0.00)[3]; TO_DN_SOME(0.00)[];
TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain];
FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+];
RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[];
MID_RHS_MATCH_FROM(0.00)[]
X-Spam-Score: 1.0 (+)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.0 (/)
Hi,
Pierre-Henry Fr=C3=B6hring <contact@HIDDEN> skribis:
> I try to make Guix our default package manager. It's really wonderful
> so far. To that end, I need TLDRs so that less experienced
> developpers can get going /fast/. Deeper understanding will come in
> time.
>
> I also need to convince that Guix is /easy/ to third parties. I need
> to /show/ that /installing/, /configuring/ and /using/ Guix is fast
> and efficient. I found out that TLDRs are great tools for that.
>
> I need to have small TLDRs so that when things go wrong, it's easy to
> know where and fix either the TLDR or the manual steps. Also,
> sometimes, things go wrong and are not documented. /E.g./ setting
> ~LC_ALL=3DC.UTF-8~ will make Guix complain even after installing ~guix
> install glibc-utf8-locales~. I can factor this knowledge inside these
> TLDR fast.
No argument here, I very much understand why as a user or potential
contributor one would want to-the-point documentation as a first step.
I also want to be able to understand what I=E2=80=99m doing though=E2=80=94=
maybe not at
first, but soon enough. That=E2=80=99s why I don=E2=80=99t feel comfortabl=
e giving a
raw list of commands without explanations.
But maybe we can have both, with cross references.
Thoughts?
Ludo=E2=80=99.
X-Loop: help-debbugs@HIDDEN
Subject: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git.
Resent-From: zimoun <zimon.toutoune@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: guix-patches@HIDDEN
Resent-Date: Wed, 16 Feb 2022 14:37:02 +0000
Resent-Message-ID: <handler.53827.B53827.16450221874002 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 53827
X-GNU-PR-Package: guix-patches
X-GNU-PR-Keywords: patch
To: Ludovic =?UTF-8?Q?Court=C3=A8s?= <ludo@HIDDEN>
Cc: Pierre-Henry =?UTF-8?Q?Fr=C3=B6hring?= <contact@HIDDEN>, 53827 <at> debbugs.gnu.org, Maxime Devos <maximedevos@HIDDEN>
Received: via spool by 53827-submit <at> debbugs.gnu.org id=B53827.16450221874002
(code B ref 53827); Wed, 16 Feb 2022 14:37:02 +0000
Received: (at 53827) by debbugs.gnu.org; 16 Feb 2022 14:36:27 +0000
Received: from localhost ([127.0.0.1]:47819 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1nKLPv-00012T-3Q
for submit <at> debbugs.gnu.org; Wed, 16 Feb 2022 09:36:27 -0500
Received: from mail-il1-f172.google.com ([209.85.166.172]:44851)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <zimon.toutoune@HIDDEN>) id 1nKLPp-00012B-Va
for 53827 <at> debbugs.gnu.org; Wed, 16 Feb 2022 09:36:25 -0500
Received: by mail-il1-f172.google.com with SMTP id k18so1535288ils.11
for <53827 <at> debbugs.gnu.org>; Wed, 16 Feb 2022 06:36:21 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;
h=mime-version:references:in-reply-to:from:date:message-id:subject:to
:cc:content-transfer-encoding;
bh=bfaqGkUg5Ur4LhWscOLt0pkLv1p5sF6S1nLbI/0Hh+8=;
b=k3G/ikKIrxtsrh+7g4r1QFVtrlrD6QrKe/rR/NUC2yYFL0wqTRI2vZcK+zkFPIbUvl
82MlBbUWGghkAV5dlQNiCyPFbGS2ObkV7CLd5ilemhxwmSGaFR8rJNH0RC8EqyIW6WqR
YCwcw4OuQJ3advCTIDetwAEV++YvyEa6xkynD5rVha29bWpAsqlWqNjGHpa83/xzAhpR
+WvUOGACoJsbgyHS4GN7FHepmHbpiAgyECU48kF3f+7jsxFu7CR4qO4OzuFFI+dmGcr0
kv7ODj6tQeQg+r95o6fRiufLQEdO2mmLBMojHAhT63YIciY9UgP++0/tqNrGCySUTssd
Tclw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20210112;
h=x-gm-message-state:mime-version:references:in-reply-to:from:date
:message-id:subject:to:cc:content-transfer-encoding;
bh=bfaqGkUg5Ur4LhWscOLt0pkLv1p5sF6S1nLbI/0Hh+8=;
b=77wJOnV5KnD7YIs1mDxX/QcqiOSdBWRZmS1siCrqOCxR2drlhYbOJBWkbyjLOFhD7C
s9UC9DVAUo6D/CnsADE5QKv/fj9n08Wv0gxDIsvTouKJVHpSBElXTakPKTfef9R5H/QX
e+4bwv0tHfehEP9Zv43ko3ovgsj7idXu9U1ruNYypadKD0nXIbt0puC1iwIJeY+r93oZ
wfP295QyhHbw7tO5IlUs6V3mEpNEE1uggw0jKy5jG0WTbt8PF39E1v6XJ8BbkAfISwF6
MAuzBmUPJ00sa7cVwNhSBlAkybHmuUa2+idk5AYsN9o1mk5+m+ZfShQaRDgxZzoVSf11
Ebvg==
X-Gm-Message-State: AOAM5321RtlsPCFBl0ZwWU/CeACNT2bKcDxozbh91j0APkSKlGXWCcRQ
kmlVFhroORJnkGnvLLfccgVYuyKFO0WI9mWYNHo=
X-Google-Smtp-Source: ABdhPJxAqPDnk394mIBYz8B27dgMFnYIBYQOutAydedk2IvniGi50yGDAGjYlWPfrYPFo27+qWl821dr58xKwBlxPUE=
X-Received: by 2002:a05:6e02:1c84:b0:2be:4170:84c5 with SMTP id
w4-20020a056e021c8400b002be417084c5mr1834318ill.202.1645022176192; Wed, 16
Feb 2022 06:36:16 -0800 (PST)
MIME-Version: 1.0
References: <20220206213344.3117861-1-contact@HIDDEN>
<2c51e2236116c55e112199a2dbfb143361e88ae8.camel@HIDDEN>
<8735kkqydy.fsf_-_@HIDDEN>
<089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@HIDDEN>
<877d9vx7b3.fsf_-_@HIDDEN>
In-Reply-To: <877d9vx7b3.fsf_-_@HIDDEN>
From: zimoun <zimon.toutoune@HIDDEN>
Date: Wed, 16 Feb 2022 15:36:04 +0100
Message-ID: <CAJ3okZ1_4oEvfz5CFrruHPT9ChZjnHq=kjoiwVQLbcv5Hz0Btg@HIDDEN>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.0 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)
Hi,
On Wed, 16 Feb 2022 at 14:39, Ludovic Court=C3=A8s <ludo@HIDDEN> wrote:
>
> Hi,
>
> Pierre-Henry Fr=C3=B6hring <contact@HIDDEN> skribis:
>
> > I try to make Guix our default package manager. It's really wonderful
> > so far. To that end, I need TLDRs so that less experienced
> > developpers can get going /fast/. Deeper understanding will come in
> > time.
> >
> > I also need to convince that Guix is /easy/ to third parties. I need
> > to /show/ that /installing/, /configuring/ and /using/ Guix is fast
> > and efficient. I found out that TLDRs are great tools for that.
> >
> > I need to have small TLDRs so that when things go wrong, it's easy to
> > know where and fix either the TLDR or the manual steps. Also,
> > sometimes, things go wrong and are not documented. /E.g./ setting
> > ~LC_ALL=3DC.UTF-8~ will make Guix complain even after installing ~guix
> > install glibc-utf8-locales~. I can factor this knowledge inside these
> > TLDR fast.
>
> No argument here, I very much understand why as a user or potential
> contributor one would want to-the-point documentation as a first step.
>
> I also want to be able to understand what I=E2=80=99m doing though=E2=80=
=94maybe not at
> first, but soon enough. That=E2=80=99s why I don=E2=80=99t feel comforta=
ble giving a
> raw list of commands without explanations.
For what it is worth, I wrote a version for some users here:
<https://simon.tournier.info/posts/2021-10-12-add-guix-package.html>
The manual is good (even really good!) once I am able to explicitly
formulate what I want. That's the job of the Cookbook (or any other
materials): fill the gap, IMHO.
Cheers,
simon
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.