From 4b0a720ddf05ba03c7ea94dc38bd5ec0ab1285dd Mon Sep 17 00:00:00 2001
From: Gergely Risko <errge@nilcons.com>
Date: Thu, 21 Aug 2014 23:46:28 +0200
Subject: [PATCH] Document the "out" usage in allowedReferences

---
 doc/manual/writing-nix-expressions.xml | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/doc/manual/writing-nix-expressions.xml b/doc/manual/writing-nix-expressions.xml
index 6db2adcfa..0470625ff 100644
--- a/doc/manual/writing-nix-expressions.xml
+++ b/doc/manual/writing-nix-expressions.xml
@@ -1561,10 +1561,11 @@ allowedReferences = [];
 </programlisting>
 
     enforces that the output of a derivation cannot have any runtime
-    dependencies on its inputs.  This is used in NixOS to check that
-    generated files such as initial ramdisks for booting Linux don’t
-    have accidental dependencies on other paths in the Nix
-    store.</para></listitem>
+    dependencies on its inputs.  To allow an output to have a runtime
+    dependency on itself, use <literal>"out"</literal> as a list item.
+    This is used in NixOS to check that generated files such as
+    initial ramdisks for booting Linux don’t have accidental
+    dependencies on other paths in the Nix store.</para></listitem>
 
   </varlistentry>