From unknown Wed Jun 18 23:09:47 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#39418 <39418@debbugs.gnu.org> To: bug#39418 <39418@debbugs.gnu.org> Subject: Status: [PATCH] doc: Improve documentation on Substitute Server Authorization Reply-To: bug#39418 <39418@debbugs.gnu.org> Date: Thu, 19 Jun 2025 06:09:47 +0000 retitle 39418 [PATCH] doc: Improve documentation on Substitute Server Autho= rization reassign 39418 guix-patches submitter 39418 Damien Cassou severity 39418 normal tag 39418 patch thanks From debbugs-submit-bounces@debbugs.gnu.org Tue Feb 04 09:18:13 2020 Received: (at submit) by debbugs.gnu.org; 4 Feb 2020 14:18:13 +0000 Received: from localhost ([127.0.0.1]:42989 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iyz1o-0000S8-Tf for submit@debbugs.gnu.org; Tue, 04 Feb 2020 09:18:13 -0500 Received: from lists.gnu.org ([209.51.188.17]:38187) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iyz1n-0000S0-6R for submit@debbugs.gnu.org; Tue, 04 Feb 2020 09:18:11 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:51385) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iyz1m-0003kR-3T for guix-patches@gnu.org; Tue, 04 Feb 2020 09:18:11 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,URIBL_BLOCKED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iyz1l-0007MV-1O for guix-patches@gnu.org; Tue, 04 Feb 2020 09:18:09 -0500 Received: from mail.choca.pics ([2001:910:1410:500::1]:44812) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iyz1k-0006kG-OQ for guix-patches@gnu.org; Tue, 04 Feb 2020 09:18:08 -0500 Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id 4E6A0181A5058 for ; Tue, 4 Feb 2020 15:18:05 +0100 (CET) Received: from mail.choca.pics ([IPv6:::1]) by localhost (mail.choca.pics [IPv6:::1]) (amavisd-new, port 10032) with ESMTP id mZe-p4vN6ViY for ; Tue, 4 Feb 2020 15:18:04 +0100 (CET) Received: from localhost (localhost.localdomain [IPv6:::1]) by mail.choca.pics (Postfix) with ESMTP id D04B9181A5048 for ; Tue, 4 Feb 2020 15:18:04 +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 Xsig7QP2Xe0d for ; Tue, 4 Feb 2020 15:18:04 +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 92DF7181A5047 for ; Tue, 4 Feb 2020 15:18:04 +0100 (CET) From: Damien Cassou To: guix-patches@gnu.org Subject: [PATCH] doc: Improve documentation on Substitute Server Authorization Date: Tue, 04 Feb 2020 15:18:03 +0100 Message-ID: <87y2tibfms.fsf@cassou.me> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:910:1410:500::1 X-Spam-Score: 0.2 (/) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.8 (/) --=-=-= Content-Type: text/plain -- Damien Cassou "Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-doc-Improve-documentation-on-Substitute-Server-Autho.patch >From 5055c85f9accf11284223f824f9fd7d4456da308 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 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 956c25ba9e..36c2437d96 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -3292,8 +3292,9 @@ $ 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. +The absence of the @file{.drv} file extension 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 --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Tue Feb 04 19:42:55 2020 Received: (at 39418) by debbugs.gnu.org; 5 Feb 2020 00:42:55 +0000 Received: from localhost ([127.0.0.1]:44978 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iz8mN-0000gG-1k for submit@debbugs.gnu.org; Tue, 04 Feb 2020 19:42:55 -0500 Received: from out3-smtp.messagingengine.com ([66.111.4.27]:33653) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iz8mL-0000g3-BA for 39418@debbugs.gnu.org; Tue, 04 Feb 2020 19:42:53 -0500 Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.nyi.internal (Postfix) with ESMTP id 328B721AD2; Tue, 4 Feb 2020 19:42:48 -0500 (EST) Received: from mailfrontend1 ([10.202.2.162]) by compute4.internal (MEProxy); Tue, 04 Feb 2020 19:42:48 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=famulari.name; h=date:from:to:cc:subject:message-id:references:mime-version :content-type:in-reply-to; s=mesmtp; bh=7Nwx+4EYBbJrjm3vRsxlX0ML ByqHRalOP9bqRQ7+5TI=; b=CFWcO5q2gB8Yz6GnF0ybktYUZHeL2vXsGXnqx86S 0fIENlpR1lZrVWTCUchHN0i/LxVCPSmzsJpyH1X3ZzMFI4AaouqpS5K1CkEZc+Ul BKxDeCU6BI6V7tKUwORrTrFFYu8x3JYQfwuGXXOaoUMuio9/ugNdzEkph3fn2oH4 6Vc= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm1; bh=7Nwx+4 EYBbJrjm3vRsxlX0MLByqHRalOP9bqRQ7+5TI=; b=eIElqw6wbqdJlhHx6aZjt3 FKLOydYvkA9sXcL6CuhXY0G15mTMuAa3D2rNOtu8dQX9kDWvhxf33CKc6zFvWBJ+ +M2VZZ5D7ZK/1JHBk0oAPttnpXGgdnGLxwSGtIj3FDTSkY2sTN9DUYW1f5dDU0+n LI7s1+wQe3rLUkC8O+cYbDxcTO7CipyEivMGZmGksFCwoue5Svrj881CfSDzlCwH 8Xf9JeoQaE8l81V1CN8ALgAZRYxI6NAGU4TeO3IJvfWCc16tMjQt9QasresAPe6q HHUptm/xFKFJvpzVWVWN1HiA6fBiw8IyzY4Kistzbrev5ll2TraZCloAcDZ+JUig == X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedugedrhedtgddviecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpeffhffvuffkfhggtggujgesthdtredttddtvdenucfhrhhomhepnfgvohcuhfgr mhhulhgrrhhiuceolhgvohesfhgrmhhulhgrrhhirdhnrghmvgeqnecukfhppeejiedrud dvgedrudefkedrieefnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghi lhhfrhhomheplhgvohesfhgrmhhulhgrrhhirdhnrghmvg X-ME-Proxy: Received: from localhost (c-76-124-138-63.hsd1.pa.comcast.net [76.124.138.63]) by mail.messagingengine.com (Postfix) with ESMTPA id D18033280060; Tue, 4 Feb 2020 19:42:47 -0500 (EST) Date: Tue, 4 Feb 2020 19:42:42 -0500 From: Leo Famulari To: Damien Cassou Subject: Re: [bug#39418] [PATCH] doc: Improve documentation on Substitute Server Authorization Message-ID: <20200205004242.GD30681@jasmine.lan> References: <87y2tibfms.fsf@cassou.me> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <87y2tibfms.fsf@cassou.me> X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 39418 Cc: 39418@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) On Tue, Feb 04, 2020 at 03:18:03PM +0100, Damien Cassou wrote: > * doc/guix.texi (Substitute Server Authorization): Explain that this is the > absence of the .drv file extension that indicates a proper setup. > -This indicates that substitutes from @code{@value{SUBSTITUTE-SERVER}} are usable and > -will be downloaded, when possible, for future builds. > +The absence of the @file{.drv} file extension indicates that substitutes > +from @code{@value{SUBSTITUTE-SERVER}} are usable and will be downloaded, > +when possible, for future builds. The text "would be downloaded" is what indicates that substitutes are working. It's in contrast to the text from the previous example "The following derivations would be built". From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 05 05:31:13 2020 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 To: Leo Famulari Subject: Re: [bug#39418] [PATCH] doc: Improve documentation on Substitute Server Authorization 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 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 39418 Cc: 39418@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --=-=-= Content-Type: text/plain 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. -- Damien Cassou "Success is the ability to go from one failure to another without losing enthusiasm." --Winston Churchill --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-doc-Improve-documentation-on-Substitute-Server-Autho.patch >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 --=-=-=-- From debbugs-submit-bounces@debbugs.gnu.org Wed Feb 05 15:14:49 2020 Received: (at 39418-done) by debbugs.gnu.org; 5 Feb 2020 20:14:49 +0000 Received: from localhost ([127.0.0.1]:46764 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1izR4S-00070O-Nk for submit@debbugs.gnu.org; Wed, 05 Feb 2020 15:14:48 -0500 Received: from wout3-smtp.messagingengine.com ([64.147.123.19]:43267) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1izR4P-00070A-P3 for 39418-done@debbugs.gnu.org; Wed, 05 Feb 2020 15:14:47 -0500 Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.west.internal (Postfix) with ESMTP id BF5D8756; Wed, 5 Feb 2020 15:14:39 -0500 (EST) Received: from mailfrontend2 ([10.202.2.163]) by compute4.internal (MEProxy); Wed, 05 Feb 2020 15:14:40 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=famulari.name; h=date:from:to:cc:subject:message-id:references:mime-version :content-type:in-reply-to; s=mesmtp; bh=+Naa67bIGGi+MzU0+VXHOw+F r8OLz2KhrNSAdt23WRs=; b=DffkFHqDNNekZVaCd9/T5Khr6AigbZOitK9CLl+2 EvSQcu6FXeUWXiQJHL5aMb10NVEbXuckyG+qZDSXF6/zvTXxouYgnFP5uzAqoACg ZjWip8meSKMGwBSxm9V0iTBpGQCDFoB3WSAay01V0bl1eAURrGBS5dJBlrivqJJ1 ack= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm2; bh=+Naa67 bIGGi+MzU0+VXHOw+Fr8OLz2KhrNSAdt23WRs=; b=CbixqSmXw9GGfh9g9+yNfq +8J0Bdt95IHiopd+16oRGitMJBvu1qOJTF7yQty43SjCI8N03mzY3w5H8DOr6wDe 8BXm3lcjk3OKvjPzTf6Lr4tjEudypt3hvWHXCJX2xBvO0ZxJAlN6ZeGIN6PBWGl1 JU1RMZDzB5DlEyiYhxYQAen/s7RHC7CGLCM91s1yGZxSciLRSgerprIw6LwX0652 nYBrnyxpCBqBiapIqO9+3SDeHrdu6iR8DP005B7POGmKID9+BHMv2e4KEXmN/nmg lRdaPYdAMZLTx2q/twxa57da/bOH0vu4BmN+e/GEeliwLBaouPn558AgFmopARGw == X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedugedrhedugdduvdelucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhepfffhvffukfhfgggtuggjsehttdertddttddvnecuhfhrohhmpefnvghoucfh rghmuhhlrghrihcuoehlvghosehfrghmuhhlrghrihdrnhgrmhgvqeenucfkphepjeeird duvdegrddufeekrdeifeenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgr ihhlfhhrohhmpehlvghosehfrghmuhhlrghrihdrnhgrmhgv X-ME-Proxy: Received: from localhost (c-76-124-138-63.hsd1.pa.comcast.net [76.124.138.63]) by mail.messagingengine.com (Postfix) with ESMTPA id 5618730600DC; Wed, 5 Feb 2020 15:14:38 -0500 (EST) Date: Wed, 5 Feb 2020 15:14:37 -0500 From: Leo Famulari To: Damien Cassou Subject: Re: [bug#39418] [PATCH] doc: Improve documentation on Substitute Server Authorization Message-ID: <20200205201437.GA6380@jasmine.lan> References: <87y2tibfms.fsf@cassou.me> <20200205004242.GD30681@jasmine.lan> <87a75xgwb8.fsf@cassou.me> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <87a75xgwb8.fsf@cassou.me> X-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 39418-done Cc: 39418-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) On Wed, Feb 05, 2020 at 11:31:07AM +0100, Damien Cassou wrote: > -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. Thanks! I simplified the text a bit and pushed as ea9cc4ef219e62de569945816a5e666775e7fa41 From unknown Wed Jun 18 23:09:47 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 05 Mar 2020 12:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator