ADD minor doc

src/dn/Lib.hx

@@ -358,24 +358,28 @@ class Lib {
 		if (total<=0 || nbStacks<=0)
 			return new Array();
 
+		// Spreading would overflow all maxStackValues
 		if( maxStackValue!=null && total/nbStacks>maxStackValue ) {
 			var a = [];
 			for(i in 0...nbStacks)
 				a.push(maxStackValue);
 			return a;
 		}
 
+		// Too many stacks
 		if( nbStacks>total ) {
 			var a = [];
 			for(i in 0...total)
 				a.push(1);
 			return a;
 		}
 
+		// Ensure we have at least one in each stack
 		var plist = new Array();
 		for (i in 0...nbStacks)
 			plist[i] = 1;
 
+		// Spread the rest
 		var remain = total-plist.length;
 		while (remain>0) {
 			var move = M.ceil(total*(randFunc(8)+1)/100);