about summary refs log tree commit diff
path: root/nixos/doc/manual/release-notes/rl-2009.xml
diff options
context:
space:
mode:
authorGraham Christensen <graham@grahamc.com>2020-04-12 08:56:11 -0400
committerGitHub <noreply@github.com>2020-04-12 08:56:11 -0400
commit35d8514a9149699cfbf3fe81d62f7b9f59dc2e7e (patch)
tree3912c62ccc188a62fe7a0bcc1205c02575ad05d5 /nixos/doc/manual/release-notes/rl-2009.xml
parent99b5068c263b09e5c401e5d677ba57c470aec702 (diff)
parentec2d28e3233c4c04fe6afe13e828691d099167ae (diff)
downloadnixlib-35d8514a9149699cfbf3fe81d62f7b9f59dc2e7e.tar
nixlib-35d8514a9149699cfbf3fe81d62f7b9f59dc2e7e.tar.gz
nixlib-35d8514a9149699cfbf3fe81d62f7b9f59dc2e7e.tar.bz2
nixlib-35d8514a9149699cfbf3fe81d62f7b9f59dc2e7e.tar.lz
nixlib-35d8514a9149699cfbf3fe81d62f7b9f59dc2e7e.tar.xz
nixlib-35d8514a9149699cfbf3fe81d62f7b9f59dc2e7e.tar.zst
nixlib-35d8514a9149699cfbf3fe81d62f7b9f59dc2e7e.zip
Merge pull request #81848 from grahamc/nested-specialisation
specialisation: replace nesting with named configurations
Diffstat (limited to 'nixos/doc/manual/release-notes/rl-2009.xml')
-rw-r--r--nixos/doc/manual/release-notes/rl-2009.xml44
1 files changed, 44 insertions, 0 deletions
diff --git a/nixos/doc/manual/release-notes/rl-2009.xml b/nixos/doc/manual/release-notes/rl-2009.xml
index cf7946ffb807..4965f9c36297 100644
--- a/nixos/doc/manual/release-notes/rl-2009.xml
+++ b/nixos/doc/manual/release-notes/rl-2009.xml
@@ -203,6 +203,50 @@ environment.systemPackages = [
       <link xlink:href="https://github.com/gollum/gollum/wiki/5.0-release-notes#migrating-your-wiki">here</link>.
      </para>
    </listitem>
+
+   <listitem>
+    <para>
+      The NixOS options <literal>nesting.clone</literal> and
+      <literal>nesting.children</literal> have been deleted, and
+      replaced with named <xref linkend="opt-specialisation"/>
+      configurations.
+    </para>
+
+    <para>
+      Replace a <literal>nesting.clone</literal> entry with:
+
+<programlisting>{
+<link xlink:href="#opt-specialisation">specialisation.example-sub-configuration</link> = {
+  <link xlink:href="#opt-specialisation._name_.configuration">configuration</link> = {
+    ...
+  };
+};</programlisting>
+
+    </para>
+    <para>
+      Replace a <literal>nesting.children</literal> entry with:
+
+<programlisting>{
+<link xlink:href="#opt-specialisation">specialisation.example-sub-configuration</link> = {
+  <link xlink:href="#opt-specialisation._name_.inheritParentConfig">inheritParentConfig</link> = false;
+  <link xlink:href="#opt-specialisation._name_.configuration">configuration</link> = {
+    ...
+  };
+};</programlisting>
+    </para>
+
+    <para>
+     To switch to a specialised configuration at runtime you need to
+     run:
+<programlisting>
+# sudo /run/current-system/specialisation/example-sub-configuration/bin/switch-to-configuration test
+</programlisting>
+     Before you would have used:
+<programlisting>
+# sudo /run/current-system/fine-tune/child-1/bin/switch-to-configuration test
+</programlisting>
+    </para>
+   </listitem>
   </itemizedlist>
  </section>