doc: Spell out the implications of disabling substitutes.
authorLudovic Courtès <ludo@gnu.org>
Fri, 28 May 2021 14:10:19 +0000 (16:10 +0200)
committerLudovic Courtès <ludo@gnu.org>
Fri, 28 May 2021 21:04:43 +0000 (23:04 +0200)
Suggested by elb on #guix.

* doc/guix.texi (Binary Installation): Add note explaining the
implications of disabling substitutes.

doc/guix.texi

index e8b0485..52c263f 100644 (file)
@@ -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}.