diff options
| author | Eelco Dolstra <eelco.dolstra@logicblox.com> | 2014-02-12 10:53:22 +0100 |
|---|---|---|
| committer | Eelco Dolstra <eelco.dolstra@logicblox.com> | 2014-02-12 10:53:22 +0100 |
| commit | f9fc6acbf4eadd2d9018d3da14394fdfbddde5f6 (patch) | |
| tree | 5b8c88d5cbe2d117210fb06d2fb1ab600314393c | |
| parent | 1f841c9d50a100a3d40fec6260d36ec9ee309af3 (diff) | |
| download | guix-f9fc6acbf4eadd2d9018d3da14394fdfbddde5f6.tar.gz | |
Document current meaning of preferLocalBuild
Closes #208.
| -rw-r--r-- | doc/manual/writing-nix-expressions.xml | 13 |
1 files changed, 8 insertions, 5 deletions
diff --git a/doc/manual/writing-nix-expressions.xml b/doc/manual/writing-nix-expressions.xml index 3e6cd73790..c5b355ea04 100644 --- a/doc/manual/writing-nix-expressions.xml +++ b/doc/manual/writing-nix-expressions.xml @@ -1740,12 +1740,15 @@ impureEnvVars = [ "http_proxy" "https_proxy" <replaceable>...</replaceable> ]; <varlistentry><term><varname>preferLocalBuild</varname></term> <listitem><para>If this attribute is set to - <literal>true</literal> and <link + <literal>true</literal>, it has two effects. First, the + derivation will always be built, not substituted, even if a + substitute is available. Second, if <link linkend="chap-distributed-builds">distributed building is - enabled</link>, then, if possible, perform this build locally - instead of forwarding it to a remote machine. This is appropriate - for trivial builders where the cost of doing a remote build would - exceed the cost of building locally.</para></listitem> + enabled</link>, then, if possible, the derivaton will be built + locally instead of forwarded to a remote machine. This is + appropriate for trivial builders where the cost of doing a + download or remote build would exceed the cost of building + locally.</para></listitem> </varlistentry> |