159/376: Document the "out" usage in allowedReferences

[Ludovic Courtès]

civodul pushed a commit to tag 1.8
in repository guix.

commit 4b0a720ddf05ba03c7ea94dc38bd5ec0ab1285dd
Author: Gergely Risko <address@hidden>
Date:   Thu Aug 21 23:46:28 2014 +0200

    Document the "out" usage in allowedReferences
---
 doc/manual/writing-nix-expressions.xml |    9 +++++----
 1 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/doc/manual/writing-nix-expressions.xml 
b/doc/manual/writing-nix-expressions.xml
index 6db2adc..0470625 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>