From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:8:6d80::]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id WGYAMoyHXWCqNQAAgWs5BA (envelope-from ) for ; Fri, 26 Mar 2021 08:04:44 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id kGvxK4yHXWDOPQAA1q6Kng (envelope-from ) for ; Fri, 26 Mar 2021 07:04:44 +0000 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 3153B31EBA for ; Fri, 26 Mar 2021 08:04:43 +0100 (CET) Received: from localhost ([::1]:49156 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lPgWQ-0008SS-St for larch@yhetil.org; Fri, 26 Mar 2021 03:04:43 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46002) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lPgVm-0007wU-QT for guix-patches@gnu.org; Fri, 26 Mar 2021 03:04:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:56917) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lPgVm-0000Mf-J0 for guix-patches@gnu.org; Fri, 26 Mar 2021 03:04:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1lPgVm-0000Za-EX for guix-patches@gnu.org; Fri, 26 Mar 2021 03:04:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#47404] [PATCH 1/2] doc: Reorder "Channels with Substitutes". References: <20210326064931.32395-1-zimon.toutoune@gmail.com> In-Reply-To: <20210326064931.32395-1-zimon.toutoune@gmail.com> Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Fri, 26 Mar 2021 07:04:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 47404 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 47404@debbugs.gnu.org Cc: zimoun Received: via spool by 47404-submit@debbugs.gnu.org id=B47404.16167422152161 (code B ref 47404); Fri, 26 Mar 2021 07:04:02 +0000 Received: (at 47404) by debbugs.gnu.org; 26 Mar 2021 07:03:35 +0000 Received: from localhost ([127.0.0.1]:40228 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lPgVK-0000Yl-HM for submit@debbugs.gnu.org; Fri, 26 Mar 2021 03:03:34 -0400 Received: from mail-wr1-f53.google.com ([209.85.221.53]:42840) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1lPgVI-0000YR-0e for 47404@debbugs.gnu.org; Fri, 26 Mar 2021 03:03:32 -0400 Received: by mail-wr1-f53.google.com with SMTP id x13so4565331wrs.9 for <47404@debbugs.gnu.org>; Fri, 26 Mar 2021 00:03:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=RDL56GzxQXfuzRSGV59YS8eSJnS/WDd1CGhm5m2OPJg=; b=EpmfTa9UQVFUhb4CdWPvv/w8JN1QycHS+kOmpAwgalH1f71kR3PAo1XOZfH69zF203 S4t0Tne7t9N2hGWK3dr/sCae0sVyfecD1wcgYTSacp2kdR1yoBie6EdKh561xyadsT1A JrNXqRlxg3HZY7ItHKk+zIGdmUDKWw6gEcnRmuU/bsyom11VJFb1rXF9HdcTxjqey6g4 ldZQL/PmlvAFz6xSuBDFxFWqB9WUtMJT1eLMuOXS5pHbi6/XFhvExUVB66zRzMhDCG0v 76rGbNiihAr6aq9Lg82Hv8E4tK0+zLJe/9bqoAyCr2HY5jNN8TZWJBMNm75756iMCBPM 9Vfw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=RDL56GzxQXfuzRSGV59YS8eSJnS/WDd1CGhm5m2OPJg=; b=sEzUivFursDEWArlloZSPRuA1oVVj35HtkjrzhzcX1JYQShZPUyayW47nOD/lo1uOA k1GKNM8qnss+mM2Xsc6sfGfXJEnV9+yBDvPXyKPzOMD9lX6gFfE+ap13UUMz5Ji7+jol OHjKdqzXQLpqg3O8RRIc7zq9yWmd9bDFpdlAItyNbsPpd/oelRFgo7EutJlLIr+akdqx ytA7/ey7YUEqzH4RWLtEYmOruK1zh/RRM/0tZ77FNjIExErivRhMgWuvurFymJqRkpei iOxtO86DfVmLkj8681XsVJqa5UitoTumoVdegLZ7RF0qxbUtnxxPFVU/NE8Ry4+6Pq7Q FoYg== X-Gm-Message-State: AOAM533BOOfiYSfslD7yea3I/P/7dQ3CqCmaZB0hPftYbnMuFCzlm7E+ 89PMAKIySCzutaiaLB5PPA11s+qDbxY= X-Google-Smtp-Source: ABdhPJybTOWfpPNQYHjHnK7Fi/S83T9KXEOGWEXpjHfehGCNIMBC76NxkGaoztQkWcFTmx5sloSqHw== X-Received: by 2002:a5d:518c:: with SMTP id k12mr12857175wrv.15.1616742206134; Fri, 26 Mar 2021 00:03:26 -0700 (PDT) Received: from lili.univ-paris-diderot.fr ([2a01:e0a:59b:9120:65d2:2476:f637:db1e]) by smtp.gmail.com with ESMTPSA id x14sm11011472wrw.13.2021.03.26.00.03.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 26 Mar 2021 00:03:25 -0700 (PDT) From: zimoun Date: Fri, 26 Mar 2021 08:03:18 +0100 Message-Id: <20210326070319.5236-1-zimon.toutoune@gmail.com> X-Mailer: git-send-email 2.29.2 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1616742284; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: 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:dkim-signature; bh=RDL56GzxQXfuzRSGV59YS8eSJnS/WDd1CGhm5m2OPJg=; b=Jnctpq+BXG5MyDPAf1kDXO4C34UHxa8q4vRNd5w7AoxWsmZuLS7ycAKnXkMDfXabQb3R3Q tZcRiFru3zo4F81zsyDT+CwUFKN6eimKArncyHXxE8fDDYqk3CnYShcYQlGhXp1/UiDBFt Opfo2pjay52HJfLptKGKENPWe/7p4chwaV3AsluRGZy0bu8pPxUk8/ccnzqyTTkm7Gm8gG ket6q171gNFT+cs2GLsiIaFEH2AT9PFplUETWz/vkg3ksZTLKhCnVSVF7eRWFuCMEUolKR flBAirHLKLn7EcrJrId73gchkFdP4BvT2ZhlTPUAtZOLvUOxrr6BCrjfjLJ3DQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1616742284; a=rsa-sha256; cv=none; b=rWbHqZgVelgUvbBUFJTMBue5VYRHNLm3q8Ibfv1wB7EseVm9CAud/eTYUZaqfhJMJLNDaD irHoz5ZfEahfOZp9/zMBwncvR44EQlAKDwJf1qqDD5qR56o6U51+KChKx7VOWPKDDxO1Cn Pu5qsTgDIZbt8+/ECmPtiGD/0q23uyTZ0Ipah0+Nh3gKCqqhyniuIQwwCypkSduN1jxbIb VRGPCkJnjAu/4i7oNe2BwVFARNzuubUnDjFTyDilWNMLIic1tYKGDr8vHn7tdEIJ2PiGdA AEgaYEcPVc5uskWCz0tvJVq6X0qNFGaLqbirwN4/jUVV+Bd7rUqLR9uFQQknSA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b=EpmfTa9U; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Spam-Score: 2.68 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b=EpmfTa9U; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Queue-Id: 3153B31EBA X-Spam-Score: 2.68 X-Migadu-Scanner: scn0.migadu.com X-TUID: lEJv8j878pe8 Ordering consistency introduced by 12871cc8db701a89f7f64303e1f16a8537a12561. * doc/guix.texi (Channels): Move section "Channels with Substitutes". Update the master menu. --- doc/guix.texi | 54 +++++++++++++++++++++++++-------------------------- 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index c23d044ff5..3bc8d029d9 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -240,13 +240,13 @@ Channels * Using a Custom Guix Channel:: Using a customized Guix. * Replicating Guix:: Running the @emph{exact same} Guix. * Channel Authentication:: How Guix verifies what it fetches. +* Channels with Substitutes:: Using channels with available substitutes. * Creating a Channel:: How to write your custom channel. * Package Modules in a Sub-directory:: Specifying the channel's package modules location. * Declaring Channel Dependencies:: How to depend on other channels. * Specifying Channel Authorizations:: Defining channel authors authorizations. * Primary URL:: Distinguishing mirror to original. * Writing Channel News:: Communicating information to channel's users. -* Channels with Substitutes:: Using channels with available substitutes. Development @@ -5007,13 +5007,13 @@ updates. * Using a Custom Guix Channel:: Using a customized Guix. * Replicating Guix:: Running the @emph{exact same} Guix. * Channel Authentication:: How Guix verifies what it fetches. +* Channels with Substitutes:: Using channels with available substitutes. * Creating a Channel:: How to write your custom channel. * Package Modules in a Sub-directory:: Specifying the channel's package modules location. * Declaring Channel Dependencies:: How to depend on other channels. * Specifying Channel Authorizations:: Defining channel authors authorizations. * Primary URL:: Distinguishing mirror to original. * Writing Channel News:: Communicating information to channel's users. -* Channels with Substitutes:: Using channels with available substitutes. @end menu @node Specifying Additional Channels @@ -5169,6 +5169,31 @@ introduction from a trusted source since that is the root of your trust. If you're curious about the authentication mechanics, read on! +@node Channels with Substitutes +@section Channels with Substitutes + +When running @command{guix pull}, Guix will first compile the +definitions of every available package. This is an expensive operation +for which substitutes (@pxref{Substitutes}) may be available. The +following snippet in @file{channels.scm} will ensure that @command{guix +pull} uses the latest commit with available substitutes for the package +definitions: this is done by querying the continuous integration +server at @url{https://ci.guix.gnu.org}. + +@lisp +(use-modules (guix ci)) + +(list (channel-with-substitutes-available + %default-guix-channel + "https://ci.guix.gnu.org")) +@end lisp + +Note that this does not mean that all the packages that you will +install after running @command{guix pull} will have available +substitutes. It only ensures that @command{guix pull} will not try to +compile package definitions. This is particularly useful when using +machines with limited resources. + @node Creating a Channel @section Creating a Channel @@ -5485,31 +5510,6 @@ xgettext -o news.po -l scheme -ken etc/news.txt To sum up, yes, you could use your channel as a blog. But beware, this is @emph{not quite} what your users might expect. -@node Channels with Substitutes -@section Channels with Substitutes - -When running @command{guix pull}, Guix will first compile the -definitions of every available package. This is an expensive operation -for which substitutes (@pxref{Substitutes}) may be available. The -following snippet in @file{channels.scm} will ensure that @command{guix -pull} uses the latest commit with available substitutes for the package -definitions: this is done by querying the continuous integration -server at @url{https://ci.guix.gnu.org}. - -@lisp -(use-modules (guix ci)) - -(list (channel-with-substitutes-available - %default-guix-channel - "https://ci.guix.gnu.org")) -@end lisp - -Note that this does not mean that all the packages that you will -install after running @command{guix pull} will have available -substitutes. It only ensures that @command{guix pull} will not try to -compile package definitions. This is particularly useful when using -machines with limited resources. - @c ********************************************************************* @node Development @chapter Development -- 2.29.2