From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id cM4kKSrdUmJrRQEAgWs5BA (envelope-from ) for ; Sun, 10 Apr 2022 15:35:38 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id ILFiISrdUmJuDwEAG6o9tA (envelope-from ) for ; Sun, 10 Apr 2022 15:35:38 +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 3218376A6 for ; Sun, 10 Apr 2022 15:35:38 +0200 (CEST) Received: from localhost ([::1]:42636 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ndX6x-0006JU-3i for larch@yhetil.org; Sun, 10 Apr 2022 08:56:11 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35502) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ndX6o-0006JM-Fm for bug-guix@gnu.org; Sun, 10 Apr 2022 08:56:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:45838) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ndX6o-0005cH-7J for bug-guix@gnu.org; Sun, 10 Apr 2022 08:56:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ndX6n-0008DY-W9 for bug-guix@gnu.org; Sun, 10 Apr 2022 08:56:02 -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 12:56: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.164959532231538 (code B ref 54711); Sun, 10 Apr 2022 12:56:01 +0000 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> From: Marek =?UTF-8?Q?Pa=C5=9Bnikowski?= 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-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=1649597738; 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=BKwMXVKATM7wpsTh297bYH9MO8s3qnMlQxe1mZqjYVA=; b=dqFjCyakLynvABL/xs7YQQhQWxK91IpORA9LSP/CqKOQ3brc6smbTmIyK0GV8nSPfwFZQr fDcG4qZgp6cCR6yldrnMHhcdKzgR58aka1jrb0C1YvQ2YgCU8ZTxlyug6wGLhO9cOeRojl 8JdTicJ/o6PX9vtllkRNcLtW/ldxmxt6i19ZDNYmZ3IogST86BeKd2HN3wk+7B8nRUYTpb h4YWRh05FQROrx0Z41C+Wop5MeJQ6H/WtCpgOwwvCdGF8T0suCdEX3PsgpalsD7xxBW/zF LIzYJoo4Y4FZcJioYGSgut01bFH8WCcQxBZqDSy/G5ad0VlbAMRSarYOkSubCw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1649597738; a=rsa-sha256; cv=none; b=Q1EUtEVQdKdJUgnaOQDHF43SHHRG6QkafJKJaPApJ/AnXlZnflkdkKMQGrH2FHMq/WRD2J YKPYUk4T9uXN+ZTQQf5TTh1iBhFoQb0iFa3/692F6L8Xoe+dWPLyzc3A24NP6RvwVrqctS GoMgrF7VPxNJ4SO/SdPup/lu2xeCQlTg0FQtc1z8/Aux8o9NUAv4gc7nvZ8kTZzpjvJBU2 8kv37g54Yb3ByBp7EokEEND9LCTTEwuIYrwgx2eCxe9/X7+U0IAOov+qrx918lvyXOVhuC tsnCv9JAW2WRgui+5M+Uu1BPrjCuk9KoMkQu0IrTR30LJDuU+6CFkmbEX4j52g== 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: -3.07 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: 3218376A6 X-Spam-Score: -3.07 X-Migadu-Scanner: scn1.migadu.com X-TUID: cer0yuqOeL/D 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?