summaryrefslogtreecommitdiffstats
path: root/doc/functions.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/functions.xml')
-rw-r--r--doc/functions.xml14
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/functions.xml b/doc/functions.xml
index f5fb90921bfa..3850e58c0168 100644
--- a/doc/functions.xml
+++ b/doc/functions.xml
@@ -52,6 +52,20 @@ in ...</programlisting>
It's equivalent to <varname>pkgs</varname> in the above example.
</para>
+ <para>
+ Note that in previous versions of nixpkgs, this method replaced any changes from <link
+ linkend="sec-modify-via-packageOverrides">config.packageOverrides</link>,
+ along with that from previous calls if this function was called repeatedly.
+ Now those previous changes will be preserved so this function can be "chained" meaningfully.
+ To recover the old behavior, make sure <varname>config.packageOverrides</varname> is unset,
+ and call this only once off a "freshly" imported nixpkgs:
+
+ <programlisting>let
+ pkgs = import &lt;nixpkgs&gt; { config: {}; };
+ newpkgs = pkgs.overridePackages ...;
+in ...</programlisting>
+ </para>
+
</section>
<section xml:id="sec-pkg-override">