From unknown Wed Jun 18 23:08:21 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#53827 <53827@debbugs.gnu.org> To: bug#53827 <53827@debbugs.gnu.org> Subject: Status: [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. Reply-To: bug#53827 <53827@debbugs.gnu.org> Date: Thu, 19 Jun 2025 06:08:21 +0000 retitle 53827 [PATCH] Add a TLDR entry to the cookbook for building Guix fr= om Git. reassign 53827 guix-patches submitter 53827 Pierre-Henry Fr=C3=B6hring severity 53827 normal tag 53827 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 06 16:35:05 2022 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: =?UTF-8?q?Pierre-Henry=20Fr=C3=B6hring?= To: guix-patches@gnu.org Subject: [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. 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-Spam-Score: -1.7 (-) X-Debbugs-Envelope-To: submit Cc: =?UTF-8?q?Pierre-Henry=20Fr=C3=B6hring?= X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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 From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 06 17:02:38 2022 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 ) id 1nGpcE-0006qq-O4 for submit@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 ) id 1nGpcD-0006qj-Cf for 53827@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@telenet.be> Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. From: Maxime Devos To: Pierre-Henry =?ISO-8859-1?Q?Fr=F6hring?= , 53827@debbugs.gnu.org Date: Sun, 06 Feb 2022 23:02:25 +0100 In-Reply-To: <20220206213344.3117861-1-contact@phfrohring.com> References: <20220206213344.3117861-1-contact@phfrohring.com> 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-Debbugs-Envelope-To: 53827 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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-- From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 06 17:02:47 2022 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 ) id 1nGpcM-0006rB-U7 for submit@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 ) id 1nGpcL-0006r2-6o for 53827@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@telenet.be> Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. From: Maxime Devos To: Pierre-Henry =?ISO-8859-1?Q?Fr=F6hring?= , 53827@debbugs.gnu.org Date: Sun, 06 Feb 2022 23:02:43 +0100 In-Reply-To: <20220206213344.3117861-1-contact@phfrohring.com> References: <20220206213344.3117861-1-contact@phfrohring.com> 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-Debbugs-Envelope-To: 53827 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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-- From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 06 17:03:09 2022 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 ) id 1nGpcj-0006sG-4O for submit@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 ) id 1nGpch-0006s8-9t for 53827@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@telenet.be> Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. From: Maxime Devos To: Pierre-Henry =?ISO-8859-1?Q?Fr=F6hring?= , 53827@debbugs.gnu.org Date: Sun, 06 Feb 2022 23:03:05 +0100 In-Reply-To: <20220206213344.3117861-1-contact@phfrohring.com> References: <20220206213344.3117861-1-contact@phfrohring.com> 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-Debbugs-Envelope-To: 53827 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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-- From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 06 17:06:35 2022 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 ) id 1nGpg2-0006xe-Qe for submit@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 ) id 1nGpg2-0006xW-0Q for 53827@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: Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. From: Maxime Devos To: Pierre-Henry =?ISO-8859-1?Q?Fr=F6hring?= , 53827@debbugs.gnu.org Date: Sun, 06 Feb 2022 23:06:32 +0100 In-Reply-To: <20220206213344.3117861-1-contact@phfrohring.com> References: <20220206213344.3117861-1-contact@phfrohring.com> 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-Debbugs-Envelope-To: 53827 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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-- From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 06 17:07:42 2022 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 ) id 1nGph8-0006zM-42 for submit@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 ) id 1nGph6-0006zD-Gw for 53827@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@telenet.be> Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. From: Maxime Devos To: Pierre-Henry =?ISO-8859-1?Q?Fr=F6hring?= , 53827@debbugs.gnu.org Date: Sun, 06 Feb 2022 23:07:38 +0100 In-Reply-To: <20220206213344.3117861-1-contact@phfrohring.com> References: <20220206213344.3117861-1-contact@phfrohring.com> 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-Debbugs-Envelope-To: 53827 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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-- From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 06 17:09:26 2022 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 ) id 1nGpio-00072l-KW for submit@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 ) id 1nGpim-00072d-UX for 53827@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@telenet.be> Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. From: Maxime Devos To: Pierre-Henry =?ISO-8859-1?Q?Fr=F6hring?= , 53827@debbugs.gnu.org Date: Sun, 06 Feb 2022 23:09:23 +0100 In-Reply-To: <20220206213344.3117861-1-contact@phfrohring.com> References: <20220206213344.3117861-1-contact@phfrohring.com> 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-Debbugs-Envelope-To: 53827 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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-- From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 06 18:08:14 2022 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: =?UTF-8?q?Pierre-Henry=20Fr=C3=B6hring?= To: 53827@debbugs.gnu.org Subject: [PATCH] Add a TLDR entry for building Guix from Git. 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 Content-Transfer-Encoding: 8bit X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 53827 Cc: =?UTF-8?q?Pierre-Henry=20Fr=C3=B6hring?= X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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 From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 06 18:10:31 2022 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 ) id 1nGqfv-0002XV-Al for submit@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 ) id 1nGqft-0002XH-3T for 53827@debbugs.gnu.org; Sun, 06 Feb 2022 18:10:29 -0500 Received: (Authenticated sender: contact@phfrohring.com) by mail.gandi.net (Postfix) with ESMTPSA id 38FE3FF802; Sun, 6 Feb 2022 23:10:22 +0000 (UTC) Message-ID: Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. From: Pierre-Henry =?ISO-8859-1?Q?Fr=F6hring?= To: Maxime Devos , 53827@debbugs.gnu.org Date: Mon, 07 Feb 2022 00:10:21 +0100 In-Reply-To: <3a55d575fdd527952e57ab346a019196f17d3aa3.camel@telenet.be> References: <20220206213344.3117861-1-contact@phfrohring.com> <3a55d575fdd527952e57ab346a019196f17d3aa3.camel@telenet.be> 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-Debbugs-Envelope-To: 53827 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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 From debbugs-submit-bounces@debbugs.gnu.org Tue Feb 15 04:20:51 2022 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 ) id 1nJu0x-0002JM-E5 for submit@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 ) id 1nJu0v-0002J9-RA for 53827@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: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Maxime Devos Subject: Re: bug#53827: [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. References: <20220206213344.3117861-1-contact@phfrohring.com> <2c51e2236116c55e112199a2dbfb143361e88ae8.camel@telenet.be> Date: Tue, 15 Feb 2022 10:20:41 +0100 In-Reply-To: <2c51e2236116c55e112199a2dbfb143361e88ae8.camel@telenet.be> (Maxime Devos's message of "Sun, 06 Feb 2022 23:02:25 +0100") Message-ID: <8735kkqydy.fsf_-_@gnu.org> 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-Debbugs-Envelope-To: 53827 Cc: Pierre-Henry =?utf-8?Q?Fr=C3=B6hring?= , 53827@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) Hi, Maxime Devos 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. From debbugs-submit-bounces@debbugs.gnu.org Tue Feb 15 05:10:35 2022 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 ) id 1nJun5-0005sH-Bg for submit@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 ) id 1nJun3-0005s0-94 for 53827@debbugs.gnu.org; Tue, 15 Feb 2022 05:10:34 -0500 Received: (Authenticated sender: contact@phfrohring.com) by mail.gandi.net (Postfix) with ESMTPSA id 9196A1C000D; Tue, 15 Feb 2022 10:10:26 +0000 (UTC) Message-ID: <089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@phfrohring.com> Subject: Re: bug#53827: [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. From: Pierre-Henry =?ISO-8859-1?Q?Fr=F6hring?= To: Ludovic =?ISO-8859-1?Q?Court=E8s?= , Maxime Devos Date: Tue, 15 Feb 2022 11:10:24 +0100 In-Reply-To: <8735kkqydy.fsf_-_@gnu.org> References: <20220206213344.3117861-1-contact@phfrohring.com> <2c51e2236116c55e112199a2dbfb143361e88ae8.camel@telenet.be> <8735kkqydy.fsf_-_@gnu.org> 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-Debbugs-Envelope-To: 53827 Cc: 53827@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" 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 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’. From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 16 08:36:11 2022 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 ) id 1nKKTb-0007wX-FE for submit@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 ) id 1nKKTZ-0007wI-5M for 53827@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: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Pierre-Henry =?utf-8?Q?Fr=C3=B6hring?= Subject: Re: bug#53827: [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. References: <20220206213344.3117861-1-contact@phfrohring.com> <2c51e2236116c55e112199a2dbfb143361e88ae8.camel@telenet.be> <8735kkqydy.fsf_-_@gnu.org> <089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@phfrohring.com> Date: Wed, 16 Feb 2022 14:36:00 +0100 In-Reply-To: <089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@phfrohring.com> ("Pierre-Henry =?utf-8?Q?Fr=C3=B6hring=22's?= message of "Tue, 15 Feb 2022 11:10:24 +0100") Message-ID: <877d9vx7b3.fsf_-_@gnu.org> 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-Debbugs-Envelope-To: 53827 Cc: 53827@debbugs.gnu.org, Maxime Devos X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) Hi, Pierre-Henry Fr=C3=B6hring 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. From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 16 09:36:27 2022 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 ) id 1nKLPv-00012T-3Q for submit@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 ) id 1nKLPp-00012B-Va for 53827@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@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@phfrohring.com> <2c51e2236116c55e112199a2dbfb143361e88ae8.camel@telenet.be> <8735kkqydy.fsf_-_@gnu.org> <089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@phfrohring.com> <877d9vx7b3.fsf_-_@gnu.org> In-Reply-To: <877d9vx7b3.fsf_-_@gnu.org> From: zimoun Date: Wed, 16 Feb 2022 15:36:04 +0100 Message-ID: Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. To: =?UTF-8?Q?Ludovic_Court=C3=A8s?= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 53827 Cc: =?UTF-8?Q?Pierre=2DHenry_Fr=C3=B6hring?= , 53827@debbugs.gnu.org, Maxime Devos X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi, On Wed, 16 Feb 2022 at 14:39, Ludovic Court=C3=A8s wrote: > > Hi, > > Pierre-Henry Fr=C3=B6hring 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: 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 From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 16 10:50:37 2022 Received: (at 53827) by debbugs.gnu.org; 16 Feb 2022 15:50:37 +0000 Received: from localhost ([127.0.0.1]:49268 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nKMZg-0001gn-Nd for submit@debbugs.gnu.org; Wed, 16 Feb 2022 10:50:37 -0500 Received: from relay3-d.mail.gandi.net ([217.70.183.195]:51909) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nKMZf-0001gY-0N for 53827@debbugs.gnu.org; Wed, 16 Feb 2022 10:50:35 -0500 Received: (Authenticated sender: contact@phfrohring.com) by mail.gandi.net (Postfix) with ESMTPSA id 6BB946000A; Wed, 16 Feb 2022 15:50:27 +0000 (UTC) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable From: =?utf-8?Q?Pierre-Henry_Fr=C3=B6hring?= Mime-Version: 1.0 (1.0) Subject: Re: bug#53827: [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. Date: Wed, 16 Feb 2022 16:50:26 +0100 Message-Id: References: <877d9vx7b3.fsf_-_@gnu.org> In-Reply-To: <877d9vx7b3.fsf_-_@gnu.org> To: =?utf-8?Q?Ludovic_Court=C3=A8s?= X-Mailer: iPhone Mail (19C63) X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 53827 Cc: 53827@debbugs.gnu.org, Maxime Devos X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) Envoy=C3=A9 de mon iPhone > Le 16 f=C3=A9vr. 2022 =C3=A0 14:36, Ludovic Court=C3=A8s a =C3= =A9crit : >=20 > =EF=BB=BFHi, >=20 > Pierre-Henry Fr=C3=B6hring skribis: >=20 >> 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. >>=20 >> 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. >>=20 >> 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. >=20 > 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. >=20 > 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 comfortab= le giving a > raw list of commands without explanations. Agreed. >=20 > But maybe we can have both, with cross references. Yes! It=E2=80=99s implicit in our workflow, the documentation _is_ the refer= ence. >=20 > Thoughts? Yes. I can add cross references in the patch and in the so called transient.= blog >=20 > Ludo=E2=80=99. From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 16 11:16:36 2022 Received: (at 53827) by debbugs.gnu.org; 16 Feb 2022 16:16:36 +0000 Received: from localhost ([127.0.0.1]:49316 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nKMyq-0002OP-Hx for submit@debbugs.gnu.org; Wed, 16 Feb 2022 11:16:36 -0500 Received: from out1-smtp.messagingengine.com ([66.111.4.25]:38909) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nKMyo-0002OD-Ou for 53827@debbugs.gnu.org; Wed, 16 Feb 2022 11:16:35 -0500 Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.nyi.internal (Postfix) with ESMTP id B46F45C02E3; Wed, 16 Feb 2022 11:16:29 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute5.internal (MEProxy); Wed, 16 Feb 2022 11:16:29 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=famulari.name; h=cc:cc:content-transfer-encoding:content-type:date:date:from :from:in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:sender:subject:subject:to:to; s=mesmtp; bh=3shDOQQUY/3 emLRds08vXi4TjXKnuk1B72Uhh7FWLrI=; b=ltPiCb4PTfVFFlu8isj/SdeYIZJ cOSRY1OlIWFxZMzTFtT7WxSMhlphxkeBO2bgMTSkz8ODiOvxsZ1FU1gfA5Ta+6Rc DOz+MUQWQfC1w72ZuzvAF2jBu7lWy6flWCixckg/JFiav3WonhcrBCbfOv0dClM8 Eg60AzYhji86ylbU= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:sender:subject :subject:to:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm2; bh=3shDOQQUY/3emLRds08vXi4TjXKnuk1B72Uhh7FWL rI=; b=fUOA7ThVcL10d4OZD1nylrXcppbDFG+hNQ/c5IBhf3kJFa30OCSUUPb1y fCYIAzNTe53yXqqBwiTp6o3w7IcCQMUS5dCI31Z2sEWC/RuUtr73MZHwCq+JFJJz iCzvCBOfGK6bg4+/WF2eYX1RgPy8b8pDkv1OSGZQIuIsi5wvQa64iAlut/yC4wko UTMHAmkSLxkofWqMqQQtlG9WkKxTJJQHRt883nMpBoTwvwDlGmzNSHt3oE8DtZrx cJ/4gYdB7l/ASe+6HYjjuS1xpZWxmkjukmL+qaYVEc1RenUUz9nnMZQah8VTVY5u uTQjU5OfzazbMUAmTP72fhuiWVwRA== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvvddrjeeigdekgecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpeffhffvuffkfhggtggugfgjsehtkeertddttddunecuhfhrohhmpefnvghoucfh rghmuhhlrghrihcuoehlvghosehfrghmuhhlrghrihdrnhgrmhgvqeenucggtffrrghtth gvrhhnpeeuueegudfgvdfgveeuvdeludelfeejhfeggfejtefggeekudekhfdvfeeljeeh gfenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehlvg hosehfrghmuhhlrghrihdrnhgrmhgv X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 16 Feb 2022 11:16:29 -0500 (EST) Date: Wed, 16 Feb 2022 11:16:27 -0500 From: Leo Famulari To: Ludovic =?iso-8859-1?Q?Court=E8s?= Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. Message-ID: References: <20220206213344.3117861-1-contact@phfrohring.com> <2c51e2236116c55e112199a2dbfb143361e88ae8.camel@telenet.be> <8735kkqydy.fsf_-_@gnu.org> <089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@phfrohring.com> <877d9vx7b3.fsf_-_@gnu.org> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <877d9vx7b3.fsf_-_@gnu.org> X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 53827 Cc: Pierre-Henry =?iso-8859-1?Q?Fr=F6hring?= , 53827@debbugs.gnu.org, Maxime Devos X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) On Wed, Feb 16, 2022 at 02:36:00PM +0100, Ludovic Courtès wrote: > But maybe we can have both, with cross references. Sure, but we'll have to increase our efforts to maintain the cookbook. So far, we seem to forgot to update it to reflect changes in Guix, while we do try to keep the manual in sync with the codebase. Instead, we could put the TLDR at the beginning of the manual section Building From Git, and then we'll have less trouble remembering to update it. From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 16 15:38:03 2022 Received: (at 53827) by debbugs.gnu.org; 16 Feb 2022 20:38:03 +0000 Received: from localhost ([127.0.0.1]:49559 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nKR3r-0002mC-NE for submit@debbugs.gnu.org; Wed, 16 Feb 2022 15:38:03 -0500 Received: from relay7-d.mail.gandi.net ([217.70.183.200]:55633) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nKR3p-0002ld-U0 for 53827@debbugs.gnu.org; Wed, 16 Feb 2022 15:38:02 -0500 Received: (Authenticated sender: contact@phfrohring.com) by mail.gandi.net (Postfix) with ESMTPSA id 4B13F20004; Wed, 16 Feb 2022 20:37:53 +0000 (UTC) Message-ID: <4a7c8f65adbfb1a820775d5f34344dfea4320f4a.camel@phfrohring.com> Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. From: Pierre-Henry =?ISO-8859-1?Q?Fr=F6hring?= To: Leo Famulari , Ludovic =?ISO-8859-1?Q?Court=E8s?= Date: Wed, 16 Feb 2022 21:37:53 +0100 In-Reply-To: References: <20220206213344.3117861-1-contact@phfrohring.com> <2c51e2236116c55e112199a2dbfb143361e88ae8.camel@telenet.be> <8735kkqydy.fsf_-_@gnu.org> <089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@phfrohring.com> <877d9vx7b3.fsf_-_@gnu.org> Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.38.3-1 MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 53827 Cc: 53827@debbugs.gnu.org, Maxime Devos X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) > Sure, but we'll have to increase our efforts to maintain the > cookbook. > > So far, we seem to forgot to update it to reflect changes in Guix, > while > we do try to keep the manual in sync with the codebase. > > Instead, we could put the TLDR at the beginning of the manual section > Building From Git, and then we'll have less trouble remembering to > update it. Agreed. This would have been useful. From debbugs-submit-bounces@debbugs.gnu.org Thu Feb 17 05:38:12 2022 Received: (at 53827) by debbugs.gnu.org; 17 Feb 2022 10:38:12 +0000 Received: from localhost ([127.0.0.1]:50252 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nKeAt-0003WV-TD for submit@debbugs.gnu.org; Thu, 17 Feb 2022 05:38:12 -0500 Received: from hera.aquilenet.fr ([185.233.100.1]:56886) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nKeAs-0003WH-Ej for 53827@debbugs.gnu.org; Thu, 17 Feb 2022 05:38:10 -0500 Received: from localhost (localhost [127.0.0.1]) by hera.aquilenet.fr (Postfix) with ESMTP id E3DAE8DE; Thu, 17 Feb 2022 11:38:04 +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 8dFsctNT5QYN; Thu, 17 Feb 2022 11:38:04 +0100 (CET) Received: from ribbon (unknown [IPv6:2001:660:6102:320:e120:2c8f:8909:cdfe]) by hera.aquilenet.fr (Postfix) with ESMTPSA id BE82FA4; Thu, 17 Feb 2022 11:38:03 +0100 (CET) From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Leo Famulari Subject: Re: [bug#53827] [PATCH] Add a TLDR entry to the cookbook for building Guix from Git. References: <20220206213344.3117861-1-contact@phfrohring.com> <2c51e2236116c55e112199a2dbfb143361e88ae8.camel@telenet.be> <8735kkqydy.fsf_-_@gnu.org> <089df39f323ee4b4bb83b6b7e0cc8f262a9317e5.camel@phfrohring.com> <877d9vx7b3.fsf_-_@gnu.org> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 29 =?utf-8?Q?Pluvi=C3=B4se?= an 230 de la =?utf-8?Q?R=C3=A9volution?= X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu Date: Thu, 17 Feb 2022 11:38:03 +0100 In-Reply-To: (Leo Famulari's message of "Wed, 16 Feb 2022 11:16:27 -0500") Message-ID: <87iltdok1g.fsf@gnu.org> 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: E3DAE8DE 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)[4]; 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-Debbugs-Envelope-To: 53827 Cc: Pierre-Henry =?utf-8?Q?Fr=C3=B6hring?= , 53827@debbugs.gnu.org, Maxime Devos X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.0 (/) Leo Famulari skribis: > On Wed, Feb 16, 2022 at 02:36:00PM +0100, Ludovic Court=C3=A8s wrote: >> But maybe we can have both, with cross references. > > Sure, but we'll have to increase our efforts to maintain the cookbook. > > So far, we seem to forgot to update it to reflect changes in Guix, while > we do try to keep the manual in sync with the codebase. > > Instead, we could put the TLDR at the beginning of the manual section > Building From Git, and then we'll have less trouble remembering to > update it. Sure, why not. Thanks, Ludo=E2=80=99.