Javadoc.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/math/trunk@1427025 13f79535-47bb-0310-9956-ffa450edef68

src/main/java/org/apache/commons/math3/optim/BaseOptimizer.java

@@ -104,6 +104,14 @@ public abstract class BaseOptimizer<PAIR> {
 
     /**
      * Stores data and performs the optimization.
+     * <br/>
+     * The list of parameters is open-ended so that sub-classes can extend it
+     * with arguments specific to their concrete implementations.
+     * <br/>
+     * When the method is called multiple times, instance data is overwritten
+     * only when actually present in the list of arguments: when not specified,
+     * data set in a previous call is retained (and thus is optional in
+     * subsequent calls).
      *
      * @param optData Optimization data. The following data will be looked for:
      * <ul>