docs(nix-1p): explain scope of with
This fixes https://github.com/tazjin/nix-1p/issues/13 Due to with's use of a semicolon instead of some kind of bracing statement, people can get confused about what the scope of a `with` is. Hopefully this change should make it more explicit. Change-Id: Ifaff28e09a2e8b8b244a9c11d44b2780dee284ee Reviewed-on: https://cl.tvl.fyi/c/depot/+/8951 Tested-by: BuildkiteCI Reviewed-by: sterni <sternenseemann@systemli.org>
This commit is contained in:
parent
f9fbc9be85
commit
9f762bf623
1 changed files with 8 additions and 0 deletions
|
@ -326,6 +326,14 @@ let attrs = { a = 15; b = 2; };
|
|||
in with attrs; a + b # 'a' and 'b' become variables in the scope following 'with'
|
||||
```
|
||||
|
||||
The scope of a `with`-"block" is the expression immediately following the
|
||||
semicolon, i.e.:
|
||||
|
||||
```nix
|
||||
let attrs = { /* some attributes */ };
|
||||
in with attrs; (/* this is the scope of the `with` */)
|
||||
```
|
||||
|
||||
## `import` / `NIX_PATH` / `<entry>`
|
||||
|
||||
Nix files can import each other by using the builtin `import` function and a
|
||||
|
|
Loading…
Reference in a new issue