[jboss-svn-commits] JBL Code SVN: r28877 - labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/solution.

[jboss-svn-commits at lists.jboss.org]

Author: ge0ffrey
Date: 2009-08-08 04:37:09 -0400 (Sat, 08 Aug 2009)
New Revision: 28877

Modified:
   labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/solution/Solution.java
Log:
javadocs Solution

Modified: labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/solution/Solution.java
===================================================================
--- labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/solution/Solution.java	2009-08-07 21:42:50 UTC (rev 28876)
+++ labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/solution/Solution.java	2009-08-08 08:37:09 UTC (rev 28877)
@@ -3,6 +3,13 @@
 import java.util.Collection;
 
 /**
+ * A Solution represents a problem and a possible solution of that problem.
+ * A possible solution does not need to optimal or even feasible.
+ * A Solution does not even have to be initialized with a possible solution.
+ * <p/>
+ * A Solution is mutable.
+ * Drools-solver will continiously modify the same solution for scalibility reasons
+ * and clone it to recall the best solution.
  * @author Geoffrey De Smet
  */
 public interface Solution {