about summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorEelco Dolstra <eelco.dolstra@logicblox.com>2012-04-17T15·14+0200
committerEelco Dolstra <eelco.dolstra@logicblox.com>2012-04-17T15·14+0200
commit8745fade0387b2900a98b95798d9f12be7ef97ca (patch)
tree2037037a5d863c122cb03fee0e0608a66cc9a290 /doc
parent8cf1719e3e02998c0d22ed9e505a4a98e3335627 (diff)
Added utility command ‘nix-instantiate --find-file’ to look up a file in Nix's search path
Diffstat (limited to 'doc')
-rw-r--r--doc/manual/nix-instantiate.xml14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/manual/nix-instantiate.xml b/doc/manual/nix-instantiate.xml
index a659ee730484..7e6120852f09 100644
--- a/doc/manual/nix-instantiate.xml
+++ b/doc/manual/nix-instantiate.xml
@@ -36,6 +36,7 @@
           <option>--eval-only</option>
           <arg><option>--strict</option></arg>
         </arg>
+        <arg choice='plain'><option>--find-file</option></arg>
       </group>
       <arg><option>--xml</option></arg>
     </arg>
@@ -100,6 +101,19 @@ policies.</para>
     
   </varlistentry>
 
+  <varlistentry><term><option>--find-file</option></term>
+  
+    <listitem><para>Look up the given files in Nix’s search path (as
+    specified by the <envar>NIX_PATH</envar> environment variable).
+    If found, print the corresponding absolute paths on standard
+    output.  For instance, if <envar>NIX_PATH</envar> is
+    <literal>nixpkgs=/home/alice/nixpkgs</literal>, then
+    <literal>nix-instantiate --find-file nixpkgs/default.nix</literal>
+    will print
+    <literal>/home/alice/nixpkgs/default.nix</literal>.</para></listitem>
+    
+  </varlistentry>
+      
   <varlistentry><term><option>--xml</option></term>
 
     <listitem><para>When used with <option>--parse-only</option> and