From patchwork Fri Mar 26 07:03:18 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Tournier X-Patchwork-Id: 28120 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 9D6C427BC5D; Fri, 26 Mar 2021 07:04:43 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H4, RCVD_IN_MSPIKE_WL,SPF_HELO_PASS,T_DKIM_INVALID,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.2 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 25C5727BC5C for ; Fri, 26 Mar 2021 07:04:43 +0000 (GMT) Received: from localhost ([::1]:49156 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lPgWQ-0008SS-CA for patchwork@mira.cbaines.net; Fri, 26 Mar 2021 03:04:42 -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 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+patchwork=mira.cbaines.net@gnu.org Sender: "Guix-patches" X-getmail-retrieved-from-mailbox: Patches 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