From ce8c53bffa2f79f680f9b27bcb494a4fadb4038c Mon Sep 17 00:00:00 2001 From: Chris Marusich Date: Fri, 10 Nov 2017 15:19:16 -0800 Subject: [PATCH] doc: Clarify the --fallback option. * doc/guix.texi (Common Build Options): Describe --fallback in more detail. In particular, call out the fact that local builds can still happen even when --fallback is omitted. --- doc/guix.texi | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/doc/guix.texi b/doc/guix.texi index b7f4f88f9..40705c4b8 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -5159,7 +5159,13 @@ Do not build the derivations. @item --fallback When substituting a pre-built binary fails, fall back to building -packages locally. +locally. This affects behavior only when substitutes are enabled and +Guix is building a derivation for which a substitute is known. When address@hidden is omitted, the build will fail if substitution fails. +However, when @code{--fallback} is given, Guix will try to build the +derivation locally if substitution fails. When substitutes are not +enabled or Guix is building a derivation for which a substitute is not +known, a local build will always be performed. @item address@hidden @anchor{client-substitute-urls} -- 2.14.2