[bug#39418] [PATCH] doc: Improve documentation on Substitute Server Authorization

[Damien Cassou <damien@cassou.me>]

[-- Attachment #1: Type: text/plain, Size: 531 bytes --]

Leo Famulari <leo@famulari.name> 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

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-doc-Improve-documentation-on-Substitute-Server-Autho.patch --]
[-- Type: text/x-patch, Size: 1178 bytes --]

From 8642c07f2a31c77cc84c70fd31b20f78515bf934 Mon Sep 17 00:00:00 2001
From: Damien Cassou <damien@cassou.me>
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