From 78f090c82919d42643a7b3afe63d336461337ff9 Mon Sep 17 00:00:00 2001
From: Ivan Kozik <ivan@ludios.org>
Date: Sun, 11 Aug 2013 07:42:03 +0000
Subject: [PATCH] Explain how to use /my/sources with nix-env, not just
 nixos-rebuild

---
 doc/manual/development.xml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/doc/manual/development.xml b/doc/manual/development.xml
index 95c1848e3871..17d7103e0d49 100644
--- a/doc/manual/development.xml
+++ b/doc/manual/development.xml
@@ -48,6 +48,25 @@ $ nixos-rebuild switch -I <replaceable>/my/sources</replaceable>
 
 </para>
 
+<para><command>nixos-rebuild</command> affects only the system profile.
+To install packages to your user profile from expressions in
+<replaceable>/my/sources</replaceable>, use
+<command>nix-env -f <replaceable>/my/sources</replaceable>/nixpkgs</command>,
+or change the default by replacing the symlink in
+<filename>~/.nix-defexpr</filename>:
+
+<screen>
+$ rm -f ~/.nix-defexpr/channels
+$ ln -s <replaceable>/my/sources</replaceable>/nixpkgs ~/.nix-defexpr/nixpkgs
+</screen>
+
+</para>
+
+<para>You should not pass the base directory
+<filename><replaceable>/my/sources</replaceable></filename>
+to <command>nix-env</command>, as it will break after interpreting expressions
+in <filename>nixos/</filename> as packages.</para>
+
 </section>