From ae7e893de1c03564b40f8e6d1d9591bbc1082cc9 Mon Sep 17 00:00:00 2001
From: "Nicolas B. Pierron" <nicolas.b.pierron@nbp.name>
Date: Sat, 14 Jan 2017 14:15:55 +0000
Subject: [PATCH] Improve the realse notes with the upcoming documentation
 links, and a better example of how to convert overridePackages usage.

---
 nixos/doc/manual/release-notes/rl-1703.xml | 32 ++++++++++++++++++----
 1 file changed, 26 insertions(+), 6 deletions(-)

diff --git a/nixos/doc/manual/release-notes/rl-1703.xml b/nixos/doc/manual/release-notes/rl-1703.xml
index 3ee38f9a76c..d6b3aeb9791 100644
--- a/nixos/doc/manual/release-notes/rl-1703.xml
+++ b/nixos/doc/manual/release-notes/rl-1703.xml
@@ -11,9 +11,9 @@ has the following highlights: </para>
 
 <itemizedlist>
   <listitem>
-    <para>Nixpkgs is now extensible through <link
-    xlink:href="https://github.com/NixOS/nixpkgs/pull/21243">overlays</link>.
-    See the Nixpkgs manual for more information.</para>
+    <para>Nixpkgs is now extensible through overlays. See the <link
+    xlink:href="https://nixos.org/nixpkgs/manual/#sec-overlays-install">Nixpkgs
+    manual</link> for more information.</para>
   </listitem>
 </itemizedlist>
 
@@ -100,9 +100,29 @@ following incompatible changes:</para>
   </listitem>
 
   <listitem>
-    <para><literal>pkgs.overridePackages</literal> function no longer exists.
-     Instead import Nixpkgs a second time using <literal>import pkgs.path {
-    overlays = [ <replaceable>...</replaceable> ]; }</literal>.</para>
+
+    <para><literal>overridePackages</literal> function no longer exists.
+    It is replaced by <link
+    xlink:href="https://nixos.org/nixpkgs/manual/#sec-overlays-install">
+    overlays</link>.  For example, the following code:
+
+<programlisting>
+  let
+    pkgs = import &lt;nixpkgs&gt {};
+  in
+    pkgs.overridePackages (self: super: ...)
+</programlisting>
+
+    Should be replaced by:
+
+<programlisting>
+  let
+    pkgs = import &lt;nixpkgs&gt {}; in
+  in
+    import pkgs.path { overlays = [(self: super: ...)] }
+</programlisting>
+
+    </para>
   </listitem>
 </itemizedlist>