Skip to content

Commit

Permalink
manual: include builtins.* for globally available builtins
Browse files Browse the repository at this point in the history
This improves searchability.
  • Loading branch information
lheckemann committed Mar 21, 2019
1 parent ffeabf8 commit 6f09307
Showing 1 changed file with 17 additions and 0 deletions.
17 changes: 17 additions & 0 deletions doc/manual/expressions/builtins.xml
Expand Up @@ -23,6 +23,7 @@ available as <function>builtins.derivation</function>.</para>

<varlistentry xml:id='builtin-abort'>
<term><function>abort</function> <replaceable>s</replaceable></term>
<term><function>builtins.abort</function> <replaceable>s</replaceable></term>

<listitem><para>Abort Nix expression evaluation, print error
message <replaceable>s</replaceable>.</para></listitem>
Expand Down Expand Up @@ -251,6 +252,8 @@ if builtins ? getEnv then builtins.getEnv "PATH" else ""</programlisting>
<varlistentry xml:id='builtin-derivation'>
<term><function>derivation</function>
<replaceable>attrs</replaceable></term>
<term><function>builtins.derivation</function>
<replaceable>attrs</replaceable></term>

<listitem><para><function>derivation</function> is described in
<xref linkend='ssec-derivation' />.</para></listitem>
Expand All @@ -260,6 +263,7 @@ if builtins ? getEnv then builtins.getEnv "PATH" else ""</programlisting>

<varlistentry xml:id='builtin-dirOf'>
<term><function>dirOf</function> <replaceable>s</replaceable></term>
<term><function>builtins.dirOf</function> <replaceable>s</replaceable></term>

<listitem><para>Return the directory part of the string
<replaceable>s</replaceable>, that is, everything before the final
Expand Down Expand Up @@ -318,6 +322,8 @@ if builtins ? getEnv then builtins.getEnv "PATH" else ""</programlisting>
<varlistentry xml:id='builtin-fetchTarball'>
<term><function>fetchTarball</function>
<replaceable>url</replaceable></term>
<term><function>builtins.fetchTarball</function>
<replaceable>url</replaceable></term>

<listitem><para>Download the specified URL, unpack it and return
the path of the unpacked tree. The file must be a tape archive
Expand Down Expand Up @@ -714,6 +720,8 @@ builtins.genList (x: x * x) 5
<varlistentry xml:id='builtin-import'>
<term><function>import</function>
<replaceable>path</replaceable></term>
<term><function>builtins.import</function>
<replaceable>path</replaceable></term>

<listitem><para>Load, parse and return the Nix expression in the
file <replaceable>path</replaceable>. If <replaceable>path
Expand Down Expand Up @@ -857,6 +865,8 @@ x: x + 456</programlisting>
<varlistentry xml:id='builtin-isNull'>
<term><function>isNull</function>
<replaceable>e</replaceable></term>
<term><function>builtins.isNull</function>
<replaceable>e</replaceable></term>

<listitem><para>Return <literal>true</literal> if
<replaceable>e</replaceable> evaluates to <literal>null</literal>,
Expand Down Expand Up @@ -925,6 +935,8 @@ builtins.listToAttrs
<varlistentry xml:id='builtin-map'>
<term><function>map</function>
<replaceable>f</replaceable> <replaceable>list</replaceable></term>
<term><function>builtins.map</function>
<replaceable>f</replaceable> <replaceable>list</replaceable></term>

<listitem><para>Apply the function <replaceable>f</replaceable> to
each element in the list <replaceable>list</replaceable>. For
Expand Down Expand Up @@ -1119,6 +1131,8 @@ Evaluates to <literal>[ "foo" ]</literal>.
<varlistentry xml:id='builtin-removeAttrs'>
<term><function>removeAttrs</function>
<replaceable>set</replaceable> <replaceable>list</replaceable></term>
<term><function>builtins.removeAttrs</function>
<replaceable>set</replaceable> <replaceable>list</replaceable></term>

<listitem><para>Remove the attributes listed in
<replaceable>list</replaceable> from
Expand Down Expand Up @@ -1287,6 +1301,8 @@ builtins.substring 0 3 "nixos"
<varlistentry xml:id='builtin-throw'>
<term><function>throw</function>
<replaceable>s</replaceable></term>
<term><function>builtins.throw</function>
<replaceable>s</replaceable></term>

<listitem><para>Throw an error message
<replaceable>s</replaceable>. This usually aborts Nix expression
Expand Down Expand Up @@ -1405,6 +1421,7 @@ in foo</programlisting>

<varlistentry xml:id='builtin-toString'>
<term><function>toString</function> <replaceable>e</replaceable></term>
<term><function>builtins.toString</function> <replaceable>e</replaceable></term>

<listitem><para>Convert the expression
<replaceable>e</replaceable> to a string.
Expand Down

0 comments on commit 6f09307

Please sign in to comment.