[jboss-svn-commits] JBL Code SVN: r25954 - labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/localsearch/decider/accepter.

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

Author: ge0ffrey
Date: 2009-04-05 15:04:51 -0400 (Sun, 05 Apr 2009)
New Revision: 25954

Modified:
   labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/localsearch/decider/accepter/AbstractAccepter.java
   labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/localsearch/decider/accepter/Accepter.java
Log:
javadocs (extraction from score_refactor attempt 1 that cannot be committed because its a lot slower)

Modified: labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/localsearch/decider/accepter/AbstractAccepter.java
===================================================================
--- labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/localsearch/decider/accepter/AbstractAccepter.java	2009-04-05 19:03:20 UTC (rev 25953)
+++ labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/localsearch/decider/accepter/AbstractAccepter.java	2009-04-05 19:04:51 UTC (rev 25954)
@@ -6,6 +6,8 @@
 import org.slf4j.LoggerFactory;
 
 /**
+ * Abstract superclass for {@link Accepter}.
+ * @see Accepter
  * @author Geoffrey De Smet
  */
 public abstract class AbstractAccepter implements Accepter {

Modified: labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/localsearch/decider/accepter/Accepter.java
===================================================================
--- labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/localsearch/decider/accepter/Accepter.java	2009-04-05 19:03:20 UTC (rev 25953)
+++ labs/jbossrules/trunk/drools-solver/drools-solver-core/src/main/java/org/drools/solver/core/localsearch/decider/accepter/Accepter.java	2009-04-05 19:04:51 UTC (rev 25954)
@@ -4,9 +4,9 @@
 import org.drools.solver.core.localsearch.decider.MoveScope;
 
 /**
- * Accepts or rejects a selected move that could be the next step.
- * Notice that it's the forager which makes the actual decision.
- * Always extend {@link AbstractAccepter} to avoid future backwards imcompatiblity issues.
+ * An Accepter accepts or rejects a selected move for the Decider.
+ * Notice that the Forager can still ignore the advice of the Accepter.
+ * @see AbstractAccepter
  * @author Geoffrey De Smet
  */
 public interface Accepter extends LocalSearchSolverLifecycleListener {