diff options
author | Jörg Thalheim <Mic92@users.noreply.github.com> | 2019-01-21 10:47:59 +0000 |
---|---|---|
committer | GitHub <noreply@github.com> | 2019-01-21 10:47:59 +0000 |
commit | 86ef9a7766b072a767919882e71c8f009ca5f255 (patch) | |
tree | 225db7c393710de9b010932b8b805d2a31aad612 /doc | |
parent | de3b2d1753e99bc2c456fb08be015842aefb35b4 (diff) | |
parent | eac6797380af1f0927ab683e2375429826d34e76 (diff) |
Merge pull request #53934 from Mic92/prefer-fetch-remote
prefer-fetch-remote: an overlay to fetch on remote builders
Diffstat (limited to 'doc')
-rw-r--r-- | doc/functions.xml | 1 | ||||
-rw-r--r-- | doc/functions/prefer-remote-fetch.xml | 27 |
2 files changed, 28 insertions, 0 deletions
diff --git a/doc/functions.xml b/doc/functions.xml index 4193bb49f77a6..e6d59ebde978f 100644 --- a/doc/functions.xml +++ b/doc/functions.xml @@ -14,4 +14,5 @@ <xi:include href="functions/fhs-environments.xml" /> <xi:include href="functions/shell.xml" /> <xi:include href="functions/dockertools.xml" /> + <xi:include href="functions/prefer-remote-fetch.xml" /> </chapter> diff --git a/doc/functions/prefer-remote-fetch.xml b/doc/functions/prefer-remote-fetch.xml new file mode 100644 index 0000000000000..85f08f4eae146 --- /dev/null +++ b/doc/functions/prefer-remote-fetch.xml @@ -0,0 +1,27 @@ +<section xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns:xi="http://www.w3.org/2001/xinclude" + xml:id="sec-prefer-remote-fetch"> + <title>prefer-remote-fetch overlay</title> + + <para> + <function>prefer-remote-fetch</function> is an overlay that download sources + on remote builder. This is useful when the evaluating machine has a slow + upload while the builder can fetch faster directly from the source. + To use it, put the following snippet as a new overlay: + <programlisting> + self: super: + (super.prefer-remote-fetch self super) + </programlisting> + + A full configuration example for that sets the overlay up for your own account, + could look like this + + <programlisting> + $ mkdir ~/.config/nixpkgs/overlays/ + $ cat > ~/.config/nixpkgs/overlays/prefer-remote-fetch.nix <<EOF + self: super: super.prefer-remote-fetch self super + EOF + </programlisting> + </para> +</section> |