From patchwork Wed Feb 5 10:31:07 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Damien Cassou X-Patchwork-Id: 20134 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 12585168D9; Wed, 5 Feb 2020 10:32:13 +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.9 required=5.0 tests=BAYES_00,MAILING_LIST_MULTI, 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 ESMTP id C5CEF168CA for ; Wed, 5 Feb 2020 10:32:12 +0000 (GMT) Received: from localhost ([::1]:44538 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1izHye-0001uL-Bj for patchwork@mira.cbaines.net; Wed, 05 Feb 2020 05:32:12 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:58254) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1izHyV-0001sI-Td for guix-patches@gnu.org; Wed, 05 Feb 2020 05:32:04 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1izHyU-0008Ft-Se for guix-patches@gnu.org; Wed, 05 Feb 2020 05:32:03 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:39181) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1izHyU-0008F2-NM for guix-patches@gnu.org; Wed, 05 Feb 2020 05:32:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1izHyU-00083W-JM for guix-patches@gnu.org; Wed, 05 Feb 2020 05:32:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#39418] [PATCH] doc: Improve documentation on Substitute Server Authorization Resent-From: Damien Cassou Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 05 Feb 2020 10:32:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 39418 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Leo Famulari Cc: 39418@debbugs.gnu.org Received: via spool by 39418-submit@debbugs.gnu.org id=B39418.158089867330911 (code B ref 39418); Wed, 05 Feb 2020 10:32:02 +0000 Received: (at 39418) by debbugs.gnu.org; 5 Feb 2020 10:31:13 +0000 Received: from localhost ([127.0.0.1]:45154 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1izHxg-00082V-Sw for submit@debbugs.gnu.org; Wed, 05 Feb 2020 05:31:13 -0500 Received: from mail.choca.pics ([80.67.172.235]:58306) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1izHxf-00082J-1l for 39418@debbugs.gnu.org; Wed, 05 Feb 2020 05:31:12 -0500 Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 6EDA61819D8B0; Wed, 5 Feb 2020 11:31:09 +0100 (CET) Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10032) with ESMTP id xtOIsTbKqujE; Wed, 5 Feb 2020 11:31:08 +0100 (CET) Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id C32081819D8B6; Wed, 5 Feb 2020 11:31:08 +0100 (CET) X-Virus-Scanned: amavisd-new at choca.pics Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10026) with ESMTP id K1zrp4SlKoVK; Wed, 5 Feb 2020 11:31:08 +0100 (CET) Received: from luz4 (lfbn-ren-1-1414-74.w90-27.abo.wanadoo.fr [90.27.133.74]) by mail.choca.pics (Postfix) with ESMTPSA id 7196D18195793; Wed, 5 Feb 2020 11:31:08 +0100 (CET) From: Damien Cassou In-Reply-To: <20200205004242.GD30681@jasmine.lan> References: <87y2tibfms.fsf@cassou.me> <20200205004242.GD30681@jasmine.lan> Date: Wed, 05 Feb 2020 11:31:07 +0100 Message-ID: <87a75xgwb8.fsf@cassou.me> MIME-Version: 1.0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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 Leo Famulari writes: > On Tue, Feb 04, 2020 at 03:18:03PM +0100, Damien Cassou wrote: > The text "would be downloaded" is what indicates that substitutes are > working. I didn't notice this difference :-). It seems pretty obvious now. I still think making it explicit would improve understanding. Here is a modified patch. You may close the issue if you think no change is necessary. From 8642c07f2a31c77cc84c70fd31b20f78515bf934 Mon Sep 17 00:00:00 2001 From: Damien Cassou Date: Tue, 4 Feb 2020 15:13:06 +0100 Subject: [PATCH] doc: Improve documentation on Substitute Server Authorization * doc/guix.texi (Substitute Server Authorization): Explain that this is the absence of the .drv file extension that indicates a proper setup. --- doc/guix.texi | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 956c25ba9e..5b325642db 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -3292,8 +3292,10 @@ $ guix build emacs --dry-run @end example @noindent -This indicates that substitutes from @code{@value{SUBSTITUTE-SERVER}} are usable and -will be downloaded, when possible, for future builds. +Please note that the introductory text changed from ``The following +derivations would be built'' to ``112.3 MB would be downloaded''. This +indicates that substitutes from @code{@value{SUBSTITUTE-SERVER}} are +usable and will be downloaded, when possible, for future builds. @cindex substitutes, how to disable The substitute mechanism can be disabled globally by running -- 2.24.1