about summary refs log tree commit diff
path: root/doc/manual/writing-nix-expressions.xml
diff options
context:
space:
mode:
authorShea Levy <shea@shealevy.com>2014-03-10T11·09-0400
committerEelco Dolstra <eelco.dolstra@logicblox.com>2014-03-11T12·15+0100
commit2f2a20ed18535ba819225fabe9a4cf2f37d2edb1 (patch)
treed5378f4677c7828ed48fa7c843701c4015637fce /doc/manual/writing-nix-expressions.xml
parent049a379ec6ca755bcc077fd0e8da186ff76b8679 (diff)
Document null dynamic attrs
Diffstat (limited to 'doc/manual/writing-nix-expressions.xml')
-rw-r--r--doc/manual/writing-nix-expressions.xml11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/manual/writing-nix-expressions.xml b/doc/manual/writing-nix-expressions.xml
index 71cd84b072b4..873dc21a5292 100644
--- a/doc/manual/writing-nix-expressions.xml
+++ b/doc/manual/writing-nix-expressions.xml
@@ -871,6 +871,17 @@ This will evaluate to <literal>123</literal> if
 coerced to a string and <literal>456</literal> otherwise (again
 assuming <literal>bar</literal> is antiquotable).</para>
 
+<para>In the special case where an attribute name inside of a set declaration
+evaluates to <literal>"${null}"</literal> (which is normally an error, as
+<literal>null</literal> is not antiquotable), that attribute is simply not
+added to the set:
+
+<programlisting>
+{ ${if foo then "bar" else null} = true; }</programlisting>
+
+This will evaluate to <literal>{}</literal> if <literal>foo</literal>
+evaluates to <literal>false</literal>.</para>
+
 
 </simplesect>