diff options
| author | Shea Levy <shea@shealevy.com> | 2018-03-22T23·12-0400 |
|---|---|---|
| committer | Shea Levy <shea@shealevy.com> | 2018-03-23T11·02-0400 |
| commit | 6856fe62b0a81a948709498ea53d333b69cfeca9 (patch) | |
| tree | 9eeb65f1348dd6b22c0e7e7985ceb8ea809bdfdf /doc/manual/expressions | |
| parent | 2bc6cfe1adc89673626a173ee38ef300588be3d1 (diff) | |
Document fetchGit.
Fixes #1981.
Diffstat (limited to 'doc/manual/expressions')
| -rw-r--r-- | doc/manual/expressions/builtins.xml | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/doc/manual/expressions/builtins.xml b/doc/manual/expressions/builtins.xml index 8a32ed8b5c..47b98460ad 100644 --- a/doc/manual/expressions/builtins.xml +++ b/doc/manual/expressions/builtins.xml @@ -307,6 +307,61 @@ stdenv.mkDerivation { … } </varlistentry> + <varlistentry> + <term> + <function>builtins.fetchGit</function> + <replaceable>args</replaceable> + </term> + + <listitem> + <para> + Fetch a path from git. <replaceable>args</replaceable> can be + a URL, in which case the HEAD of the repo at that URL is + fetched. Otherwise, it can be an attribute with the following + attributes (all except <varname>url</varname> optional): + </para> + + <variablelist> + <varlistentry> + <term>url</term> + <listitem> + <para> + The URL of the repo. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>name</term> + <listitem> + <para> + The name of the directory the repo should be exported to + in the store. Defaults to the basename of the URL. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>rev</term> + <listitem> + <para> + The git revision to fetch. Defaults to the tip of + <varname>ref</varname>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term>ref</term> + <listitem> + <para> + The git ref to look for the requested revision under. + This is often a branch or tag name. Defaults to + <literal>HEAD</literal>. + </para> + </listitem> + </varlistentry> + </variablelist> + </listitem> + </varlistentry> + <varlistentry><term><function>builtins.filter</function> <replaceable>f</replaceable> <replaceable>xs</replaceable></term> |