02/12: doc: Spell out the implications of disabling substitutes.

[guix-commits]

civodul pushed a commit to branch master
in repository guix.

commit 22f95a09eb9f136e59e2c2588a2c28a449155202
Author: Ludovic Courtès <ludo@gnu.org>
AuthorDate: Fri May 28 16:10:19 2021 +0200

    doc: Spell out the implications of disabling substitutes.
    
    Suggested by elb on #guix.
    
    * doc/guix.texi (Binary Installation): Add note explaining the
    implications of disabling substitutes.
---
 doc/guix.texi | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index e8b0485..52c263f 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -787,6 +787,13 @@ To use substitutes from @code{@value{SUBSTITUTE-SERVER}} 
or one of its mirrors
      ~root/.config/guix/current/share/guix/@value{SUBSTITUTE-SERVER}.pub
 @end example
 
+@quotation Note
+If you do not enable substitutes, Guix will end up building
+@emph{everything} from source on your machine, making each installation
+and upgrade very expensive.  @xref{On Trusting Binaries}, for a
+discussion of reasons why one might want do disable substitutes.
+@end quotation
+
 @item
 Each user may need to perform a few additional steps to make their Guix
 environment ready for use, @pxref{Application Setup}.