diff --git a/src/main/java/org/apache/commons/math/optimization/BaseMultivariateRealOptimizer.java b/src/main/java/org/apache/commons/math/optimization/BaseMultivariateRealOptimizer.java
index 5cffa911a..affd19318 100644
--- a/src/main/java/org/apache/commons/math/optimization/BaseMultivariateRealOptimizer.java
+++ b/src/main/java/org/apache/commons/math/optimization/BaseMultivariateRealOptimizer.java
@@ -64,9 +64,9 @@ public interface BaseMultivariateRealOptimizerOptimization algorithms find the input point set that either {@link GoalType
- * maximize or minimize} an objective function.
+ * This interface represents an optimization algorithm for
+ * {@link DifferentiableMultivariateRealFunction scalar differentiable objective
+ * functions}.
+ * Optimization algorithms find the input point set that either {@link GoalType
+ * maximize or minimize} an objective function.
+ *
* @see MultivariateRealOptimizer
* @see DifferentiableMultivariateVectorialOptimizer
* @version $Revision$ $Date$
@@ -35,8 +37,8 @@ public interface DifferentiableMultivariateRealOptimizer
/**
* Get the number of evaluations of the objective function gradient.
* The number of evaluations corresponds to the last call to the
- * {@link #optimize(DifferentiableMultivariateRealFunction, GoalType, double[]) optimize}
- * method. It is 0 if the method has not been called yet.
+ * {@code optimize} method (see {@link BaseMultivariateRealOptimizer}).
+ * It is 0 if the method has not been called yet.
*
* @return the number of evaluations of the objective function gradient.
*/
diff --git a/src/main/java/org/apache/commons/math/optimization/general/AbstractScalarDifferentiableOptimizer.java b/src/main/java/org/apache/commons/math/optimization/general/AbstractScalarDifferentiableOptimizer.java
index 2094ec0be..07d57df08 100644
--- a/src/main/java/org/apache/commons/math/optimization/general/AbstractScalarDifferentiableOptimizer.java
+++ b/src/main/java/org/apache/commons/math/optimization/general/AbstractScalarDifferentiableOptimizer.java
@@ -70,7 +70,7 @@ public abstract class AbstractScalarDifferentiableOptimizer
*/
protected AbstractScalarDifferentiableOptimizer() {}
/**
- * @param convergenceChecker Convergence checker.
+ * @param checker Convergence checker.
* @param maxIterations Maximum number of iterations.
* @param maxEvaluations Maximum number of evaluations.
*/
diff --git a/src/main/java/org/apache/commons/math/optimization/general/AbstractScalarOptimizer.java b/src/main/java/org/apache/commons/math/optimization/general/AbstractScalarOptimizer.java
index d4e2a122a..7b3b827ab 100644
--- a/src/main/java/org/apache/commons/math/optimization/general/AbstractScalarOptimizer.java
+++ b/src/main/java/org/apache/commons/math/optimization/general/AbstractScalarOptimizer.java
@@ -48,7 +48,7 @@ public abstract class AbstractScalarOptimizer
*/
protected AbstractScalarOptimizer() {}
/**
- * @param convergenceChecker Convergence checker.
+ * @param checker Convergence checker.
* @param maxIterations Maximum number of iterations.
* @param maxEvaluations Maximum number of evaluations.
*/
diff --git a/src/main/java/org/apache/commons/math/optimization/general/BaseAbstractScalarOptimizer.java b/src/main/java/org/apache/commons/math/optimization/general/BaseAbstractScalarOptimizer.java
index 89927c111..89d72c4e6 100644
--- a/src/main/java/org/apache/commons/math/optimization/general/BaseAbstractScalarOptimizer.java
+++ b/src/main/java/org/apache/commons/math/optimization/general/BaseAbstractScalarOptimizer.java
@@ -78,7 +78,7 @@ public abstract class BaseAbstractScalarOptimizer