From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id 0BKsJZ8FU2Jz6wAAgWs5BA (envelope-from ) for ; Sun, 10 Apr 2022 18:28:15 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id IM7pIp8FU2LTewEA9RJhRA (envelope-from ) for ; Sun, 10 Apr 2022 18:28:15 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 080A31545F for ; Sun, 10 Apr 2022 18:28:15 +0200 (CEST) Received: from localhost ([::1]:60728 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ndaQA-0008H0-4R for larch@yhetil.org; Sun, 10 Apr 2022 12:28:14 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:36720) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ndaPx-0008Gl-U6 for bug-guix@gnu.org; Sun, 10 Apr 2022 12:28:01 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:47372) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ndaPx-0002Jv-Ly for bug-guix@gnu.org; Sun, 10 Apr 2022 12:28:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ndaPx-0007vF-JZ for bug-guix@gnu.org; Sun, 10 Apr 2022 12:28:01 -0400 X-Loop: help-debbugs@gnu.org Subject: bug#54711: Bad Documentation Series: 6.1 Specifying Additional Channels References: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> In-Reply-To: <47274732e10dfe517a608d869117cb0253e2623b.camel@marekpasnikowski.name> Resent-From: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Sun, 10 Apr 2022 16:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 54711 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: 54711@debbugs.gnu.org Received: via spool by 54711-submit@debbugs.gnu.org id=B54711.164960803430395 (code B ref 54711); Sun, 10 Apr 2022 16:28:01 +0000 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: From: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1649608095; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post; bh=P8xmbVI2lzFAiNMc2hhkm+ugTzfi6fw2gp/ufPlzQ7M=; b=SmP0opXUgINdozV8cUrM4zQbDmh1k1eCPaxaawq9DKI6670zryJgPoBGb82qIqOCw8X24+ EMVVS+OuYLNAeOMSNTgw1PFNEoCv59De6J6WIQEcFVkY9fvA/3Wsfg0LmRFJA5t12/PrKW vOVg5c2wniYTgiJe8QukqZnxZ1tiPQOaz2Bs4o/AtFKXtlvVCSkmv216BBeSjFSjCSPss0 F2IZEdCtzNUq5l4JNdOckkwPGIe1SGa4K/Rnr8xUdcVCN4chJ/NAUorpiXmrW7yd5jyH50 fVzl5IDO2RpgekHewI9R+ryTO36lBqD7ZTu8O2w6clqs7bXN/yVT1MQkitt0Dg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1649608095; a=rsa-sha256; cv=none; b=irBhPjYJ+4h9yGLpACnw5juyVHDrceCa0IhFM1GLtIAMoFwo+LAkoSJCtZ6aOfwODdf87e Z9PZc8jVVnma957SSNhEpeZrdDjyjThrF2zTsSwhd6j6PK9KZevwKiioPXd2yKCO5QDk/p 8ZaxXyN3aRzwByVmpgX7av6dLktwBoSUi+cfnCNNoeriQTg1wAJ1j1C9632rGqzhpt3aC2 Ee6iWylyXnjYED3oLGykA6592dyJHyTU9k1Q7TVDyh6D/AztKIleTtSOxSbNAkGCDSiQlY 8QSss6cxh7sukLxU0Xx2WGNtokG98HrGpfAkrpZ/gW8Ww5TXRgAWsyrrhIQrcg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -1.57 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 080A31545F X-Spam-Score: -1.57 X-Migadu-Scanner: scn1.migadu.com X-TUID: jvS347go6vQj ``` @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.