Skip to content

Document import <path> syntax #3159

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
edolstra merged 4 commits into from
Oct 23, 2019
Merged

Document import <path> syntax #3159

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
d8730fb
Document import <path> syntax
ersinakinci Oct 21, 2019
9be7787
Revert "Document import <path> syntax"
ersinakinci Oct 21, 2019
b7a9362
Add hint about path in builtins.import
ersinakinci Oct 21, 2019
f107a27
Tweak path hint
ersinakinci Oct 21, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions doc/manual/expressions/builtins.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -746,6 +746,11 @@ builtins.genList (x: x * x) 5
separate file, and use it from Nix expressions in other
files.</para>

<note><para>Unlike some languages, <function>import</function> is a regular
function in Nix. Paths using the angle bracket syntax (e.g., <function>
import</function> <replaceable>&lt;foo&gt;</replaceable>) are normal path
values (see <xref linkend='ssec-values' />).</para></note>

<para>A Nix expression loaded by <function>import</function> must
not contain any <emphasis>free variables</emphasis> (identifiers
that are not defined in the Nix expression itself and are not
Expand Down