about summary refs log tree commit diff
diff options
context:
space:
mode:
authorEelco Dolstra <edolstra@gmail.com>2018-11-07T10·42+0100
committerEelco Dolstra <edolstra@gmail.com>2018-11-07T10·42+0100
commit5a3f140856185ae0c6ee9270ad5d5fbc0505e3f2 (patch)
treedcda64db250163adbbd6c2788ae0dae7d14bef29
parent1109193ea3a25208d438c65b2d79e207ae1af039 (diff)
Document allowSubstitutes
-rw-r--r--doc/manual/expressions/advanced-attributes.xml14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/manual/expressions/advanced-attributes.xml b/doc/manual/expressions/advanced-attributes.xml
index db981b60713b..a9b97b91a0a2 100644
--- a/doc/manual/expressions/advanced-attributes.xml
+++ b/doc/manual/expressions/advanced-attributes.xml
@@ -322,6 +322,20 @@ big = "a very long string";
 
   </varlistentry>
 
+
+  <varlistentry><term><varname>allowSubstitutes</varname></term>
+
+    <listitem><para>If this attribute is set to
+    <literal>false</literal>, then Nix will always build this
+    derivation; it will not try to substitute its outputs. This is
+    useful for very trivial derivations (such as
+    <function>writeText</function> in Nixpkgs) that are cheaper to
+    build locally than to substitute from a binary
+    cache.</para></listitem>
+
+  </varlistentry>
+
+
 </variablelist>
 
 </section>