summary refs log tree commit diff
path: root/nixos
diff options
context:
space:
mode:
authorEmmanuel Rosa <emmanuelrosa@users.noreply.github.com>2017-06-02 20:58:41 -0400
committerGraham Christensen <graham@grahamc.com>2017-06-02 21:13:19 -0400
commit4bee34dcc5e6886aac8c868410f12a670da03062 (patch)
tree5ee16776d2d51f223a8dc6e77dae640f26061441 /nixos
parent4576e8dddd17fd8c25aa02a917e89982cf7e3e37 (diff)
downloadnixlib-4bee34dcc5e6886aac8c868410f12a670da03062.tar
nixlib-4bee34dcc5e6886aac8c868410f12a670da03062.tar.gz
nixlib-4bee34dcc5e6886aac8c868410f12a670da03062.tar.bz2
nixlib-4bee34dcc5e6886aac8c868410f12a670da03062.tar.lz
nixlib-4bee34dcc5e6886aac8c868410f12a670da03062.tar.xz
nixlib-4bee34dcc5e6886aac8c868410f12a670da03062.tar.zst
nixlib-4bee34dcc5e6886aac8c868410f12a670da03062.zip
doc: clarify building-nixos CD/DVD instructions
This change updates the instructions for building a NixOS ISO so that it's clear how to do it.

Previously, the instructions stated to set NIXOS_CONFIG prior to running `nix-build`, yet the example provided by-passed NIXOS_CONFIG anyway. But the *really* important missing piece is the need for nixos/default.nix. See #21840.

This change removes the NIXOS_CONFIG verbiage, and adds steps to clone nixpkgs and (most importantly) cd'ing into nixpkgs/nixos. That way, the reader may think: *Oh, so I need a default.nix and a configuration.nix. Ahhh, OK.*

I purposely added the redundant default.nix argument.
Diffstat (limited to 'nixos')
-rw-r--r--nixos/doc/manual/development/building-nixos.xml8
1 files changed, 4 insertions, 4 deletions
diff --git a/nixos/doc/manual/development/building-nixos.xml b/nixos/doc/manual/development/building-nixos.xml
index 150fa1d7017e..2f963f8666f1 100644
--- a/nixos/doc/manual/development/building-nixos.xml
+++ b/nixos/doc/manual/development/building-nixos.xml
@@ -12,12 +12,12 @@ your <filename>configuration.nix</filename> to configure the system that
 would be installed on the CD.</para>
 
 <para>Default CD/DVD configurations are available
-inside <filename>nixos/modules/installer/cd-dvd</filename>.  To build them
-you have to set <envar>NIXOS_CONFIG</envar> before
-running <command>nix-build</command> to build the ISO.
+inside <filename>nixos/modules/installer/cd-dvd</filename>.
 
 <screen>
-$ nix-build -A config.system.build.isoImage -I nixos-config=modules/installer/cd-dvd/installation-cd-minimal.nix</screen>
+$ git clone https://github.com/NixOS/nixpkgs.git
+$ cd nixpkgs/nixos
+$ nix-build -A config.system.build.isoImage -I nixos-config=modules/installer/cd-dvd/installation-cd-minimal.nix default.nix</screen>
 
 </para>