From unknown Fri Jun 20 07:08:04 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#54711 <54711@debbugs.gnu.org> To: bug#54711 <54711@debbugs.gnu.org> Subject: Status: Bad Documentation Series: 6.1 Specifying Additional Channels Reply-To: bug#54711 <54711@debbugs.gnu.org> Date: Fri, 20 Jun 2025 14:08:04 +0000 retitle 54711 Bad Documentation Series: 6.1 Specifying Additional Channels reassign 54711 guix submitter 54711 Marek Pa=C5=9Bnikowski severity 54711 normal thanks From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 12:49:49 2022 Received: (at submit) by debbugs.gnu.org; 4 Apr 2022 16:49:49 +0000 Received: from localhost ([127.0.0.1]:52823 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbPtk-0005QT-K5 for submit@debbugs.gnu.org; Mon, 04 Apr 2022 12:49:48 -0400 Received: from lists.gnu.org ([209.51.188.17]:34328) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbPSe-0004N2-82 for submit@debbugs.gnu.org; Mon, 04 Apr 2022 12:21:48 -0400 Received: from eggs.gnu.org ([209.51.188.92]:52214) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nbPSb-0007jD-PE for bug-guix@gnu.org; Mon, 04 Apr 2022 12:21:47 -0400 Received: from cloudserver3216345-3216376.home.pl ([46.242.242.150]:44526) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nbPSa-00065w-8R for bug-guix@gnu.org; Mon, 04 Apr 2022 12:21:45 -0400 Received: from localhost (127.0.0.1) (HELO sv147.home.net.pl) by /usr/run/smtp (/usr/run/postfix/private/idea_relay_lmtp) via UNIX with SMTP (IdeaSmtpServer 5.0.0) id ebbdb64c1abac349; Mon, 4 Apr 2022 18:21:40 +0200 Received: from lenovo-x200.lan (unknown [81.190.248.246]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by sv147.home.net.pl (Postfix) with ESMTPSA id DDD805725FF for ; Mon, 4 Apr 2022 18:21:39 +0200 (CEST) Message-ID: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> Subject: Bad Documentation Series: 6.1 Specifying Additional Channels From: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= To: bug-guix@gnu.org Date: Mon, 04 Apr 2022 18:21:35 +0200 Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.42.1 MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-CLIENT-IP: 81.190.248.246 X-CLIENT-HOSTNAME: 81.190.248.246 X-VADE-SPAMSTATE: clean X-VADE-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgedvvddrudejvddgleehucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecujffqoffgrffnpdggtffipffknecuuegrihhlohhuthemucduhedtnecunecujfgurhepkffuhffvffgtfggggfesthejredttderjeenucfhrhhomhepofgrrhgvkhcurfgrhjhnihhkohifshhkihcuoehmrghilhesmhgrrhgvkhhprghsnhhikhhofihskhhirdhnrghmvgeqnecuggftrfgrthhtvghrnheptdefvefgveefjeekheefkeffjedvgfduueeltefhkeffveegjefhteekjefhveeunecukfhppeekuddrudeltddrvdegkedrvdegieenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepihhnvghtpeekuddrudeltddrvdegkedrvdegiedphhgvlhhopehlvghnohhvohdqgidvtddtrdhlrghnpdhmrghilhhfrhhomhepofgrrhgvkhcupeerfgfvhfdqkeersferrfgrpeevheepleeunhhikhhofihskhhireepuceomhgrihhlsehmrghrvghkphgrshhnihhkohifshhkihdrnhgrmhgvqedpnhgspghrtghpthhtohepuddprhgtphhtthhopegsuhhgqdhguhhigiesghhnuhdrohhrgh X-DCC--Metrics: sv147.home.net.pl 1024; Body=1 Fuz1=1 Fuz2=1 Received-SPF: pass client-ip=46.242.242.150; envelope-from=mail@marekpasnikowski.name; helo=cloudserver3216345-3216376.home.pl X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, 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.3 (-) X-Debbugs-Envelope-To: submit X-Mailman-Approved-At: Mon, 04 Apr 2022 12:49:47 -0400 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.3 (--) Dear Guix Developers I love the Guix's vision of system management. Thank you for your hard work to implement it. It pains me greatly to see the documentation be completely useless. It gives descriptions of Guix programs, but almost nothing usable for configuration files. I am considering filing a bug report for each inadequate chapter. Please reply whether this is welcome. My aim is to rewrite the documentation in a way usable to someone, who has never used Guix before. I decided to prioritize channel documentation, because this is my current blocker. My goal is to keep a local mirror of the guix repository, with my personal changes and additions. Following is the list of the documentation problems. 1. (channel (introduction -)) is not mentioned at all. 2. What ==is== the channel introduction? Which commit am I supposed to use? How do I find the PGP fingerprint? 3. How do I declare a local repository? 4. How do I declare a channel within the config.scm file? Respectfully, Guix Noob Marek Pasnikowski From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 13:53:20 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 17:53:20 +0000 Received: from localhost ([127.0.0.1]:52863 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbQtE-0007yP-Kd for submit@debbugs.gnu.org; Mon, 04 Apr 2022 13:53:20 -0400 Received: from michel.telenet-ops.be ([195.130.137.88]:39882) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbQt9-0007y6-C5 for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 13:53:19 -0400 Received: from [172.20.10.5] ([188.188.236.140]) by michel.telenet-ops.be with bizsmtp id EhtC2700J32RwxY06htCHm; Mon, 04 Apr 2022 19:53:13 +0200 Message-ID: Subject: Re: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels From: Maxime Devos To: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 19:53:08 +0200 In-Reply-To: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-F0aZl/0H9YbsFC7Vx6Af" 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=1649094793; bh=I2g42EWBeGxQRmewrXNd0Sev5oe1otsPCiLi92NX0ZM=; h=Subject:From:To:Date:In-Reply-To:References; b=V1eBQzjgbCGlyErPq7ysHI05gHd0Qt33U09a0yTQ5a/p0++uSNivQuGss4sv813iJ Mf1kV/8/q8l8iG/XMnDu9EBSCEG9uA8w9Rlv7ruP4RT+AfYKolP5sLoEhfaluE4wXK NfV696aSXHQIHyLYz4wfXdUrcAW2hPjbx0wpestllmNxnOABGr2xmMCGevH6AT7Ben t93y+X+q8OZgF2RVm5cqV+ZkCXpA7EiW3UtR/X3ZT6r4OoZ6LBuY66wBsWpESESXiQ 0XHOvGgBRtf/XwY9nDfzZ/3m7lk1zRaohcoWM5XaUK57iTLtNYK/rxwHVe0pb2Gf7b eo3b7FKyfwUQw== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) --=-F0aZl/0H9YbsFC7Vx6Af Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Marek Pa=C5=9Bnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > 3. How do I declare a local repository? The same way as an external repository. Just replace the "https://..." of the repo at savannah with "file://home/user/location/of/git/repository". But yes, this could be documented ... Greetings, Maxime. --=-F0aZl/0H9YbsFC7Vx6Af 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+4iGRcl7gUCYkswhBccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7pxuAQCPTLS62oy5LBnpFtwPZSYHvf+I YV8f6kDx6Z5ETyOlPwD+OOhtI+tqRzSvasfGH1kQFk9p+FXJndEZyxtpgjldTwk= =PFtT -----END PGP SIGNATURE----- --=-F0aZl/0H9YbsFC7Vx6Af-- From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 13:55:44 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 17:55:44 +0000 Received: from localhost ([127.0.0.1]:52868 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbQvY-00084e-0b for submit@debbugs.gnu.org; Mon, 04 Apr 2022 13:55:44 -0400 Received: from michel.telenet-ops.be ([195.130.137.88]:42878) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbQvV-00084U-S0 for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 13:55:42 -0400 Received: from [172.20.10.5] ([188.188.236.140]) by michel.telenet-ops.be with bizsmtp id Ehvg2700R32RwxY06hvghP; Mon, 04 Apr 2022 19:55:41 +0200 Message-ID: <6f356f2c29491340288b447470af0035be64463e.camel@telenet.be> Subject: Re: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels From: Maxime Devos To: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 19:55:40 +0200 In-Reply-To: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-rIwgVh3KnwxVqrB3qzy5" 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=1649094941; bh=9rIDZ+dseVczyy9L039yniCYGXAn12qBe/sgUX3tDDI=; h=Subject:From:To:Date:In-Reply-To:References; b=BIA9bHmN9PuDQNiYBnEXRA3WJtJT7keiUjo/h0c+O2lXQ4aFuoXYz+6+4M5+cbpQI SMFh2D56RQemYuHImLJEb4bbLqLMbGLvCLCpIpi0sQzV60P1roCItHcWcHno7eVl/4 x/wCtzR0SqF9P0giLq7L3TeHbiN7BevGv6DYPdUeQWdlzlfMe1O8NvMaGs64IpNkjg mLyIFbKN/3aDN1wJFja3tAeT7HLxzQROuakWUDqPUr74BsQuH35pVw6bMHkJDNM0br 1e5NE8XGa/zDyqcDIGy3imwThrhm0i6PsULLrd3ShED5t2rY/H5192ktCZk/fL5+am cA72YKOnJnDGA== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) --=-rIwgVh3KnwxVqrB3qzy5 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Marek Pa=C5=9Bnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > 4. How do I declare a channel within the config.scm file? What do you mean with =E2=80=98the config.scm file=E2=80=99 here? The oper= ating system configuration file, which is conventionally named configuration.scm or config.scm but in principle can be named anything? The ~/.config/guix/current/channels.scm file? The Guix Home configuration (if any)? The manifest used for the user profile (if any, using "guix install" and friends is also an option)? Greetings, Maxime. --=-rIwgVh3KnwxVqrB3qzy5 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+4iGRcl7gUCYksxHBccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7syQAQCT3fYZiDsb77dpX58S4OzMP5Kr rDzDSSd9QP5sQpgtCQEAhwmvuy27ZnyqtQ5KrSAucy4dXQOlAM1fzB/LgDhTzgo= =aenL -----END PGP SIGNATURE----- --=-rIwgVh3KnwxVqrB3qzy5-- From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 13:58:38 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 17:58:38 +0000 Received: from localhost ([127.0.0.1]:52873 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbQyM-0008BM-Eg for submit@debbugs.gnu.org; Mon, 04 Apr 2022 13:58:38 -0400 Received: from laurent.telenet-ops.be ([195.130.137.89]:48310) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbQyL-0008BA-EC for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 13:58:38 -0400 Received: from [172.20.10.5] ([188.188.236.140]) by laurent.telenet-ops.be with bizsmtp id Ehyb2700832RwxY01hyblM; Mon, 04 Apr 2022 19:58:36 +0200 Message-ID: <30e17f9f3d997eba9acd79ea87f94c231f9a7e5a.camel@telenet.be> Subject: Re: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels From: Maxime Devos To: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 19:58:35 +0200 In-Reply-To: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-tQahf+B/K+h4pJZEybZP" 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=1649095116; bh=/z14clAzl1UGOlt9JFyjTmvIW8uITpcwonZYsjiTq08=; h=Subject:From:To:Date:In-Reply-To:References; b=issou6oA31KR8aK/0IljO5qLKeYiJrZb/uyOV8lzpDYgEwQLx2BavUwc9ztdtupTP wa2Mz4pveI0GNGvUN77pL+CrrjeX0LFFicxnMkzw4vmP46+jKd+a8N5VcZosyA4mEx gpxeMke2nZzJ79XngfmaL4SaOXdfuPoAJ2GirroEY+oQcSzlyDIQxA6f7i1VKXUFw3 hrJPsyxLek92RyPfva85bQymyHfQfkHbu1efWQ8ICim/rdzwMnGLvS1C5hHl5fDg+D zfUYnfrdy1Dt2kOl0oGuLg5YZ6gdkXcNhIqjRe8ubUj+Wq6SJiooP4G4Eat1BedcxT iPEpFOpQamhCg== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) --=-tQahf+B/K+h4pJZEybZP Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Marek Pa=C5=9Bnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > 1. (channel (introduction -)) is not mentioned at all. It isn't in (guix)Specifying Aditional Channels, because its optional (albeit nice to have for security). It is documented in the next few sections. --=-tQahf+B/K+h4pJZEybZP 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+4iGRcl7gUCYksxyxccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7ikiAQDNNJL/CeicaNo/k/uzcEetTcG1 jWRAOK3p9qIbQThjxgEA25c9FfH1cSMsCGbTvnMeZHNZM02eUgqiCQDxwJgLkQk= =GtVs -----END PGP SIGNATURE----- --=-tQahf+B/K+h4pJZEybZP-- From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 14:02:11 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 18:02:11 +0000 Received: from localhost ([127.0.0.1]:52882 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbR1n-0008LR-34 for submit@debbugs.gnu.org; Mon, 04 Apr 2022 14:02:11 -0400 Received: from laurent.telenet-ops.be ([195.130.137.89]:54200) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbR1l-0008LH-H9 for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 14:02:10 -0400 Received: from [172.20.10.5] ([188.188.236.140]) by laurent.telenet-ops.be with bizsmtp id Ei272700i32RwxY01i28KE; Mon, 04 Apr 2022 20:02:08 +0200 Message-ID: Subject: Re: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels From: Maxime Devos To: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 20:02:07 +0200 In-Reply-To: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-nPtLyB2fWW6A9Ms/+/QD" 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=1649095328; bh=vmKegLls+WweVWunkNrlLlj6m6L0E7MvcTAkveZ1ogQ=; h=Subject:From:To:Date:In-Reply-To:References; b=MOHnY4nKYMz7O6yXwbeooUZOZOVviSu8BMUG9pb734bPfmRylwEWcm+P7Sz3ePaId NysHJ/mRYhgFTusfFf32f//6QLJpx6VV0sDfugkZ1SFSMBfyt9xHqonesn+OPyfypb 8Bs5aWHpW+EK13zPjer+lHvVkSj+9Fp7f8G+x6GqqrfO2PYbvv+FA4LJQTfFmxX4f1 bdI3h8Mz2gQ+ulfzdy4E+YWP2iHksy88lT31Ci3wxWlfLcCoiDivlOzXQxD5+x/Cgb 5f7vHzg2ododLRJsFbMJ2s37BtNYVQBIe8Mns8U5w5sxJjf+HhmykZAsJ31qN/xgJv fOFERzgUqpF7A== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) --=-nPtLyB2fWW6A9Ms/+/QD Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Marek Pa=C5=9Bnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > How do I find the PGP fingerprint? (guix)Channel Authentication The specification above shows the name and URL of the channel. The call to =E2=80=98make-channel-introduction=E2=80=99 above specifies that au= thentication of this channel starts at commit =E2=80=986f0d8cc...=E2=80=99, which is sig= ned by the OpenPGP key with fingerprint =E2=80=98CABB A931...=E2=80=99. The PGP fingerprint is the PGP fingerprint that is used to sign the commit. You can find it in the PGP application you used to create your PGP key. Greetings, Maxime. --=-nPtLyB2fWW6A9Ms/+/QD 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+4iGRcl7gUCYksynxccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7uvLAP9A+aCCynixU/eeiJ55fQw93lQW HfTX1drWPE2Im/i6CwD9ERAWJZWqlU6l3Y4tFaJxLnr3BFcNn/85CKTu7XiDyww= =IfT0 -----END PGP SIGNATURE----- --=-nPtLyB2fWW6A9Ms/+/QD-- From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 14:08:51 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 18:08:51 +0000 Received: from localhost ([127.0.0.1]:52887 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbR8E-00008F-PV for submit@debbugs.gnu.org; Mon, 04 Apr 2022 14:08:50 -0400 Received: from albert.telenet-ops.be ([195.130.137.90]:54566) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbR8D-000085-9s for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 14:08:49 -0400 Received: from [172.20.10.5] ([188.188.236.140]) by albert.telenet-ops.be with bizsmtp id Ei8n2700332RwxY06i8nfD; Mon, 04 Apr 2022 20:08:48 +0200 Message-ID: <6cd9ef48a3e204b7ad7fe57f56847ee3df0d68d2.camel@telenet.be> Subject: Re: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels From: Maxime Devos To: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 20:08:46 +0200 In-Reply-To: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-JCoT6udNkA5esoxO8nNZ" 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=1649095728; bh=H1m/sCCuUQWvYMNl3s1/bhosOjD6y5dyr1jfwpX2kNI=; h=Subject:From:To:Date:In-Reply-To:References; b=alyF1xPntVwVI0MdZCr4RnEGu615+HiQXpUc+/6aqX9SuuDKeBOkd0TqWQmFgZ0Nm 5/CEw+CLrsEtHJl2NkJjabW7uVL1qhs0t4M8Ho628e4WcDmCIU0bQNEpkXJluzXH40 Wn+NapvkGQ3qi5VWKqSKsdTr+f9i1/lg/WvxK/UYdQQWiFJsdoY+k41BaRJjjX7S0z C1BHKjrvsdGvNYizewfcRlRAPVFsvdrXMNxFxBps47+aH2NaJQz237/z1juT5v2580 3pyiorht8w+85+fIms2fA7AwvkpDwKUwN0o4BiNZoavcjdw8zGZ7JNDiRZXIHtRXpa HPX3DZhDf681g== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) --=-JCoT6udNkA5esoxO8nNZ Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Marek Pa=C5=9Bnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > 2. What =3D=3Dis=3D=3D the channel introduction? =46rom (guix)Channel Authentication: As a user, you must provide a =E2=80=9Cchannel introduction=E2=80=9D in = your channels file so that Guix knows how to authenticate its first commit. A channel specification, including its introduction, looks something along these lines: (channel (name 'some-channel) (url "https://example.org/some-channel.git") (introduction (make-channel-introduction "6f0d8cc0d88abb59c324b2990bfee2876016bb86" (openpgp-fingerprint "CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5")))) It's the (make-channel-introduction [...]) thing. It's just a bunch of information that Guix can use to authenticate the first commit of the channel. Also see ... > Which commit am I supposed to use? The first commit that adds (or in your case, modifies) the .guix- authorization file. From (guix)Specifying Channel Authorizations: This authentication rule creates a chicken-and-egg issue: how do we authenticate the first commit? Related to that: how do we deal with channels whose repository history contains unsigned commits and lack =E2=80=98.guix-authorizations=E2=80=99? And how do we fork existing channe= ls? Channel introductions answer these questions by describing the first commit of a channel that should be authenticated. The first time a channel is fetched with =E2=80=98guix pull=E2=80=99 or =E2=80=98guix time-m= achine=E2=80=99, the command looks up the introductory commit and verifies that it is signed by the specified OpenPGP key. From then on, it authenticates commits according to the rule above. Authentication fails if the target commit is neither a descendant nor an ancestor of the introductory commit. Greetings, Maxime. --=-JCoT6udNkA5esoxO8nNZ 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+4iGRcl7gUCYks0LhccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7sBtAQDD4DZb11QoKxOZNCyoLLM+cRMv NhHdw8cxMPxgxCeExQEAvzElsNEsijUMMGQdgp+Km3k4e/A1eZviqEs51ui77w8= =IMip -----END PGP SIGNATURE----- --=-JCoT6udNkA5esoxO8nNZ-- From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 14:13:24 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 18:13:24 +0000 Received: from localhost ([127.0.0.1]:52892 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbRCe-0000J3-CJ for submit@debbugs.gnu.org; Mon, 04 Apr 2022 14:13:24 -0400 Received: from albert.telenet-ops.be ([195.130.137.90]:32768) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbRCc-0000It-LP for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 14:13:23 -0400 Received: from [172.20.10.5] ([188.188.236.140]) by albert.telenet-ops.be with bizsmtp id EiDM2700H32RwxY06iDMNj; Mon, 04 Apr 2022 20:13:21 +0200 Message-ID: Subject: Re: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels From: Maxime Devos To: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 20:13:20 +0200 In-Reply-To: References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-kO1hwATlPkQptPfSFf5t" 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=1649096001; bh=n5S1TMknMLMIQc9upnkmGXmn61D3cQ6oOn5O1kd5BD0=; h=Subject:From:To:Date:In-Reply-To:References; b=T5Ixl2RWCfSBi9CKyRjRf/tayiUzA5+MCS6Ljj144s04Tnk9hxxdzzSBtOmsTdTKG sS45mgMthGOSEPUIwc9XI3LDIqgJHw+rXAZjSTiPwlGwdqOp5dOaAE5O/MmmbF81OA gTrJrsTxwp9dGEQZN7U0Z76gncSVzCWDgeEzi0L1jYwHFp5FHEc6QZHsNrHTfn3j2h n8jBDHUTAltl00sC7m7jIfzRF87sQflkqYbdLI0sY4q9EKIW2g9MuNHRC96IQ/u3ct N0i5omzL8Tw0wHcn1VcDbiPUffaxHkPiupI9yJtuNWIMVp+75iHcU7GdHF/2Afc7KD ShsvQTIpDW40g== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) --=-kO1hwATlPkQptPfSFf5t Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Maxime Devos schreef op ma 04-04-2022 om 19:53 [+0200]: > Marek Pa=C5=9Bnikowski schreef op ma 04-04-2022 om 18:21 [+0200]: > > 3. How do I declare a local repository? >=20 > The same way as an external repository.=C2=A0 Just replace the > "https://..." > of the repo at savannah with > "file://home/user/location/of/git/repository".=C2=A0 But yes, this could > be > documented ... Or simpler: "/home/user/location/of/..." might work too ... --=-kO1hwATlPkQptPfSFf5t 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+4iGRcl7gUCYks1QBccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7nIWAP4gmLOGcEAz+nZeIFfFtL8uEwKx oK9S5xuGiKX88U1fEAD8DQArPaMgBOYBFdDGRV+1ba6rO69YaNT3cZQaNDpmeQY= =Nlo6 -----END PGP SIGNATURE----- --=-kO1hwATlPkQptPfSFf5t-- From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 14:53:26 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 18:53:26 +0000 Received: from localhost ([127.0.0.1]:52948 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbRpN-00026M-UT for submit@debbugs.gnu.org; Mon, 04 Apr 2022 14:53:26 -0400 Received: from cloudserver3216345-3216376.home.pl ([46.242.242.150]:57886) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbRft-0001by-8P for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 14:43:38 -0400 Received: from localhost (127.0.0.1) (HELO sv147.home.net.pl) by /usr/run/smtp (/usr/run/postfix/private/idea_relay_lmtp) via UNIX with SMTP (IdeaSmtpServer 5.0.0) id cb4ba6455f52779c; Mon, 4 Apr 2022 20:43:30 +0200 Received: from lenovo-x200.lan (unknown [81.190.248.246]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by sv147.home.net.pl (Postfix) with ESMTPSA id 2DB97577D60 for <54711@debbugs.gnu.org>; Mon, 4 Apr 2022 20:43:30 +0200 (CEST) Message-ID: <4b4fb5fcf67ee63c9899f43e9653b1cfd689dd26.camel@marekpasnikowski.name> Subject: Bad Documentation Series: 6.1 Specifying Additional Channels From: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= To: 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 20:43:25 +0200 Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.42.1 MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-CLIENT-IP: 81.190.248.246 X-CLIENT-HOSTNAME: 81.190.248.246 X-VADE-SPAMSTATE: clean X-VADE-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgedvvddrudejvddguddvfecutefuodetggdotefrodftvfcurfhrohhfihhlvgemucfjqffogffrnfdpggftiffpkfenuceurghilhhouhhtmecuudehtdenucgovfgvgihtqfhnlhihqddqteefjeefqddtgeculdehtddmnecujfgurhepkffuhffvffgtfggggfesthejredttderjeenucfhrhhomhepofgrrhgvkhcurfgrhjhnihhkohifshhkihcuoehmrghilhesmhgrrhgvkhhprghsnhhikhhofihskhhirdhnrghmvgeqnecuggftrfgrthhtvghrnhepjeffhfetieegudehueejgfelgeehhfeugedvvdevgedukeelffffteefvdetueehnecuffhomhgrihhnpehstghmrdhmhienucfkphepkedurdduledtrddvgeekrddvgeeinecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehinhgvthepkedurdduledtrddvgeekrddvgeeipdhhvghloheplhgvnhhovhhoqdigvddttddrlhgrnhdpmhgrihhlfhhrohhmpeforghrvghkucepregfvffhqdekrefsrefrrgepveehpeeluehnihhkohifshhkiherpecuoehmrghilhesmhgrrhgvkhhprghsnhhikhhofihskhhirdhnrghmvgeqpdhnsggprhgtphhtthhopedupdhrtghpthhtohepheegjeduudesuggvsggsuhhgshdrghhnuhdrohhrgh X-DCC--Metrics: sv147.home.net.pl 1024; Body=1 Fuz1=1 Fuz2=1 X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 X-Mailman-Approved-At: Mon, 04 Apr 2022 14:53:24 -0400 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 (-) Thank you for the quick reply. Those are my conclusions: 1. If I clone someone else's channel, do not bother with the introduction. 2. If I create my own channel from scratch, then I have to authorize it with my key. Thus I know the commit and the key fingerprint. 3. For a local repository, use (url "file://") or (url "/path"). Is any of these wrong? Regarding point 4.: I meant both /etc/config.scm and ~/src/guix-config/home-configuration.scm . My understanding is that it should be possible to define private (user specific) channels. I could be wrong here. I do not like the ~/.config/guix/channels.scm file, because it lives outside of the home configuration. I would rather have it generated from the home config file. From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 15:48:12 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 19:48:12 +0000 Received: from localhost ([127.0.0.1]:53098 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbSgO-0004jW-Hl for submit@debbugs.gnu.org; Mon, 04 Apr 2022 15:48:12 -0400 Received: from albert.telenet-ops.be ([195.130.137.90]:52578) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbSgM-0004jK-UT for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 15:48:11 -0400 Received: from [172.20.10.5] ([188.188.236.140]) by albert.telenet-ops.be with bizsmtp id Ejo82700632RwxY06jo8ZD; Mon, 04 Apr 2022 21:48:09 +0200 Message-ID: <2e3b78a8e94fb13bcf98ff8336a239b2e47040c3.camel@telenet.be> Subject: Re: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels From: Maxime Devos To: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 21:47:30 +0200 In-Reply-To: <4b4fb5fcf67ee63c9899f43e9653b1cfd689dd26.camel@marekpasnikowski.name> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> <4b4fb5fcf67ee63c9899f43e9653b1cfd689dd26.camel@marekpasnikowski.name> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-iaSWk52ImtUAv1PNnD/j" 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=1649101689; bh=oWdfFnze+qJGN30TYn0n/dS+PQOKTJx6fdd1gIDS0qo=; h=Subject:From:To:Date:In-Reply-To:References; b=hs2X0k//4IT8XZeRFMmFkSjXCG1eTCuePuFfirVGA64yK2Z6o+VZqEfZJBIL37Gee mjHrvPMXmQf6yOUYuK4VMV94w807ItkaL5gnq5kb7imfDjFdxc6a2bZnsMMwLqO7n0 Avs4ydiV9jvrkZzOHH+VP9B87HWKx+yizb2kt1WdAP/KCXWIgStLdapMdh2a03LSqX QBasfEtcA4c9QTR5BTorCFLqTZl9K7e9dwdjefhv9snJpgNdtgYXRkOFJWs25kqtdq 2Gh22Wuii/1t2DkR+mc6uCL7IbUbrjzOYNREYjgotWG6TzRbE/ieCo9f1GdUMX4gaP j5nebEN1bbLSg== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) --=-iaSWk52ImtUAv1PNnD/j Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Marek Pa=C5=9Bnikowski schreef op ma 04-04-2022 om 20:43 [+0200]: > Regarding point 4.: I meant both /etc/config.scm and > ~/src/guix-config/home-configuration.scm . > My understanding is that it should be possible to define private > (user specific) channels. > I could be wrong here. > I do not like the ~/.config/guix/channels.scm file, > because it lives outside of the home configuration. FWIW, you can create a symlink from ~/.config/guix/channels.scm to ~/src/guix-config/channels.scm and modify ~/src/guix- config/channels.scm. That way, the configuration files live together, which might be close enough for your purposes. > I would rather have it generated from the home config file. You can define user-specific channels, in ~/.config/guix/channels.scm. I suppose it might be technically possible to write a home configuration that puts a file in ~/.config/guix/channels.scm and/or runs the equivalent of "guix pull". However, that's too late. What you want is the home or system to be reconfigured with a certain guix+channels Y mentioned in the home or system configuration. But when you run "guix system reconfigure", that reconfiguration is performed with guix X. While after the reconfiguration, the guix is updated, the reconfiguration uses the old guix. Greetings, Maxime. --=-iaSWk52ImtUAv1PNnD/j 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+4iGRcl7gUCYktLUhccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7hLOAP9WQhzTvNV8IF2LyOQbuTKoMHo1 cQXDsjRfKlEuiyfC6AD9Gf2gp4egB54n2OZnsLhvBj8jXpGRVwRU9akR1lg+uAM= =XEBb -----END PGP SIGNATURE----- --=-iaSWk52ImtUAv1PNnD/j-- From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 15:52:00 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 19:52:00 +0000 Received: from localhost ([127.0.0.1]:53112 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbSk4-0004t0-E9 for submit@debbugs.gnu.org; Mon, 04 Apr 2022 15:52:00 -0400 Received: from albert.telenet-ops.be ([195.130.137.90]:57730) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbSk2-0004sp-Sh for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 15:51:59 -0400 Received: from [172.20.10.5] ([188.188.236.140]) by albert.telenet-ops.be with bizsmtp id Ejrx2700G32RwxY06jrx6W; Mon, 04 Apr 2022 21:51:58 +0200 Message-ID: Subject: Re: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels From: Maxime Devos To: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 21:51:57 +0200 In-Reply-To: <4b4fb5fcf67ee63c9899f43e9653b1cfd689dd26.camel@marekpasnikowski.name> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> <4b4fb5fcf67ee63c9899f43e9653b1cfd689dd26.camel@marekpasnikowski.name> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-p7+ouClE0F0EpGnAiHzu" 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=1649101918; bh=TMTbz7XAaedfZS2i6sJrpt8cWipw/hlMIAPqe5dNtSI=; h=Subject:From:To:Date:In-Reply-To:References; b=JpA/7HkqBnpr5CE422g6wTpDLzS7OZG4t9E2LKM0eI5erBErTUAaU4GueJwgaXHFR GM3Q6TFgzuP3YEq6msqZ38eafoo2kfiNCxDsPHujANNZFBqurjY0wchN9Rir4B/Ltw uQ6pZO2twwaGu+vmxyykwsuBMzYFvk9ryMJ4XcVGR201DIIligKSMyjGrwoubxX8KQ vEpGs1Ot5JRmzPmOGDOTZcedcT/yPnFtv16rpvNJneZk4+WnGxQ4dAMTifNQeTTkhI HquEarTSk9G3tDZKflhvUHfsopPzuLtRdpAfJAuJ4Q3Fqojn4mmNeOgxIdk4ykMLuU DLCuryr+2dYnA== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) --=-p7+ouClE0F0EpGnAiHzu Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Marek Pa=C5=9Bnikowski schreef op ma 04-04-2022 om 20:43 [+0200]: > 1. If I clone someone else's channel, do not bother with the > introduction. If with =E2=80=98clone=E2=80=99 you mean a =E2=80=98local git checkout+modi= fications=E2=80=99 here, and its a local clone, then probably yes --- if some attacker can replace the contents of your local repository, that's not something in Guix' threat model ... Now, if you choose to publish your modified version of someone's channel to other people, then the other people might appreciate to have introductions and .guix-authorization set-up. Greetings, Maxime. --=-p7+ouClE0F0EpGnAiHzu 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+4iGRcl7gUCYktMXRccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7sPCAQD2eW0g1kEYDxP94exRNIVuvVK3 Njdq1qzJeNIY+SjuUQD/eFDIbRpvhGWlBZ+b21tOCvR2jFGm0reOOCHe6ShBKgY= =+a2P -----END PGP SIGNATURE----- --=-p7+ouClE0F0EpGnAiHzu-- From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 15:52:47 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 19:52:47 +0000 Received: from localhost ([127.0.0.1]:53118 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbSkp-0004v8-Me for submit@debbugs.gnu.org; Mon, 04 Apr 2022 15:52:47 -0400 Received: from michel.telenet-ops.be ([195.130.137.88]:34752) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbSkn-0004uv-K9 for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 15:52:46 -0400 Received: from [172.20.10.5] ([188.188.236.140]) by michel.telenet-ops.be with bizsmtp id Ejsj2700U32RwxY06jsjrz; Mon, 04 Apr 2022 21:52:44 +0200 Message-ID: Subject: Re: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels From: Maxime Devos To: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 21:52:43 +0200 In-Reply-To: <4b4fb5fcf67ee63c9899f43e9653b1cfd689dd26.camel@marekpasnikowski.name> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> <4b4fb5fcf67ee63c9899f43e9653b1cfd689dd26.camel@marekpasnikowski.name> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-uCuVlaF+0SWKq8HLn6Ta" 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=1649101964; bh=DsOGyPYxwh/wBNcJNq6PDUE3eb8WxNsFpZjOUQWrRik=; h=Subject:From:To:Date:In-Reply-To:References; b=WhRG0ZIGRl1Oal0qylhsfL711erqs1Fjp48x0hk6uuC3uBY+oO/i8nsTJ1CBUOZI4 ejymxA1e9b6l7RuACJlvzOf+6VwsTtOACZAwNFzL2UKnyqT5yXjKArdLhnlJC7IKRq Lnrzw2u8gSFndVROW52HtMhOirsqkWeafWRbXO9SMRVThj+8axfKWP/hv9Tq2Gf3JV fiBQDW4FEriGvhF2TDuIEbEOKOz3eP5MSrZ6KQxVlNyNmFd2U6tW00xFrq+h0j3WUh 0H9uxRqgPESFmb+9bqYL6T1NR4Fj8gGs+giSpvhZKNrnhWb1ghccKv/9gV2r3bQsiv vweyXogylISAA== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) --=-uCuVlaF+0SWKq8HLn6Ta Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Marek Pa=C5=9Bnikowski schreef op ma 04-04-2022 om 20:43 [+0200]: > 3. For a local repository, use (url "file://")=C2=A0or (url "/path"). Yes, that should work. Greetings, Maxime. --=-uCuVlaF+0SWKq8HLn6Ta 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+4iGRcl7gUCYktMixccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7vG6AQCZyebHFzFIum95jvXWLHABRpiO Bb+7U4NtxHvH0Oc1mAEA6DryBojKHYBVD9ddOsax9Ageg5bXD7torW2BVUgxngo= =/Fvi -----END PGP SIGNATURE----- --=-uCuVlaF+0SWKq8HLn6Ta-- From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 04 15:54:27 2022 Received: (at 54711) by debbugs.gnu.org; 4 Apr 2022 19:54:27 +0000 Received: from localhost ([127.0.0.1]:53124 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbSmR-0004yp-03 for submit@debbugs.gnu.org; Mon, 04 Apr 2022 15:54:27 -0400 Received: from albert.telenet-ops.be ([195.130.137.90]:32914) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nbSmQ-0004yi-9Z for 54711@debbugs.gnu.org; Mon, 04 Apr 2022 15:54:26 -0400 Received: from [172.20.10.5] ([188.188.236.140]) by albert.telenet-ops.be with bizsmtp id EjuQ2700Z32RwxY06juQSK; Mon, 04 Apr 2022 21:54:25 +0200 Message-ID: Subject: Re: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels From: Maxime Devos To: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Date: Mon, 04 Apr 2022 21:54:24 +0200 In-Reply-To: <4b4fb5fcf67ee63c9899f43e9653b1cfd689dd26.camel@marekpasnikowski.name> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> <4b4fb5fcf67ee63c9899f43e9653b1cfd689dd26.camel@marekpasnikowski.name> Content-Type: multipart/signed; micalg="pgp-sha512"; protocol="application/pgp-signature"; boundary="=-rH7CwYzNyNCc81YqRLvc" 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=1649102065; bh=jXIFCE8Mz2gUtF3mpoCbEvOSHp9j0PKGyXEUTKveoYU=; h=Subject:From:To:Date:In-Reply-To:References; b=Ez8JOrH+NN5G+z9p9YdunxX4zxzbpX0hKzagIsOON9FyW/vOCozTlSL/v+VOXOH3f TKlXcHPmrXU7j6LRHgOp6YTNPRRLF7c8xIGb8RxnPRC5W8TaJoHS70x8ClT/nnJP+c JSzJt1e1UZQuNOnywyHlziN5iQkOTaKICq40kSA55teddqzWBceblalhRnrCYOwEbU fuxQXaxZ2bPJSkCXrBnW2ONEaIaUgL1mkQeRd/JwB7pC7cpe1ZNNhQ4VU5mVU/wcZw WkAFz1E9pxb2bD/hg2nRnTC/5g/dJfgYofqR1HCvSq487BUnCPfYrlCE5w0C2XNq/S kw3xnRi4A095g== X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) --=-rH7CwYzNyNCc81YqRLvc Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Marek Pa=C5=9Bnikowski schreef op ma 04-04-2022 om 20:43 [+0200]: > 2. If I create my own channel from scratch, > then I have to authorize it with my key. > Thus I know the commit and the key fingerprint. You don't have to do any authorization -- you can skip .guix- authorization and channel introductions. However, by skipping this, you lose some nice security properties, so I cannot recommend this if the channel is published over the Internet or something for other people. But if it's purely local, then skipping it is probably fine. Greetings, Maxime. --=-rH7CwYzNyNCc81YqRLvc 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+4iGRcl7gUCYktM8BccbWF4aW1lZGV2 b3NAdGVsZW5ldC5iZQAKCRBJ4+4iGRcl7hZOAP92wtxCLY5LO7V2iugmLS6TqDIY M3VDKsKwKMJKnF7IJAEAxEYFWKKJsDj8KQmUIv3nZhIh2m11dijFbWHA2HW83gw= =1qEy -----END PGP SIGNATURE----- --=-rH7CwYzNyNCc81YqRLvc-- From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 08:55:22 2022 Received: (at 54711) by debbugs.gnu.org; 10 Apr 2022 12:55:22 +0000 Received: from localhost ([127.0.0.1]:39735 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ndX6A-0008Cc-6A for submit@debbugs.gnu.org; Sun, 10 Apr 2022 08:55:22 -0400 Received: from cloudserver3216345-3216376.home.pl ([46.242.242.150]:49036) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ndX68-0008CP-Fe for 54711@debbugs.gnu.org; Sun, 10 Apr 2022 08:55:20 -0400 Received: from localhost (127.0.0.1) (HELO sv147.home.net.pl) by /usr/run/smtp (/usr/run/postfix/private/idea_relay_lmtp) via UNIX with SMTP (IdeaSmtpServer 5.0.0) id 44dcbf70cf075e63; Sun, 10 Apr 2022 14:55:13 +0200 Received: from aisaka.lan (unknown [81.190.248.246]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by sv147.home.net.pl (Postfix) with ESMTPSA id 1A2C4570B3B for <54711@debbugs.gnu.org>; Sun, 10 Apr 2022 14:55:13 +0200 (CEST) Message-ID: <155cb35e7d71ee1a73496ba47dbab6d8a121c0d6.camel@marekpasnikowski.name> Subject: Bad Documentation Series: 6.1 Specifying Additional Channels From: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= To: 54711@debbugs.gnu.org Date: Sun, 10 Apr 2022 14:55:09 +0200 Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.42.1 MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-CLIENT-IP: 81.190.248.246 X-CLIENT-HOSTNAME: 81.190.248.246 X-VADE-SPAMSTATE: clean X-VADE-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgedvvddrudekgedgheegucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecujffqoffgrffnpdggtffipffknecuuegrihhlohhuthemucduhedtnecuogfvvgigthfqnhhlhidqqdetfeejfedqtdegucdlhedtmdenucfjughrpefkuffhvffftggfggfgsehtjeertddtreejnecuhfhrohhmpeforghrvghkucfrrgjhnhhikhhofihskhhiuceomhgrihhlsehmrghrvghkphgrshhnihhkohifshhkihdrnhgrmhgvqeenucggtffrrghtthgvrhhnpedtveejgfdujeethfektefgvdfhudeltdeigfekvdegheeujedvgeevfeehieehueenucffohhmrghinhepvgigrghmphhlvgdrohhrghenucfkphepkedurdduledtrddvgeekrddvgeeinecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehinhgvthepkedurdduledtrddvgeekrddvgeeipdhhvghloheprghishgrkhgrrdhlrghnpdhmrghilhhfrhhomhepofgrrhgvkhcupeerfgfvhfdqkeersferrfgrpeevheepleeunhhikhhofihskhhireepuceomhgrihhlsehmrghrvghkphgrshhnihhkohifshhkihdrnhgrmhgvqedpnhgspghrtghpthhtohepuddprhgtphhtthhopeehgeejudduseguvggssghughhsrdhgnhhurdhorhhg X-DCC--Metrics: sv147.home.net.pl 1024; Body=1 Fuz1=1 Fuz2=1 X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) In light of the above replies and my own experiences, I propose the following to be the text of the chapter. Formatted in CommonMark. ## 6.1 Specifying Additional Channels You can specify _additional channels_ to pull from. To use a channel, write `~/.config/guix/channels.scm` to instruct `guix pull` to pull from it _in addition to_ or _instead of_ the default Guix channel: ``` ;; Use the literal default. %default-channels ``` ``` ;; Add a channel to the default. (cons (channel (name 'additional-channel) (url "https://example.org/additional-channel.git")) %default-channels) ``` ``` ;; Replace Guix repository with a local copy. (list (channel (name 'guix) (url "/home/user/src/guix"))) ``` Note that the snippets above are (as always!) Scheme code; we use `cons` to add a channel to the list of channels that the variable `%default-channels` is bound to (see [`cons` and lists](link target) in GNU Guile Reference Manual). With this file in place, `guix pull` builds not only Guix, but also the package modules from the added repositories. The result in `~/.config/guix/current` is the union of Guix with the added package modules: ``` $ guix pull --list generations ... Example output ... ``` The output of `guix pull` above shows that Generation 19 includes both Guix and packages from the `additional-channel` channel. Among the new and upgraded packages that are listed, some like `variant-gimp` and `variant-emacs-with-cool-features` might come from `additional- channel`, while others come from the Guix default channel. Don't forget, that the channels can have more options specified, such as authentication. Read the following chapters to learn more about the options. *** PS: (url "file://path/to/local/repository") was not accepted by Guix during my experiments this week. Should I report is as a separate bug? From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 09:34:13 2022 Received: (at submit) by debbugs.gnu.org; 10 Apr 2022 13:34:13 +0000 Received: from localhost ([127.0.0.1]:39748 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ndXhl-0000hK-D2 for submit@debbugs.gnu.org; Sun, 10 Apr 2022 09:34:13 -0400 Received: from lists.gnu.org ([209.51.188.17]:43108) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ndXhj-0000hC-NB for submit@debbugs.gnu.org; Sun, 10 Apr 2022 09:34:11 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:41024) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ndXhj-0000dY-E3 for bug-guix@gnu.org; Sun, 10 Apr 2022 09:34:11 -0400 Received: from tobias.gr ([2a02:c205:2020:6054::1]:47764) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ndXhg-0002uh-SL for bug-guix@gnu.org; Sun, 10 Apr 2022 09:34:11 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; s=2018; bh=o3GYwV8IVV36I fg4DsWmH605XBLE/ZlwhowOEThg0bs=; h=references:in-reply-to:subject:to: from:date; d=tobias.gr; b=ioVxi+Te9UoltMXOovFhtd0v9RakRVOAobzuwX/wvjpN vKUjjn7FGjYY+zQPrrKWPbSeq4KmkWI6BVAfD2U9N+1s8Hk+kfDoL1LzjQ7uIoHuegMovM w4yp5QaoEwP/FqGkyk8VvleYHHEPrAnbLsEXSdmpV2qIT2jycIg3F07nmcDK7jdM1CXZWT ZOQXR5a/r2dKd2ECnSTv2Dk1CyOkYPxVoaQm7Kzg7xe8ij1ovgANxRuGRU/hvy+Nh/04uR 8exno8VfuvVjec6YCBwxML3qJWw/IVRmDHtayUH41M4iH/aa6gbYCTHXBy+1z0KAtSpp4d N9kaH2A1dcgj3c4fEA== Received: by submission.tobias.gr (OpenSMTPD) with ESMTPSA id 845e81e7 (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO); Sun, 10 Apr 2022 13:34:00 +0000 (UTC) Date: Sun, 10 Apr 2022 13:33:56 +0000 From: Tobias Geerinckx-Rice To: bug-guix@gnu.org, =?UTF-8?Q?Marek_Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Subject: =?US-ASCII?Q?Re=3A_bug=2354711=3A_Bad_Documentation_Seri?= =?US-ASCII?Q?es=3A_6=2E1_Specifying_Additional_Channels?= In-Reply-To: <155cb35e7d71ee1a73496ba47dbab6d8a121c0d6.camel@marekpasnikowski.name> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> <155cb35e7d71ee1a73496ba47dbab6d8a121c0d6.camel@marekpasnikowski.name> Message-ID: <00423B2C-F1DE-48F2-AFD4-3AD2BE12A105@tobias.gr> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2a02:c205:2020:6054::1; envelope-from=me@tobias.gr; helo=tobias.gr X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_PASS=-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 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 (--) Hi Marek, On 10 April 2022 12:55:09 UTC, "Marek Pa=C5=9Bnikowski" wrote: >In light of the above replies [=2E=2E=2E] in CommonMark=2E Thanks! Please try to submit Texinfo going forward=2E It doesn't need to= be perfect but it will be so much closer to something we can merge=2E You'll learn something, *and* save Maxime (or someone else) the tedious ch= ore of translating markdown back to markup=2E :-) >PS: (url "file://path/to/local/repository") Hm, I haven't tried relative file names myself=2E For robustness, I sugge= st using absolute ones instead, e=2Eg=2E, file:///home/marek/path/to/local/= repository=2E N=2EB=2E, file:// might be optional, but the leading / is not=2E If that still doesn't work, paste the error you get=2E Kind regards, T G-R Sent on the go=2E Excuse or enjoy my brevity=2E From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 09:55:09 2022 Received: (at submit) by debbugs.gnu.org; 10 Apr 2022 13:55:09 +0000 Received: from localhost ([127.0.0.1]:39835 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ndY20-0001JV-Qu for submit@debbugs.gnu.org; Sun, 10 Apr 2022 09:55:09 -0400 Received: from lists.gnu.org ([209.51.188.17]:54004) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ndY1z-0001J0-Eb for submit@debbugs.gnu.org; Sun, 10 Apr 2022 09:55:07 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:43568) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ndY1z-0007pa-6G for bug-guix@gnu.org; Sun, 10 Apr 2022 09:55:07 -0400 Received: from tobias.gr ([2a02:c205:2020:6054::1]:47774) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ndY1w-0005qE-0p for bug-guix@gnu.org; Sun, 10 Apr 2022 09:55:06 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; s=2018; bh=iAHfc8w4+od1D WUv40Hicv4h4O7AhIObBcdWD8wafRQ=; h=references:in-reply-to:subject:to: from:date; d=tobias.gr; b=ej0nNbtXCxfvGSfUHhXMmkV/3FMXbrveLMt4hLTgtc2S w9Nz6zXKkl8c9T+hKj003El7iAJqt+lslwstK5XAeH6t6BDfySz2n1mksAcLwboNcvJyGj oB6H4wP4+uzJavnquSsJgGuMOdkyVGzaQqaQQiBrqvZ0bVw+S5M5FZ3EJTxzR/epuxhad0 aFVpRP43HP5HLxmAeLRPXdUyv0vQJsYM2jQVILDyauHyUePokgqSMcV+1TWWdeohSp+Sux oBkxtyq2G6uTVcbCMGhZhdjVUehj7fDJ+mzLv+XfoYFhUsS4Ft0lJuhkkHXuumuB2kBdnd B+O6LcwMfrl2w+KE3w== Received: by submission.tobias.gr (OpenSMTPD) with ESMTPSA id 2f1f8503 (TLSv1.3:AEAD-AES256-GCM-SHA384:256:NO); Sun, 10 Apr 2022 13:54:57 +0000 (UTC) Date: Sun, 10 Apr 2022 13:54:56 +0000 From: Tobias Geerinckx-Rice To: bug-guix@gnu.org, =?UTF-8?Q?Marek_Pa=C5=9Bnikowski?= , 54711@debbugs.gnu.org Subject: =?US-ASCII?Q?Re=3A_bug=2354711=3A_Bad_Documentation_Seri?= =?US-ASCII?Q?es=3A_6=2E1_Specifying_Additional_Channels?= In-Reply-To: <00423B2C-F1DE-48F2-AFD4-3AD2BE12A105@tobias.gr> References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> <155cb35e7d71ee1a73496ba47dbab6d8a121c0d6.camel@marekpasnikowski.name> <00423B2C-F1DE-48F2-AFD4-3AD2BE12A105@tobias.gr> Message-ID: <24DF226B-A9CE-448B-BD13-1CEA60864E28@tobias.gr> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2a02:c205:2020:6054::1; envelope-from=me@tobias.gr; helo=tobias.gr X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_PASS=-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 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 (--) > PS: (url "file://path/to/local/repository") Actually, 'path' is a hostname here, so I guess it *must not* work even as= a relative file name=2E =20 Whether Guix/Guile follows standards that well, or correctly errors out fo= r an incorrect reason, I don't know=2E Kind regards, T G-R Sent on the go=2E Excuse or enjoy my brevity=2E From debbugs-submit-bounces@debbugs.gnu.org Sun Apr 10 12:27:14 2022 Received: (at 54711) by debbugs.gnu.org; 10 Apr 2022 16:27:14 +0000 Received: from localhost ([127.0.0.1]:41268 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ndaPC-0007uB-7p for submit@debbugs.gnu.org; Sun, 10 Apr 2022 12:27:14 -0400 Received: from cloudserver3216345-3216376.home.pl ([46.242.242.150]:58712) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ndaPA-0007tq-Nz for 54711@debbugs.gnu.org; Sun, 10 Apr 2022 12:27:13 -0400 Received: from localhost (127.0.0.1) (HELO sv147.home.net.pl) by /usr/run/smtp (/usr/run/postfix/private/idea_relay_lmtp) via UNIX with SMTP (IdeaSmtpServer 5.0.0) id 9cafa44d7e6a1e1e; Sun, 10 Apr 2022 18:27:06 +0200 Received: from aisaka.lan (unknown [81.190.248.246]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by sv147.home.net.pl (Postfix) with ESMTPSA id E94DB57638E for <54711@debbugs.gnu.org>; Sun, 10 Apr 2022 18:27:05 +0200 (CEST) Message-ID: Subject: Bad Documentation Series: 6.1 Specifying Additional Channels From: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= To: 54711@debbugs.gnu.org Date: Sun, 10 Apr 2022 18:27:02 +0200 Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.42.1 MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-CLIENT-IP: 81.190.248.246 X-CLIENT-HOSTNAME: 81.190.248.246 X-VADE-SPAMSTATE: clean X-VADE-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgedvvddrudekgedgleejucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecujffqoffgrffnpdggtffipffknecuuegrihhlohhuthemucduhedtnecuogfvvgigthfqnhhlhidqqdetfeejfedqtdegucdlhedtmdenucfjughrpefkuffhvffftggfggfgsehtjeertddtreejnecuhfhrohhmpeforghrvghkucfrrgjhnhhikhhofihskhhiuceomhgrihhlsehmrghrvghkphgrshhnihhkohifshhkihdrnhgrmhgvqeenucggtffrrghtthgvrhhnpeejkeeghfeujeevvedvfeejhffgudduhefhtefggfevgfefhffgkeeutdeuleduieenucffohhmrghinhepvgigrghmphhlvgdrohhrghdpghhnuhdrohhrghenucfkphepkedurdduledtrddvgeekrddvgeeinecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehinhgvthepkedurdduledtrddvgeekrddvgeeipdhhvghloheprghishgrkhgrrdhlrghnpdhmrghilhhfrhhomhepofgrrhgvkhcupeerfgfvhfdqkeersferrfgrpeevheepleeunhhikhhofihskhhireepuceomhgrihhlsehmrghrvghkphgrshhnihhkohifshhkihdrnhgrmhgvqedpnhgspghrtghpthhtohepuddprhgtphhtthhopeehgeejudduseguvggssghughhsrdhgnhhurdhorhhg X-DCC--Metrics: sv147.home.net.pl 1024; Body=1 Fuz1=1 Fuz2=1 X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 54711 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 (-) ``` @node Specifying Additional Channels @section Specifying Additional Channels @cindex extending the package collection (channels) @cindex variant packages (channels) You can specify @emph{additional channels} to pull from. To use a channel, write @code{~/.config/guix/channels.scm} to instruct @command{guix pull} to pull from it @emph{in addition to} or @emph{instead of} the default Guix channel: @vindex %default-channels @lisp ;; Use the literal default. %default-channels ;; Add a channel to the default. (cons (channel (name 'variant-channel) (url "https://example.org/variant-channel.git")) %default-channels) ;; Replace Guix repository with a local copy. (list (channel (name 'guix) (url "file:///home/user/src/guix"))) @end lisp @noindent Note that the snippets above are (as always!)@: Scheme code; we use @code{cons} to add a channel to the list of channels that the variable @code{%default-channels} is bound to (@pxref{Pairs, @code{cons} and lists,, guile, GNU Guile Reference Manual}). With this file in place, @command{guix pull} builds not only Guix, but also the package modules from the added repositories. The result in @file{~/.config/guix/current} is the union of Guix with the added package modules: @example $ guix pull --list-generations @dots{} Generation 19 Aug 27 2018 16:20:48 guix d894ab8 repository URL: https://git.savannah.gnu.org/git/guix.git branch: master commit: d894ab8e9bfabcefa6c49d9ba2e834dd5a73a300 variant-channel dd3df5e repository URL: https://example.org/variant-channel.git branch: master commit: dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb 11 new packages: variant-gimp, variant-emacs-with-cool-features, @dots{} 4 packages upgraded: emacs-racket-mode@@0.0.2-2.1b78827, @dots{} @end example @noindent The output of @command{guix pull} above shows that Generation@tie{}19 includes both Guix and packages the @code{variant-channel} channel. Among the new and upgraded packages that are listed, some like @code{variant-gimp} and @code{variant-emacs-with-cool-features} might come from @code{variant-channel}, while others come from the Guix default channel. @noindent Don't forget, that the chanels can have more options specified, such as authentication. Read the following pages to learn more about the options. ``` I just checked, and the `file:///` prefix was accepted by Guix.I was not aware of the "prefix thing". This is one of many assumptions which trip up unprepared readers.