about summary refs log tree commit diff
diff options
context:
space:
mode:
authorErsin Akinci <me@ersinakinci.com>2019-10-21T21·11-0700
committerEelco Dolstra <edolstra@gmail.com>2020-01-04T13·10+0100
commite9c0c772b02d73436519f5cf5b53157da372cbfb (patch)
treed7fb28ef1adeb18aedcf27927e29f917002a0f84
parent1ea63a5931981070500a26ccc241375699f1e41b (diff)
Add hint about path in builtins.import
(cherry picked from commit b7a936224ee6e1ad9c842f618bbd5bc1864ebd54)
-rw-r--r--doc/manual/expressions/builtins.xml4
1 files changed, 4 insertions, 0 deletions
diff --git a/doc/manual/expressions/builtins.xml b/doc/manual/expressions/builtins.xml
index 465fa1e0b001..8b53cd57854f 100644
--- a/doc/manual/expressions/builtins.xml
+++ b/doc/manual/expressions/builtins.xml
@@ -746,6 +746,10 @@ 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
+    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