Skip to content

Commit 916da45

Browse files
authored
Merge pull request #8319 from fricklerhandwerk/doc-builtins-prefix
reword introduction to built-in functions
2 parents 491fabd + 70eb9c7 commit 916da45

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed
Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
# Built-in Functions
22

3-
This section lists the functions built into the Nix expression
4-
evaluator. (The built-in function `derivation` is discussed above.)
5-
Some built-ins, such as `derivation`, are always in scope of every Nix
6-
expression; you can just access them right away. But to prevent
7-
polluting the namespace too much, most built-ins are not in
8-
scope. Instead, you can access them through the `builtins` built-in
9-
value, which is a set that contains all built-in functions and values.
10-
For instance, `derivation` is also available as `builtins.derivation`.
3+
This section lists the functions built into the Nix language evaluator.
4+
All built-in functions are available through the global [`builtins`](./builtin-constants.md#builtins-builtins) constant.
5+
6+
For convenience, some built-ins are can be accessed directly:
7+
8+
- [`derivation`](#builtins-derivation)
9+
- [`import`](#builtins-import)
10+
- [`abort`](#builtins-abort)
11+
- [`throw`](#builtins-throw)
1112

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

0 commit comments

Comments
 (0)