maurice/snix
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

builtins.fetchGit: document absolute ref support

Browse source
This commit is contained in:
Graham Christensen 2019-07-02 09:04:04 -04:00
parent 7e35e914c1
commit c8205a3413
No known key found for this signature in database
GPG key ID: ACA1C1D120C83D5C
3 changed files with 38 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

15
doc/manual/expressions/builtins.xml
View file

@ -419,6 +419,13 @@ stdenv.mkDerivation { … }
This is often a branch or tag name. Defaults to
<literal>HEAD</literal>.
</para>
<para>
By default, the <varname>ref</varname> value is prefixed
with <literal>refs/heads/</literal>. As of Nix 2.3.0
Nix will not prefix <literal>refs/heads/</literal> if
<varname>ref</varname> starts with <literal>refs/</literal>.
</para>
</listitem>
</varlistentry>
</variablelist>
@ -432,6 +439,14 @@ stdenv.mkDerivation { … }
}</programlisting>
</example>
<example>
<title>Fetching an arbitrary ref</title>
<programlisting>builtins.fetchGit {
url = "https://gitub.com/NixOS/nix.git";
ref = "refs/heads/0.5-release";
}</programlisting>
</example>
<example>
<title>Fetching a repository's specific commit on an arbitrary branch</title>
<para>