about summary refs log tree commit diff
path: root/doc/manual/command-ref/nix-prefetch-url.xml
diff options
context:
space:
mode:
authorEelco Dolstra <eelco.dolstra@logicblox.com>2015-10-07T12·55+0200
committerEelco Dolstra <eelco.dolstra@logicblox.com>2015-10-07T12·55+0200
commitf08449ccbd2009b858aae18341aedf3d0829b91a (patch)
tree0a5a9a6fe1a009dd9243db14a0e8f1d302cbf887 /doc/manual/command-ref/nix-prefetch-url.xml
parente4abf8610be3d9f3023a538460f87be8f31bca2d (diff)
nix-prefetch-url: Add --name option
This allows overriding the name component of the resulting Nix store
path, which is necessary if the base name of the URI contains
"illegal" characters.
Diffstat (limited to 'doc/manual/command-ref/nix-prefetch-url.xml')
-rw-r--r--doc/manual/command-ref/nix-prefetch-url.xml12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/manual/command-ref/nix-prefetch-url.xml b/doc/manual/command-ref/nix-prefetch-url.xml
index e1f0c8e5447c..016d8863a94c 100644
--- a/doc/manual/command-ref/nix-prefetch-url.xml
+++ b/doc/manual/command-ref/nix-prefetch-url.xml
@@ -91,6 +91,18 @@ downloaded file in the Nix store is also printed.</para>
 
   </varlistentry>
 
+  <varlistentry><term><option>--name</option></term>
+
+    <listitem><para>Override the name of the file in the Nix store. By
+    default, this is
+    <literal><replaceable>hash</replaceable>-<replaceable>basename</replaceable></literal>,
+    where <replaceable>basename</replaceable> is the last component of
+    <replaceable>url</replaceable>. Overriding the name is necessary
+    when <replaceable>basename</replaceable> contains characters that
+    are not allowed in Nix store paths.</para></listitem>
+
+  </varlistentry>
+
 </variablelist>
 
 </refsection>