From 1e7f572683fd34b55fade0eff632a70a720f0477 Mon Sep 17 00:00:00 2001
From: Peter Simons <simons@cryp.to>
Date: Tue, 16 Aug 2011 13:03:46 +0000
Subject: [PATCH] pkgs/misc/misc.nix: document the fact that 'collection' does
 not detect file collisions

svn path=/nixpkgs/trunk/; revision=28610
---
 pkgs/misc/misc.nix | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/pkgs/misc/misc.nix b/pkgs/misc/misc.nix
index a0b13751f717..85959f66a7fe 100644
--- a/pkgs/misc/misc.nix
+++ b/pkgs/misc/misc.nix
@@ -6,18 +6,20 @@ in
 
 {
 
-  /* 
+  /*
+    Usage example creating a derivation installing ruby, sup and a lib:
 
-    usage example creating a derivation installing ruby, sup and a lib:
-
-    packageOverrides = {
-      rubyCollection = collection {
-        name = "ruby";
-        list = let l = rubyLibs; in 
-          [ pkgs.ruby l.chronic l.sup ];
-      };
-    }
+      packageOverrides = {
+	rubyCollection = collection {
+	  name = "ruby";
+	  list = let l = rubyLibs; in
+	    [ pkgs.ruby l.chronic l.sup ];
+	};
+      }
 
+    Warning: Using this function, it is possible to install packages
+    into one profile that have file collisions, and these will not be
+    detected.
   */
   collection = {list, name} : runCommand "collection-${name}" {} ''
     mkdir -p $out/nix-support