aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGraham Christensen <graham@grahamc.com>2018-05-30 08:04:26 -0400
committerGitHub <noreply@github.com>2018-05-30 08:04:26 -0400
commitf9940f47b36df396799d90c3ff691a1ef0c45c35 (patch)
treeae562a56338a7c58130de3b5a3dcc57829ab72c4
parent3c2de9830dfa9e41927c666b7a7083c53886fb89 (diff)
parent8dd2e28374b6b2f995d1c408b24ec9b838f62626 (diff)
Merge pull request #2164 from mickours/doc-fetchTarball-timout
Explain fetchTarball timeout behavior in the doc
-rw-r--r--doc/manual/expressions/builtins.xml11
1 files changed, 10 insertions, 1 deletions
diff --git a/doc/manual/expressions/builtins.xml b/doc/manual/expressions/builtins.xml
index 5489fab00..54f697d85 100644
--- a/doc/manual/expressions/builtins.xml
+++ b/doc/manual/expressions/builtins.xml
@@ -310,8 +310,17 @@ with import (fetchTarball https://github.com/NixOS/nixpkgs-channels/archive/nixo
stdenv.mkDerivation { … }
</programlisting>
+ </para>
+
+ <para>The fetched tarball is cached for a certain amount of time
+ (1 hour by default) in <filename>~/.cache/nix/tarballs/</filename>.
+ You can change the cache timeout either on the command line with
+ <option>--option tarball-ttl <replaceable>number of seconds</replaceable></option> or
+ in the Nix configuration file with this option:
+ <literal>tarball-ttl <replaceable>number of seconds to cache</replaceable></literal>.
+ </para>
- Note that when obtaining the hash with <varname>nix-prefetch-url
+ <para>Note that when obtaining the hash with <varname>nix-prefetch-url
</varname> the option <varname>--unpack</varname> is required.
</para>