diff options
| author | Eelco Dolstra <eelco.dolstra@logicblox.com> | 2018-03-27T13·57+0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2018-03-27T13·57+0200 |
| commit | e01c01f72ce40996234a4a1ded43fac894ddd6dd (patch) | |
| tree | f142c6d82d64c5e089825a50ca5042605889404e | |
| parent | 7ec13eda9bf501c2619a147097d68a9849e3334d (diff) | |
| parent | 6856fe62b0a81a948709498ea53d333b69cfeca9 (diff) | |
Merge pull request #2005 from shlevy/fetchgit-docs
Document fetchGit.
| -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 8a32ed8b5c99..47b98460adf6 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> |