Skip to content

Commit

Permalink
Merge pull request #8319 from fricklerhandwerk/doc-builtins-prefix
Browse files Browse the repository at this point in the history
reword introduction to built-in functions
  • Loading branch information
thufschmitt authored May 12, 2023
2 parents 491fabd + 70eb9c7 commit 916da45
Showing 1 changed file with 10 additions and 10 deletions.
20 changes: 10 additions & 10 deletions doc/manual/src/language/builtins-prefix.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
# Built-in Functions

This section lists the functions built into the Nix expression
evaluator. (The built-in function `derivation` is discussed above.)
Some built-ins, such as `derivation`, are always in scope of every Nix
expression; you can just access them right away. But to prevent
polluting the namespace too much, most built-ins are not in
scope. Instead, you can access them through the `builtins` built-in
value, which is a set that contains all built-in functions and values.
For instance, `derivation` is also available as `builtins.derivation`.
This section lists the functions built into the Nix language evaluator.
All built-in functions are available through the global [`builtins`](./builtin-constants.md#builtins-builtins) constant.

For convenience, some built-ins are can be accessed directly:

- [`derivation`](#builtins-derivation)
- [`import`](#builtins-import)
- [`abort`](#builtins-abort)
- [`throw`](#builtins-throw)

<dl>
<dt><code>derivation <var>attrs</var></code>;
<code>builtins.derivation <var>attrs</var></code></dt>
<dt id="builtins-derivation"><a href="#builtins-derivation"><code>derivation <var>attrs</var></code></a></dt>
<dd><p><var>derivation</var> is described in
<a href="derivations.md">its own section</a>.</p></dd>

0 comments on commit 916da45

Please sign in to comment.