You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ra...@apache.org on 2017/05/13 14:41:04 UTC

[01/15] [math] Fix javadoc issues

Repository: commons-math
Updated Branches:
  refs/heads/master 44b2b2c1b -> cec35baf0


Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/5976c9e4
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/5976c9e4
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/5976c9e4

Branch: refs/heads/master
Commit: 5976c9e44503a8eb2d384a5e551a245efbb643bc
Parents: 44b2b2c
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 09:08:59 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 09:08:59 2017 -0400

----------------------------------------------------------------------
 .../math4/distribution/AbstractIntegerDistribution.java |  2 +-
 .../math4/distribution/EmpiricalDistribution.java       | 12 ++++++------
 .../math4/distribution/EnumeratedDistribution.java      |  4 ++--
 .../commons/math4/distribution/GammaDistribution.java   |  2 +-
 .../commons/math4/distribution/IntegerDistribution.java |  8 ++++----
 .../commons/math4/distribution/LevyDistribution.java    |  4 ++--
 .../commons/math4/distribution/RealDistribution.java    |  8 ++++----
 .../commons/math4/distribution/ZipfDistribution.java    |  2 +-
 8 files changed, 21 insertions(+), 21 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/5976c9e4/src/main/java/org/apache/commons/math4/distribution/AbstractIntegerDistribution.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/distribution/AbstractIntegerDistribution.java b/src/main/java/org/apache/commons/math4/distribution/AbstractIntegerDistribution.java
index add433e..86ecdf9 100644
--- a/src/main/java/org/apache/commons/math4/distribution/AbstractIntegerDistribution.java
+++ b/src/main/java/org/apache/commons/math4/distribution/AbstractIntegerDistribution.java
@@ -117,7 +117,7 @@ public abstract class AbstractIntegerDistribution implements IntegerDistribution
      * #inverseCumulativeProbability(double)}. It assumes {@code 0 < p < 1} and
      * that the inverse cumulative probability lies in the bracket {@code
      * (lower, upper]}. The implementation does simple bisection to find the
-     * smallest {@code p}-quantile <code>inf{x in Z | P(X<=x) >= p}</code>.
+     * smallest {@code p}-quantile {@code inf{x in Z | P(X<=x) >= p}}.
      *
      * @param p the cumulative probability
      * @param lower a value satisfying {@code cumulativeProbability(lower) < p}

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5976c9e4/src/main/java/org/apache/commons/math4/distribution/EmpiricalDistribution.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/distribution/EmpiricalDistribution.java b/src/main/java/org/apache/commons/math4/distribution/EmpiricalDistribution.java
index 567c7c2..471b19e 100644
--- a/src/main/java/org/apache/commons/math4/distribution/EmpiricalDistribution.java
+++ b/src/main/java/org/apache/commons/math4/distribution/EmpiricalDistribution.java
@@ -60,7 +60,7 @@ import org.apache.commons.math4.util.MathUtils;
  * Applications can use <code>EmpiricalDistribution</code> to build grouped
  * frequency histograms representing the input data or to generate random values
  * "like" those in the input file -- i.e., the values generated will follow the
- * distribution of the values in the file.</p>
+ * distribution of the values in the file.
  *
  * <p>The implementation uses what amounts to the
  * <a href="http://nedwww.ipac.caltech.edu/level5/March02/Silverman/Silver2_6.html">
@@ -83,10 +83,10 @@ import org.apache.commons.math4.util.MathUtils;
  * be the bin containing x and let K be the within-bin kernel for B.  Let P(B-)
  * be the sum of the probabilities of the bins below B and let K(B) be the
  * mass of B under K (i.e., the integral of the kernel density over B).  Then
- * set P(X < x) = P(B-) + P(B) * K(x) / K(B) where K(x) is the kernel distribution
- * evaluated at x. This results in a cdf that matches the grouped frequency
- * distribution at the bin endpoints and interpolates within bins using
- * within-bin kernels.</p>
+ * set {@code P(X < x) = P(B-) + P(B) * K(x) / K(B)} where {@code K(x)} is the
+ * kernel distribution evaluated at x. This results in a cdf that matches the
+ * grouped frequency distribution at the bin endpoints and interpolates within
+ * bins using within-bin kernels.</p>
  *
  *<strong>USAGE NOTES:</strong><ul>
  *<li>The <code>binCount</code> is set by default to 1000.  A good rule of thumb
@@ -532,7 +532,7 @@ public class EmpiricalDistribution extends AbstractRealDistribution {
      * <li>Return P(B-) + P(B) * [K(x) - K(B-)] / K(B) where
      * K(x) is the within-bin kernel distribution function evaluated at x.</li></ol>
      * If K is a constant distribution, we return P(B-) + P(B) (counting the full
-     * mass of B).</p>
+     * mass of B).
      *
      * @since 3.1
      */

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5976c9e4/src/main/java/org/apache/commons/math4/distribution/EnumeratedDistribution.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/distribution/EnumeratedDistribution.java b/src/main/java/org/apache/commons/math4/distribution/EnumeratedDistribution.java
index f0b6f2e..2ca612e 100644
--- a/src/main/java/org/apache/commons/math4/distribution/EnumeratedDistribution.java
+++ b/src/main/java/org/apache/commons/math4/distribution/EnumeratedDistribution.java
@@ -41,7 +41,7 @@ import org.apache.commons.math4.util.Pair;
  * but zero values are allowed and their sum does not have to equal one. Constructors will normalize input
  * probabilities to make them sum to one.</p>
  *
- * <p>The list of <value, probability> pairs does not, strictly speaking, have to be a function and it can
+ * <p>The list of &lt;value, probability&gt; pairs does not, strictly speaking, have to be a function and it can
  * contain null values.  The pmf created by the constructor will combine probabilities of equal values and
  * will treat null values as equal.  For example, if the list of pairs &lt;"dog", 0.2&gt;, &lt;null, 0.1&gt;,
  * &lt;"pig", 0.2&gt;, &lt;"dog", 0.1&gt;, &lt;null, 0.4&gt; is provided to the constructor, the resulting
@@ -139,7 +139,7 @@ public class EnumeratedDistribution<T> implements Serializable {
     }
 
     /**
-     * <p>Return the probability mass function as a list of <value, probability> pairs.</p>
+     * <p>Return the probability mass function as a list of &lt;value, probability&gt; pairs.</p>
      *
      * <p>Note that if duplicate and / or null values were provided to the constructor
      * when creating this EnumeratedDistribution, the returned list will contain these

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5976c9e4/src/main/java/org/apache/commons/math4/distribution/GammaDistribution.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/distribution/GammaDistribution.java b/src/main/java/org/apache/commons/math4/distribution/GammaDistribution.java
index 29ad268..77d296b 100644
--- a/src/main/java/org/apache/commons/math4/distribution/GammaDistribution.java
+++ b/src/main/java/org/apache/commons/math4/distribution/GammaDistribution.java
@@ -267,7 +267,7 @@ public class GammaDistribution extends AbstractRealDistribution {
      *   <a href="http://mathworld.wolfram.com/Chi-SquaredDistribution.html">
      *    Chi-Squared Distribution</a>, equation (9).
      *  </li>
-     *  <li>Casella, G., & Berger, R. (1990). <i>Statistical Inference</i>.
+     *  <li>Casella, G., &amp; Berger, R. (1990). <i>Statistical Inference</i>.
      *    Belmont, CA: Duxbury Press.
      *  </li>
      * </ul>

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5976c9e4/src/main/java/org/apache/commons/math4/distribution/IntegerDistribution.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/distribution/IntegerDistribution.java b/src/main/java/org/apache/commons/math4/distribution/IntegerDistribution.java
index 05076ae..34a51d0 100644
--- a/src/main/java/org/apache/commons/math4/distribution/IntegerDistribution.java
+++ b/src/main/java/org/apache/commons/math4/distribution/IntegerDistribution.java
@@ -84,8 +84,8 @@ public interface IntegerDistribution {
      * For a random variable {@code X} distributed according to this distribution,
      * the returned value is
      * <ul>
-     * <li><code>inf{x in Z | P(X<=x) >= p}</code> for {@code 0 < p <= 1},</li>
-     * <li><code>inf{x in Z | P(X<=x) > 0}</code> for {@code p = 0}.</li>
+     * <li>{@code inf{x in Z | P(X<=x) >= p}} for {@code 0 < p <= 1},</li>
+     * <li>{@code inf{x in Z | P(X<=x) > 0}} for {@code p = 0}.</li>
      * </ul>
      * If the result exceeds the range of the data type {@code int},
      * then {@code Integer.MIN_VALUE} or {@code Integer.MAX_VALUE} is returned.
@@ -118,7 +118,7 @@ public interface IntegerDistribution {
      * Access the lower bound of the support. This method must return the same
      * value as {@code inverseCumulativeProbability(0)}. In other words, this
      * method must return
-     * <p><code>inf {x in Z | P(X <= x) > 0}</code>.</p>
+     * <p>{@code inf {x in Z | P(X <= x) > 0}}.</p>
      *
      * @return lower bound of the support ({@code Integer.MIN_VALUE}
      * for negative infinity)
@@ -129,7 +129,7 @@ public interface IntegerDistribution {
      * Access the upper bound of the support. This method must return the same
      * value as {@code inverseCumulativeProbability(1)}. In other words, this
      * method must return
-     * <p><code>inf {x in R | P(X <= x) = 1}</code>.</p>
+     * <p>{@code inf {x in R | P(X <= x) = 1}}.</p>
      *
      * @return upper bound of the support ({@code Integer.MAX_VALUE}
      * for positive infinity)

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5976c9e4/src/main/java/org/apache/commons/math4/distribution/LevyDistribution.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/distribution/LevyDistribution.java b/src/main/java/org/apache/commons/math4/distribution/LevyDistribution.java
index a8d5793..1986cac 100644
--- a/src/main/java/org/apache/commons/math4/distribution/LevyDistribution.java
+++ b/src/main/java/org/apache/commons/math4/distribution/LevyDistribution.java
@@ -57,9 +57,9 @@ public class LevyDistribution extends AbstractRealDistribution {
     * From Wikipedia: The probability density function of the L&eacute;vy distribution
     * over the domain is
     * </p>
-    * <pre>
+    * <div style="white-space: pre"><code>
     * f(x; &mu;, c) = &radic;(c / 2&pi;) * e<sup>-c / 2 (x - &mu;)</sup> / (x - &mu;)<sup>3/2</sup>
-    * </pre>
+    * </code></div>
     * <p>
     * For this distribution, {@code X}, this method returns {@code P(X < x)}.
     * If {@code x} is less than location parameter &mu;, {@code Double.NaN} is

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5976c9e4/src/main/java/org/apache/commons/math4/distribution/RealDistribution.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/distribution/RealDistribution.java b/src/main/java/org/apache/commons/math4/distribution/RealDistribution.java
index a9e8cb2..baaf747 100644
--- a/src/main/java/org/apache/commons/math4/distribution/RealDistribution.java
+++ b/src/main/java/org/apache/commons/math4/distribution/RealDistribution.java
@@ -100,8 +100,8 @@ public interface RealDistribution {
      * variable {@code X} distributed according to this distribution, the
      * returned value is
      * <ul>
-     * <li><code>inf{x in R | P(X<=x) >= p}</code> for {@code 0 < p <= 1},</li>
-     * <li><code>inf{x in R | P(X<=x) > 0}</code> for {@code p = 0}.</li>
+     * <li>{@code inf{x in R | P(X<=x) >= p}} for {@code 0 < p <= 1},</li>
+     * <li>{@code inf{x in R | P(X<=x) > 0}} for {@code p = 0}.</li>
      * </ul>
      *
      * @param p the cumulative probability
@@ -133,7 +133,7 @@ public interface RealDistribution {
      * Access the lower bound of the support. This method must return the same
      * value as {@code inverseCumulativeProbability(0)}. In other words, this
      * method must return
-     * <p><code>inf {x in R | P(X <= x) > 0}</code>.</p>
+     * <p>{@code inf {x in R | P(X <= x) > 0}}.</p>
      *
      * @return lower bound of the support (might be
      * {@code Double.NEGATIVE_INFINITY})
@@ -144,7 +144,7 @@ public interface RealDistribution {
      * Access the upper bound of the support. This method must return the same
      * value as {@code inverseCumulativeProbability(1)}. In other words, this
      * method must return
-     * <p><code>inf {x in R | P(X <= x) = 1}</code>.</p>
+     * <p>{@code inf {x in R | P(X <= x) = 1}}.</p>
      *
      * @return upper bound of the support (might be
      * {@code Double.POSITIVE_INFINITY})

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5976c9e4/src/main/java/org/apache/commons/math4/distribution/ZipfDistribution.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/distribution/ZipfDistribution.java b/src/main/java/org/apache/commons/math4/distribution/ZipfDistribution.java
index 569d51b..17a95c2 100644
--- a/src/main/java/org/apache/commons/math4/distribution/ZipfDistribution.java
+++ b/src/main/java/org/apache/commons/math4/distribution/ZipfDistribution.java
@@ -39,7 +39,7 @@ import org.apache.commons.rng.sampling.distribution.RejectionInversionZipfSample
  * <li>{@code N} is the number of elements</li>
  * <li>{@code s} is the exponent</li>
  * </ul>
- * @see <a href="https://en.wikipedia.org/wiki/Zipf's_law">Zipf&apos;s law (Wikipedia)</a>
+ * @see <a href="https://en.wikipedia.org/wiki/Zipf's_law">Zipf's law (Wikipedia)</a>
  * @see <a href="https://en.wikipedia.org/wiki/Harmonic_number#Generalized_harmonic_numbers">Generalized harmonic numbers</a>
  */
 public class ZipfDistribution extends AbstractIntegerDistribution {

[12/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/8e20a6e0
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/8e20a6e0
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/8e20a6e0

Branch: refs/heads/master
Commit: 8e20a6e04b9abd28da2a6bdefd67647d4e691236
Parents: 4666eb3
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 10:38:29 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 10:38:29 2017 -0400

----------------------------------------------------------------------
 .../java/org/apache/commons/math4/ode/events/package-info.java | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/8e20a6e0/src/main/java/org/apache/commons/math4/ode/events/package-info.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ode/events/package-info.java b/src/main/java/org/apache/commons/math4/ode/events/package-info.java
index 6e8ecdd..e0b5d30 100644
--- a/src/main/java/org/apache/commons/math4/ode/events/package-info.java
+++ b/src/main/java/org/apache/commons/math4/ode/events/package-info.java
@@ -56,7 +56,7 @@
  *    return STOP;
  *  }
  * </pre>
- * </p>
+ * 
  *
  * <p>
  * The second case, change state vector or derivatives is encountered when dealing
@@ -75,7 +75,7 @@
  *    return RESET_DERIVATIVES;
  *  }
  * </pre>
- * </p>
+ * 
  *
  * <p>
  * The third case is useful mainly for monitoring purposes, a simple example is:
@@ -89,8 +89,6 @@
  *    return CONTINUE;
  *  }
  * </pre>
- * </p>
- *
  *
  */
 package org.apache.commons.math4.ode.events;

[09/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/7c7a1c2a
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/7c7a1c2a
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/7c7a1c2a

Branch: refs/heads/master
Commit: 7c7a1c2a4f886bcb2a09e21ad9ab7c5b96123d65
Parents: a5b4763
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 10:27:35 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 10:27:35 2017 -0400

----------------------------------------------------------------------
 .../java/org/apache/commons/math4/genetics/CycleCrossover.java  | 1 -
 .../org/apache/commons/math4/genetics/GeneticAlgorithm.java     | 4 ++--
 src/main/java/org/apache/commons/math4/genetics/RandomKey.java  | 2 +-
 src/main/java/org/apache/commons/math4/special/Gamma.java       | 5 ++---
 4 files changed, 5 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/7c7a1c2a/src/main/java/org/apache/commons/math4/genetics/CycleCrossover.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/genetics/CycleCrossover.java b/src/main/java/org/apache/commons/math4/genetics/CycleCrossover.java
index 0de8371..1b78ab8 100644
--- a/src/main/java/org/apache/commons/math4/genetics/CycleCrossover.java
+++ b/src/main/java/org/apache/commons/math4/genetics/CycleCrossover.java
@@ -41,7 +41,6 @@ import org.apache.commons.math4.exception.util.LocalizedFormats;
  * The indices that form a cycle are then used to form the children in alternating order, i.e.
  * in cycle 1, the genes of parent 1 are copied to child 1, while in cycle 2 the genes of parent 1
  * are copied to child 2, and so forth ...
- * </p>
  *
  * Example (zero-start cycle):
  * <pre>

http://git-wip-us.apache.org/repos/asf/commons-math/blob/7c7a1c2a/src/main/java/org/apache/commons/math4/genetics/GeneticAlgorithm.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/genetics/GeneticAlgorithm.java b/src/main/java/org/apache/commons/math4/genetics/GeneticAlgorithm.java
index 5dd2be2..24f1e9f 100644
--- a/src/main/java/org/apache/commons/math4/genetics/GeneticAlgorithm.java
+++ b/src/main/java/org/apache/commons/math4/genetics/GeneticAlgorithm.java
@@ -128,7 +128,7 @@ public class GeneticAlgorithm {
      * <ol>
      *  <li>Get nextGeneration population to fill from <code>current</code>
      *      generation, using its nextGeneration method</li>
-     *  <li>Loop until new generation is filled:</li>
+     *  <li>Loop until new generation is filled:
      *  <ul><li>Apply configured SelectionPolicy to select a pair of parents
      *          from <code>current</code></li>
      *      <li>With probability = {@link #getCrossoverRate()}, apply
@@ -137,7 +137,7 @@ public class GeneticAlgorithm {
      *          configured {@link MutationPolicy} to each of the offspring</li>
      *      <li>Add offspring individually to nextGeneration,
      *          space permitting</li>
-     *  </ul>
+     *  </ul></li>
      *  <li>Return nextGeneration</li>
      * </ol>
      *

http://git-wip-us.apache.org/repos/asf/commons-math/blob/7c7a1c2a/src/main/java/org/apache/commons/math4/genetics/RandomKey.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/genetics/RandomKey.java b/src/main/java/org/apache/commons/math4/genetics/RandomKey.java
index ea0a401..fe4b178 100644
--- a/src/main/java/org/apache/commons/math4/genetics/RandomKey.java
+++ b/src/main/java/org/apache/commons/math4/genetics/RandomKey.java
@@ -249,7 +249,7 @@ public abstract class RandomKey<T> extends AbstractListChromosome<Double> implem
      * @param originalData the original, unpermuted data
      * @param permutedData the data, somehow permuted
      * @return representation of a permutation corresponding to the permutation
-     *   <code>originalData -> permutedData</code>
+     *   {@code originalData -> permutedData}
      * @throws DimensionMismatchException iff the length of <code>originalData</code>
      *   and <code>permutedData</code> lists are not equal
      * @throws MathIllegalArgumentException iff the <code>permutedData</code> and

http://git-wip-us.apache.org/repos/asf/commons-math/blob/7c7a1c2a/src/main/java/org/apache/commons/math4/special/Gamma.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/special/Gamma.java b/src/main/java/org/apache/commons/math4/special/Gamma.java
index b38ea05..3c4ff97 100644
--- a/src/main/java/org/apache/commons/math4/special/Gamma.java
+++ b/src/main/java/org/apache/commons/math4/special/Gamma.java
@@ -47,7 +47,6 @@ import org.apache.commons.math4.util.FastMath;
  * indicates that unless otherwise stated in the code, all FORTRAN functions in
  * this library are license free. Since no such notice appears in the code these
  * functions can safely be ported to Commons-Math.
- * </p>
  *
  */
 public class Gamma {
@@ -435,14 +434,14 @@ public class Gamma {
      *
      * <p>Some of the constants have been changed to increase accuracy at the moderate
      * expense of run-time.  The result should be accurate to within \( 10^{-8} \)
-     * relative tolerance for \( 0 < x < 10^{-5} \) and within \( 10^{-8} \) absolute
+     * relative tolerance for \( 0 \le x \le 10^{-5} \) and within \( 10^{-8} \) absolute
      * tolerance otherwise.</p>
      *
      * @param x Argument.
      * @return digamma(x) to within \( 10^{-8} \) relative or absolute error whichever is larger.
      *
      * @see <a href="http://en.wikipedia.org/wiki/Digamma_function">Digamma</a>
-     * @see <a href="http://www.uv.es/~bernardo/1976AppStatist.pdf">Bernardo&apos;s original article</a>
+     * @see <a href="http://www.uv.es/~bernardo/1976AppStatist.pdf">Bernardo's original article</a>
      *
      * @since 2.0
      */

[06/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/55a6aa82
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/55a6aa82
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/55a6aa82

Branch: refs/heads/master
Commit: 55a6aa82d1abd90b83f8fd163c062e3832d598de
Parents: 2fac0dc
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 09:42:41 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 09:42:41 2017 -0400

----------------------------------------------------------------------
 .../java/org/apache/commons/math4/dfp/Dfp.java  |  4 +-
 .../org/apache/commons/math4/dfp/DfpField.java  |  2 +
 .../org/apache/commons/math4/dfp/DfpMath.java   | 55 +++++++++++---------
 3 files changed, 33 insertions(+), 28 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/55a6aa82/src/main/java/org/apache/commons/math4/dfp/Dfp.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/dfp/Dfp.java b/src/main/java/org/apache/commons/math4/dfp/Dfp.java
index 22f2868..08d29d0 100644
--- a/src/main/java/org/apache/commons/math4/dfp/Dfp.java
+++ b/src/main/java/org/apache/commons/math4/dfp/Dfp.java
@@ -51,9 +51,9 @@ import org.apache.commons.math4.util.FastMath;
  *  </ol>
  *
  *  <p>Numbers are represented  in the following form:
- *  <pre>
+ *  <div style="white-space: pre"><code>
  *  n  =  sign &times; mant &times; (radix)<sup>exp</sup>;
- *  </pre>
+ *  </code></div>
  *  where sign is &plusmn;1, mantissa represents a fractional number between
  *  zero and one.  mant[0] is the least significant digit.
  *  exp is in the range of -32767 to 32768

http://git-wip-us.apache.org/repos/asf/commons-math/blob/55a6aa82/src/main/java/org/apache/commons/math4/dfp/DfpField.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/dfp/DfpField.java b/src/main/java/org/apache/commons/math4/dfp/DfpField.java
index c83051d..c96c363 100644
--- a/src/main/java/org/apache/commons/math4/dfp/DfpField.java
+++ b/src/main/java/org/apache/commons/math4/dfp/DfpField.java
@@ -676,6 +676,7 @@ public class DfpField implements Field<Dfp> {
 
     /** Compute ln(a).
      *
+     *  <pre>{@code
      *  Let f(x) = ln(x),
      *
      *  We know that f'(x) = 1/x, thus from Taylor's theorem we have:
@@ -727,6 +728,7 @@ public class DfpField implements Field<Dfp> {
      *  But now we want to find ln(a), so we need to find the value of x
      *  such that a = (x+1)/(x-1).   This is easily solved to find that
      *  x = (a-1)/(a+1).
+     * }</pre>
      * @param a number for which we want the exponential
      * @param one constant with value 1 at desired precision
      * @param two constant with value 2 at desired precision

http://git-wip-us.apache.org/repos/asf/commons-math/blob/55a6aa82/src/main/java/org/apache/commons/math4/dfp/DfpMath.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/dfp/DfpMath.java b/src/main/java/org/apache/commons/math4/dfp/DfpMath.java
index c66ae2d..734c8fa 100644
--- a/src/main/java/org/apache/commons/math4/dfp/DfpMath.java
+++ b/src/main/java/org/apache/commons/math4/dfp/DfpMath.java
@@ -283,7 +283,8 @@ public class DfpMath {
     }
 
     /** Computes e to the given power.
-     * Where -1 < a < 1.  Use the classic Taylor series.  1 + x**2/2! + x**3/3! + x**4/4!  ...
+     * Where {@code -1 < a < 1}.  Use the classic Taylor series.
+     * {@code 1 + x**2/2! + x**3/3! + x**4/4!  ... }
      * @param a power at which e should be raised
      * @return e<sup>a</sup>
      */
@@ -307,9 +308,9 @@ public class DfpMath {
     }
 
     /** Returns the natural logarithm of a.
-     * a is first split into three parts such that  a = (10000^h)(2^j)k.
-     * ln(a) is computed by ln(a) = ln(5)*h + ln(2)*(h+j) + ln(k)
-     * k is in the range 2/3 < k <4/3 and is passed on to a series expansion.
+     * a is first split into three parts such that {@code a = (10000^h)(2^j)k}.
+     * ln(a) is computed by {@code ln(a) = ln(5)*h + ln(2)*(h+j) + ln(k)}.
+     * k is in the range {@code 2/3 < k <4/3} and is passed on to a series expansion.
      * @param a number from which logarithm is requested
      * @return log(a)
      */
@@ -377,6 +378,7 @@ public class DfpMath {
     }
 
     /** Computes the natural log of a number between 0 and 2.
+     * <pre>{@code
      *  Let f(x) = ln(x),
      *
      *  We know that f'(x) = 1/x, thus from Taylor's theorum we have:
@@ -428,6 +430,7 @@ public class DfpMath {
      *  But now we want to find ln(a), so we need to find the value of x
      *  such that a = (x+1)/(x-1).   This is easily solved to find that
      *  x = (a-1)/(a+1).
+     * }</pre>
      * @param a number from which logarithm is requested, in split form
      * @return log(a)
      */
@@ -463,7 +466,7 @@ public class DfpMath {
 
     /** Computes x to the y power.<p>
      *
-     *  Uses the following method:<p>
+     *  Uses the following method:
      *
      *  <ol>
      *  <li> Set u = rint(y), v = y-u
@@ -472,30 +475,30 @@ public class DfpMath {
      *  <li> Compute c = a - b*ln(2)
      *  <li> x<sup>y</sup> = x<sup>u</sup>  *   2<sup>b</sup> * e<sup>c</sup>
      *  </ol>
-     *  if |y| > 1e8, then we compute by exp(y*ln(x))   <p>
+     *  if {@code |y| > 1e8}, then we compute by {@code exp(y*ln(x))}<p>
      *
-     *  <b>Special Cases</b><p>
+     *  <b>Special Cases</b>
      *  <ul>
      *  <li>  if y is 0.0 or -0.0 then result is 1.0
      *  <li>  if y is 1.0 then result is x
      *  <li>  if y is NaN then result is NaN
      *  <li>  if x is NaN and y is not zero then result is NaN
-     *  <li>  if |x| > 1.0 and y is +Infinity then result is +Infinity
-     *  <li>  if |x| < 1.0 and y is -Infinity then result is +Infinity
-     *  <li>  if |x| > 1.0 and y is -Infinity then result is +0
-     *  <li>  if |x| < 1.0 and y is +Infinity then result is +0
-     *  <li>  if |x| = 1.0 and y is +/-Infinity then result is NaN
-     *  <li>  if x = +0 and y > 0 then result is +0
-     *  <li>  if x = +Inf and y < 0 then result is +0
-     *  <li>  if x = +0 and y < 0 then result is +Inf
-     *  <li>  if x = +Inf and y > 0 then result is +Inf
-     *  <li>  if x = -0 and y > 0, finite, not odd integer then result is +0
-     *  <li>  if x = -0 and y < 0, finite, and odd integer then result is -Inf
-     *  <li>  if x = -Inf and y > 0, finite, and odd integer then result is -Inf
-     *  <li>  if x = -0 and y < 0, not finite odd integer then result is +Inf
-     *  <li>  if x = -Inf and y > 0, not finite odd integer then result is +Inf
-     *  <li>  if x < 0 and y > 0, finite, and odd integer then result is -(|x|<sup>y</sup>)
-     *  <li>  if x < 0 and y > 0, finite, and not integer then result is NaN
+     *  <li>  if {@code |x| > 1.0} and y is +Infinity then result is +Infinity
+     *  <li>  if {@code |x| < 1.0} and y is -Infinity then result is +Infinity
+     *  <li>  if {@code |x| > 1.0} and y is -Infinity then result is +0
+     *  <li>  if {@code |x| < 1.0} and y is +Infinity then result is +0
+     *  <li>  if {@code |x| = 1.0} and y is +/-Infinity then result is NaN
+     *  <li>  if {@code x = +0} and {@code y > 0} then result is +0
+     *  <li>  if {@code x = +Inf} and {@code y < 0} then result is +0
+     *  <li>  if {@code x = +0} and {@code y < 0} then result is +Inf
+     *  <li>  if {@code x = +Inf} and {@code y > 0} then result is +Inf
+     *  <li>  if {@code x = -0} and {@code y > 0}, finite, not odd integer then result is +0
+     *  <li>  if {@code x = -0} and {@code y < 0}, finite, and odd integer then result is -Inf
+     *  <li>  if {@code x = -Inf} and {@code y > 0}, finite, and odd integer then result is -Inf
+     *  <li>  if {@code x = -0} and {@code y < 0}, not finite odd integer then result is +Inf
+     *  <li>  if {@code x = -Inf} and {@code y > 0}, not finite odd integer then result is +Inf
+     *  <li>  if {@code x < 0} and {@code y > 0}, finite, and odd integer then result is -(|x|<sup>y</sup>)
+     *  <li>  if {@code x < 0} and {@code y > 0}, finite, and not integer then result is NaN
      *  </ul>
      *  @param x base to be raised
      *  @param y power to which base should be raised
@@ -661,8 +664,8 @@ public class DfpMath {
 
     }
 
-    /** Computes sin(a)  Used when 0 < a < pi/4.
-     * Uses the classic Taylor series.  x - x**3/3! + x**5/5!  ...
+    /** Computes sin(a)  Used when {@code {@code 0 < a < pi/4}}.
+     * Uses the classic Taylor series.  {@code x - x**3/3! + x**5/5!  ... }
      * @param a number from which sine is desired, in split form
      * @return sin(a)
      */
@@ -691,7 +694,7 @@ public class DfpMath {
 
     }
 
-    /** Computes cos(a)  Used when 0 < a < pi/4.
+    /** Computes cos(a)  Used when {@code 0 < a < pi/4}.
      * Uses the classic Taylor series for cosine.  1 - x**2/2! + x**4/4!  ...
      * @param a number from which cosine is desired, in split form
      * @return cos(a)

[08/15] [math] Fix javadoc issues - had to use CSS to simulate nested tags

Posted by ra...@apache.org.
Fix javadoc issues - had to use CSS to simulate nested <sup> tags

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/a5b47638
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/a5b47638
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/a5b47638

Branch: refs/heads/master
Commit: a5b47638d4862d73115de0660f1b968f5c603e7e
Parents: d06517a
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 09:52:59 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 09:52:59 2017 -0400

----------------------------------------------------------------------
 src/main/java/org/apache/commons/math4/special/Beta.java | 3 +--
 src/main/java/org/apache/commons/math4/special/Erf.java  | 4 ++--
 2 files changed, 3 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/a5b47638/src/main/java/org/apache/commons/math4/special/Beta.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/special/Beta.java b/src/main/java/org/apache/commons/math4/special/Beta.java
index bfcf818..9e40cd8 100644
--- a/src/main/java/org/apache/commons/math4/special/Beta.java
+++ b/src/main/java/org/apache/commons/math4/special/Beta.java
@@ -46,7 +46,6 @@ import org.apache.commons.math4.util.FastMath;
  * indicates that unless otherwise stated in the code, all FORTRAN functions in
  * this library are license free. Since no such notice appears in the code these
  * functions can safely be ported to Commons-Math.
- * </p>
  */
 public class Beta {
     /** Maximum allowed numerical error. */
@@ -379,7 +378,7 @@ public class Beta {
     }
 
     /**
-     * Returns the value of log B(p, q) for 0 ≤ x ≤ 1 and p, q > 0. Based on the
+     * Returns the value of {@code log B(p, q)} for {@code 0 ≤ x ≤ 1} and {@code p, q > 0}. Based on the
      * <em>NSWC Library of Mathematics Subroutines</em> implementation,
      * {@code DBETLN}.
      *

http://git-wip-us.apache.org/repos/asf/commons-math/blob/a5b47638/src/main/java/org/apache/commons/math4/special/Erf.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/special/Erf.java b/src/main/java/org/apache/commons/math4/special/Erf.java
index c0c4ce0..14aede7 100644
--- a/src/main/java/org/apache/commons/math4/special/Erf.java
+++ b/src/main/java/org/apache/commons/math4/special/Erf.java
@@ -45,7 +45,7 @@ public class Erf {
     /**
      * Returns the error function.
      *
-     * <p>erf(x) = 2/&radic;&pi; <sub>0</sub>&int;<sup>x</sup> e<sup>-t<sup>2</sup></sup>dt </p>
+     * <p>erf(x) = 2/&radic;&pi; <sub>0</sub>&int;<sup>x</sup> e<sup>-t<span style="position: relative; top: -.5em">2</span></sup>dt </p>
      *
      * <p>This implementation computes erf(x) using the
      * {@link Gamma#regularizedGammaP(double, double, double, int) regularized gamma function},
@@ -73,7 +73,7 @@ public class Erf {
     /**
      * Returns the complementary error function.
      *
-     * <p>erfc(x) = 2/&radic;&pi; <sub>x</sub>&int;<sup>&infin;</sup> e<sup>-t<sup>2</sup></sup>dt
+     * <p>erfc(x) = 2/&radic;&pi; <sub>x</sub>&int;<sup>&infin;</sup> e<sup>-t<span style="position: relative; top: -.5em">2</span></sup>dt
      * <br>
      *    = 1 - {@link #erf(double) erf(x)} </p>
      *

[11/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/4666eb35
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/4666eb35
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/4666eb35

Branch: refs/heads/master
Commit: 4666eb3538aa7030cbf875207bcccd119400d3a4
Parents: d5b2a8b
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 10:38:19 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 10:38:19 2017 -0400

----------------------------------------------------------------------
 .../math4/geometry/euclidean/threed/SphericalCoordinates.java      | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/4666eb35/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/SphericalCoordinates.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/SphericalCoordinates.java b/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/SphericalCoordinates.java
index b82ec20..5f07644 100644
--- a/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/SphericalCoordinates.java
+++ b/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/SphericalCoordinates.java
@@ -66,7 +66,7 @@ public class SphericalCoordinates implements Serializable {
     /** Polar angle (co-latitude) &Phi;. */
     private final double phi;
 
-    /** Jacobian of (r, &theta; &Phi). */
+    /** Jacobian of (r, &theta; &Phi;). */
     private double[][] jacobian;
 
     /** Hessian of radius. */

[14/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/cc6a661f
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/cc6a661f
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/cc6a661f

Branch: refs/heads/master
Commit: cc6a661f994d654e64336ccd40f12fa66522ce60
Parents: 5634d8c
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 10:39:00 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 10:39:00 2017 -0400

----------------------------------------------------------------------
 .../math4/optim/linear/LinearConstraint.java        |  2 +-
 .../commons/math4/optim/linear/SimplexTableau.java  | 16 ++++++++--------
 2 files changed, 9 insertions(+), 9 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/cc6a661f/src/main/java/org/apache/commons/math4/optim/linear/LinearConstraint.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/optim/linear/LinearConstraint.java b/src/main/java/org/apache/commons/math4/optim/linear/LinearConstraint.java
index 1d194ac..ee75ef7 100644
--- a/src/main/java/org/apache/commons/math4/optim/linear/LinearConstraint.java
+++ b/src/main/java/org/apache/commons/math4/optim/linear/LinearConstraint.java
@@ -50,7 +50,7 @@ public class LinearConstraint implements Serializable {
     private static final long serialVersionUID = -764632794033034092L;
     /** Coefficients of the constraint (left hand side). */
     private final transient RealVector coefficients;
-    /** Relationship between left and right hand sides (=, &lt;=, >=). */
+    /** Relationship between left and right hand sides {@code (=, <=, >=)}. */
     private final Relationship relationship;
     /** Value of the constraint (right hand side). */
     private final double value;

http://git-wip-us.apache.org/repos/asf/commons-math/blob/cc6a661f/src/main/java/org/apache/commons/math4/optim/linear/SimplexTableau.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/optim/linear/SimplexTableau.java b/src/main/java/org/apache/commons/math4/optim/linear/SimplexTableau.java
index c435094..c8a33a1 100644
--- a/src/main/java/org/apache/commons/math4/optim/linear/SimplexTableau.java
+++ b/src/main/java/org/apache/commons/math4/optim/linear/SimplexTableau.java
@@ -50,14 +50,14 @@ import org.apache.commons.numbers.core.Precision;
  *   0    0    0     1     0     0     1     0     3   &lt;= constraint 2
  *   0    0    1     1     0     0     0     1     4   &lt;= constraint 3
  * </pre>
- * W: Phase 1 objective function</br>
- * Z: Phase 2 objective function</br>
- * x1 &amp; x2: Decision variables</br>
- * x-: Extra decision variable to allow for negative values</br>
- * s1 &amp; s2: Slack/Surplus variables</br>
- * a1: Artificial variable</br>
- * RHS: Right hand side</br>
- * </p>
+ * W: Phase 1 objective function<br>
+ * Z: Phase 2 objective function<br>
+ * x1 &amp; x2: Decision variables<br>
+ * x-: Extra decision variable to allow for negative values<br>
+ * s1 &amp; s2: Slack/Surplus variables<br>
+ * a1: Artificial variable<br>
+ * RHS: Right hand side<br>
+ * 
  * @since 2.0
  */
 class SimplexTableau implements Serializable {

[02/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/e94dbfd3
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/e94dbfd3
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/e94dbfd3

Branch: refs/heads/master
Commit: e94dbfd332a20fedd521dec9fd5a218c93ac71b0
Parents: 5976c9e
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 09:15:35 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 09:15:35 2017 -0400

----------------------------------------------------------------------
 .../org/apache/commons/math4/geometry/enclosing/WelzlEncloser.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/e94dbfd3/src/main/java/org/apache/commons/math4/geometry/enclosing/WelzlEncloser.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/geometry/enclosing/WelzlEncloser.java b/src/main/java/org/apache/commons/math4/geometry/enclosing/WelzlEncloser.java
index b76ff6a..924fa83 100644
--- a/src/main/java/org/apache/commons/math4/geometry/enclosing/WelzlEncloser.java
+++ b/src/main/java/org/apache/commons/math4/geometry/enclosing/WelzlEncloser.java
@@ -32,7 +32,7 @@ import org.apache.commons.math4.geometry.Space;
  * href="http://www.inf.ethz.ch/personal/gaertner/texts/own_work/esa99_final.pdf">Fast and
  * Robust Smallest Enclosing Balls</a>, by Bernd Gärtner and further modified in
  * paper <a
- * href=http://www.idt.mdh.se/kurser/ct3340/ht12/MINICONFERENCE/FinalPapers/ircse12_submission_30.pdf">
+ * href="http://www.idt.mdh.se/kurser/ct3340/ht12/MINICONFERENCE/FinalPapers/ircse12_submission_30.pdf">
  * Efficient Computation of Smallest Enclosing Balls in Three Dimensions</a> by Linus Källberg
  * to avoid performing local copies of data have been included.
  * </p>

[05/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/2fac0dc7
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/2fac0dc7
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/2fac0dc7

Branch: refs/heads/master
Commit: 2fac0dc77402fe8ddcb81ca76abff6c4b9f63141
Parents: e2940db
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 09:30:43 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 09:30:43 2017 -0400

----------------------------------------------------------------------
 .../apache/commons/math4/geometry/partitioning/Embedding.java  | 6 +++---
 .../math4/geometry/spherical/twod/SphericalPolygonsSet.java    | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/2fac0dc7/src/main/java/org/apache/commons/math4/geometry/partitioning/Embedding.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/geometry/partitioning/Embedding.java b/src/main/java/org/apache/commons/math4/geometry/partitioning/Embedding.java
index 9e78d90..ef3cadf 100644
--- a/src/main/java/org/apache/commons/math4/geometry/partitioning/Embedding.java
+++ b/src/main/java/org/apache/commons/math4/geometry/partitioning/Embedding.java
@@ -26,9 +26,9 @@ import org.apache.commons.math4.geometry.Space;
  * as {@link Hyperplane hyperplanes}. This interface can be used regardless
  * of the dimensions differences. As an example, {@link
  * org.apache.commons.math4.geometry.euclidean.threed.Line Line} in 3D
- * implements Embedding<{@link
- * org.apache.commons.math4.geometry.euclidean.threed.Cartesian3D Cartesian3D}, {link
- * org.apache.commons.math4.geometry.euclidean.oned.Cartesian1D Cartesian1D}, i.e. it
+ * implements Embedding&lt;{@link
+ * org.apache.commons.math4.geometry.euclidean.threed.Cartesian3D Cartesian3D}, {@link
+ * org.apache.commons.math4.geometry.euclidean.oned.Cartesian1D Cartesian1D}&gt;, i.e. it
  * maps directly dimensions 3 and 1.</p>
 
  * <p>In the 3D euclidean space, hyperplanes are 2D planes, and the 1D

http://git-wip-us.apache.org/repos/asf/commons-math/blob/2fac0dc7/src/main/java/org/apache/commons/math4/geometry/spherical/twod/SphericalPolygonsSet.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/geometry/spherical/twod/SphericalPolygonsSet.java b/src/main/java/org/apache/commons/math4/geometry/spherical/twod/SphericalPolygonsSet.java
index 83c6936..e6f94f2 100644
--- a/src/main/java/org/apache/commons/math4/geometry/spherical/twod/SphericalPolygonsSet.java
+++ b/src/main/java/org/apache/commons/math4/geometry/spherical/twod/SphericalPolygonsSet.java
@@ -421,7 +421,7 @@ public class SphericalPolygonsSet extends AbstractRegion<Sphere2D, Sphere1D> {
      * <p>
      * This method is intended as a first test to quickly identify points
      * that are guaranteed to be outside of the region, hence performing a full
-     * {@link #checkPoint(org.apache.commons.math4.geometry.Vector) checkPoint}
+     * {@link #checkPoint(org.apache.commons.math4.geometry.Point) checkPoint}
      * only if the point status remains undecided after the quick check. It is
      * is therefore mostly useful to speed up computation for small polygons with
      * complex shapes (say a country boundary on Earth), as the spherical cap will
@@ -429,7 +429,7 @@ public class SphericalPolygonsSet extends AbstractRegion<Sphere2D, Sphere1D> {
      * whereas the full check can be more computing intensive. A typical use case is
      * therefore:
      * </p>
-     * <pre>
+     * <pre>{@code
      *   // compute region, plus an enclosing spherical cap
      *   SphericalPolygonsSet complexShape = ...;
      *   EnclosingBall<Sphere2D, S2Point> cap = complexShape.getEnclosingCap();
@@ -451,7 +451,7 @@ public class SphericalPolygonsSet extends AbstractRegion<Sphere2D, Sphere1D> {
      *     // use l ...
      *
      *   }
-     * </pre>
+     * }</pre>
      * <p>
      * In the special cases of empty or whole sphere polygons, special
      * spherical caps are returned, with angular radius set to negative

[10/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/d5b2a8bd
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/d5b2a8bd
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/d5b2a8bd

Branch: refs/heads/master
Commit: d5b2a8bdec482341722ac82c219171d6a4d637c9
Parents: 7c7a1c2
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 10:38:09 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 10:38:09 2017 -0400

----------------------------------------------------------------------
 src/main/java/org/apache/commons/math4/dfp/package-info.java | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/d5b2a8bd/src/main/java/org/apache/commons/math4/dfp/package-info.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/dfp/package-info.java b/src/main/java/org/apache/commons/math4/dfp/package-info.java
index 7ad965a..d9f60e2 100644
--- a/src/main/java/org/apache/commons/math4/dfp/package-info.java
+++ b/src/main/java/org/apache/commons/math4/dfp/package-info.java
@@ -43,12 +43,12 @@
  * </ol>
  *
  * <p>Numbers are represented  in the following form:
- * <pre>
- * n  =  sign &times; mant &times; (radix)<sup>exp</sup>;</p>
- * </pre>
+ * <div style="white-space: pre"><code>
+ * n  =  sign &times; mant &times; (radix)<sup>exp</sup>;
+ * </code></div>
  * where sign is &plusmn;1, mantissa represents a fractional number between
  * zero and one.  mant[0] is the least significant digit.
- * exp is in the range of -32767 to 32768</p>
+ * exp is in the range of -32767 to 32768
  *
  * <p>IEEE 854-1987  Notes and differences</p>
  *

[07/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/d06517ad
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/d06517ad
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/d06517ad

Branch: refs/heads/master
Commit: d06517ad501c842515f27ef83fc8ba54559d55c3
Parents: 55a6aa8
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 09:44:32 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 09:44:32 2017 -0400

----------------------------------------------------------------------
 .../java/org/apache/commons/math4/random/RandomGenerator.java    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/d06517ad/src/main/java/org/apache/commons/math4/random/RandomGenerator.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/random/RandomGenerator.java b/src/main/java/org/apache/commons/math4/random/RandomGenerator.java
index c698f85..72dfbd6 100644
--- a/src/main/java/org/apache/commons/math4/random/RandomGenerator.java
+++ b/src/main/java/org/apache/commons/math4/random/RandomGenerator.java
@@ -69,7 +69,7 @@ public interface RandomGenerator {
     /**
      * Returns the next pseudorandom, uniformly distributed <code>int</code>
      * value from this random number generator's sequence.
-     * All 2<font size="-1"><sup>32</sup></font> possible {@code int} values
+     * All 2<sup style="font-size: smaller">32</sup> possible {@code int} values
      * should be produced with  (approximately) equal probability.
      *
      * @return the next pseudorandom, uniformly distributed <code>int</code>
@@ -93,7 +93,7 @@ public interface RandomGenerator {
     /**
      * Returns the next pseudorandom, uniformly distributed <code>long</code>
      * value from this random number generator's sequence.  All
-     * 2<font size="-1"><sup>64</sup></font> possible {@code long} values
+     * 2<sup style="font-size: smaller">64</sup> possible {@code long} values
      * should be produced with (approximately) equal probability.
      *
      * @return  the next pseudorandom, uniformly distributed <code>long</code>

[04/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/e2940dbf
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/e2940dbf
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/e2940dbf

Branch: refs/heads/master
Commit: e2940dbf8a266a5b300ccb67030a82d66f1b0a79
Parents: f2eaada
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 09:22:08 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 09:22:08 2017 -0400

----------------------------------------------------------------------
 .../commons/math4/geometry/euclidean/twod/hull/MonotoneChain.java  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/e2940dbf/src/main/java/org/apache/commons/math4/geometry/euclidean/twod/hull/MonotoneChain.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/geometry/euclidean/twod/hull/MonotoneChain.java b/src/main/java/org/apache/commons/math4/geometry/euclidean/twod/hull/MonotoneChain.java
index e77d4e3..cbc98da 100644
--- a/src/main/java/org/apache/commons/math4/geometry/euclidean/twod/hull/MonotoneChain.java
+++ b/src/main/java/org/apache/commons/math4/geometry/euclidean/twod/hull/MonotoneChain.java
@@ -44,7 +44,7 @@ import org.apache.commons.numbers.core.Precision;
  * identical and collinear points.
  *
  * @see <a href="http://en.wikibooks.org/wiki/Algorithm_Implementation/Geometry/Convex_hull/Monotone_chain">
- * Andrew&apos;s monotone chain algorithm (Wikibooks)</a>
+ * Andrew's monotone chain algorithm (Wikibooks)</a>
  * @since 3.3
  */
 public class MonotoneChain extends AbstractConvexHullGenerator2D {

[15/15] [math] Last of the javadoc issues

Posted by ra...@apache.org.
Last of the javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/cec35baf
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/cec35baf
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/cec35baf

Branch: refs/heads/master
Commit: cec35baf0b18c80fa66bd585adfed9ff8c091c59
Parents: cc6a661
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 10:40:25 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 10:40:25 2017 -0400

----------------------------------------------------------------------
 .../apache/commons/math4/stat/descriptive/moment/FourthMoment.java | 2 +-
 .../apache/commons/math4/stat/descriptive/moment/ThirdMoment.java  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/cec35baf/src/main/java/org/apache/commons/math4/stat/descriptive/moment/FourthMoment.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/stat/descriptive/moment/FourthMoment.java b/src/main/java/org/apache/commons/math4/stat/descriptive/moment/FourthMoment.java
index 88e373e..c6eede0 100644
--- a/src/main/java/org/apache/commons/math4/stat/descriptive/moment/FourthMoment.java
+++ b/src/main/java/org/apache/commons/math4/stat/descriptive/moment/FourthMoment.java
@@ -38,7 +38,7 @@ import org.apache.commons.math4.util.MathUtils;
  * <li> m2 = previous value of {@link ThirdMoment} </li>
  * <li> n = number of observations (including current obs) </li>
  * </ul>
- * Then </p>
+ * Then
  * <p>
  * new value = old value - 4 * (dev/n) * m3 + 6 * (dev/n)^2 * m2 + <br>
  * [n^2 - 3 * (n-1)] * dev^4 * (n-1) / n^3 </p>

http://git-wip-us.apache.org/repos/asf/commons-math/blob/cec35baf/src/main/java/org/apache/commons/math4/stat/descriptive/moment/ThirdMoment.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/stat/descriptive/moment/ThirdMoment.java b/src/main/java/org/apache/commons/math4/stat/descriptive/moment/ThirdMoment.java
index 96dc802..99b6f58 100644
--- a/src/main/java/org/apache/commons/math4/stat/descriptive/moment/ThirdMoment.java
+++ b/src/main/java/org/apache/commons/math4/stat/descriptive/moment/ThirdMoment.java
@@ -33,7 +33,7 @@ import org.apache.commons.math4.util.MathUtils;
  * <li> m2 = previous value of {@link SecondMoment} </li>
  * <li> n = number of observations (including current obs) </li>
  * </ul>
- * Then</p>
+ * Then
  * <p>
  * new value = old value - 3 * (dev/n) * m2 + (n-1) * (n -2) * (dev^3/n^2)</p>
  * <p>

[13/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/5634d8c4
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/5634d8c4
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/5634d8c4

Branch: refs/heads/master
Commit: 5634d8c4cc64db2bc5359b2068f4185c8c6ef422
Parents: 8e20a6e
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 10:38:41 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 10:38:41 2017 -0400

----------------------------------------------------------------------
 .../math4/ode/nonstiff/ClassicalRungeKuttaStepInterpolator.java   | 2 +-
 .../commons/math4/ode/nonstiff/EulerFieldStepInterpolator.java    | 2 +-
 .../apache/commons/math4/ode/nonstiff/EulerStepInterpolator.java  | 2 +-
 .../apache/commons/math4/ode/nonstiff/GillStepInterpolator.java   | 2 +-
 .../math4/ode/nonstiff/GraggBulirschStoerStepInterpolator.java    | 3 +--
 .../commons/math4/ode/nonstiff/MidpointStepInterpolator.java      | 2 +-
 .../math4/ode/nonstiff/ThreeEighthesFieldStepInterpolator.java    | 2 +-
 .../commons/math4/ode/nonstiff/ThreeEighthesStepInterpolator.java | 2 +-
 8 files changed, 8 insertions(+), 9 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/5634d8c4/src/main/java/org/apache/commons/math4/ode/nonstiff/ClassicalRungeKuttaStepInterpolator.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ode/nonstiff/ClassicalRungeKuttaStepInterpolator.java b/src/main/java/org/apache/commons/math4/ode/nonstiff/ClassicalRungeKuttaStepInterpolator.java
index 8ae949a..103c0e7 100644
--- a/src/main/java/org/apache/commons/math4/ode/nonstiff/ClassicalRungeKuttaStepInterpolator.java
+++ b/src/main/java/org/apache/commons/math4/ode/nonstiff/ClassicalRungeKuttaStepInterpolator.java
@@ -45,7 +45,7 @@ import org.apache.commons.math4.ode.sampling.StepInterpolator;
  *
  * where &theta; belongs to [0 ; 1] and where y'<sub>1</sub> to y'<sub>4</sub> are the four
  * evaluations of the derivatives already computed during the
- * step.</p>
+ * step.
  *
  * @see ClassicalRungeKuttaIntegrator
  * @since 1.2

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5634d8c4/src/main/java/org/apache/commons/math4/ode/nonstiff/EulerFieldStepInterpolator.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ode/nonstiff/EulerFieldStepInterpolator.java b/src/main/java/org/apache/commons/math4/ode/nonstiff/EulerFieldStepInterpolator.java
index 2b084aa..81144e9 100644
--- a/src/main/java/org/apache/commons/math4/ode/nonstiff/EulerFieldStepInterpolator.java
+++ b/src/main/java/org/apache/commons/math4/ode/nonstiff/EulerFieldStepInterpolator.java
@@ -38,7 +38,7 @@ import org.apache.commons.math4.ode.FieldODEStateAndDerivative;
  * </ul>
  *
  * where &theta; belongs to [0 ; 1] and where y' is the evaluation of
- * the derivatives already computed during the step.</p>
+ * the derivatives already computed during the step.
  *
  * @see EulerFieldIntegrator
  * @param <T> the type of the field elements

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5634d8c4/src/main/java/org/apache/commons/math4/ode/nonstiff/EulerStepInterpolator.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ode/nonstiff/EulerStepInterpolator.java b/src/main/java/org/apache/commons/math4/ode/nonstiff/EulerStepInterpolator.java
index b693a9d..08f2d9c 100644
--- a/src/main/java/org/apache/commons/math4/ode/nonstiff/EulerStepInterpolator.java
+++ b/src/main/java/org/apache/commons/math4/ode/nonstiff/EulerStepInterpolator.java
@@ -35,7 +35,7 @@ import org.apache.commons.math4.ode.sampling.StepInterpolator;
  * </ul>
  *
  * where &theta; belongs to [0 ; 1] and where y' is the evaluation of
- * the derivatives already computed during the step.</p>
+ * the derivatives already computed during the step.
  *
  * @see EulerIntegrator
  * @since 1.2

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5634d8c4/src/main/java/org/apache/commons/math4/ode/nonstiff/GillStepInterpolator.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ode/nonstiff/GillStepInterpolator.java b/src/main/java/org/apache/commons/math4/ode/nonstiff/GillStepInterpolator.java
index 033c367..0382190 100644
--- a/src/main/java/org/apache/commons/math4/ode/nonstiff/GillStepInterpolator.java
+++ b/src/main/java/org/apache/commons/math4/ode/nonstiff/GillStepInterpolator.java
@@ -45,7 +45,7 @@ import org.apache.commons.math4.util.FastMath;
  * </ul>
  * where &theta; belongs to [0 ; 1] and where y'<sub>1</sub> to y'<sub>4</sub>
  * are the four evaluations of the derivatives already computed during
- * the step.</p>
+ * the step.
  *
  * @see GillIntegrator
  * @since 1.2

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5634d8c4/src/main/java/org/apache/commons/math4/ode/nonstiff/GraggBulirschStoerStepInterpolator.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ode/nonstiff/GraggBulirschStoerStepInterpolator.java b/src/main/java/org/apache/commons/math4/ode/nonstiff/GraggBulirschStoerStepInterpolator.java
index a991221..6b107e0 100644
--- a/src/main/java/org/apache/commons/math4/ode/nonstiff/GraggBulirschStoerStepInterpolator.java
+++ b/src/main/java/org/apache/commons/math4/ode/nonstiff/GraggBulirschStoerStepInterpolator.java
@@ -41,9 +41,8 @@ import org.apache.commons.math4.util.FastMath;
  * for this code is available <a
  * href="http://www.unige.ch/~hairer/prog/licence.txt">here</a>, for
  * convenience, it is reproduced below.</p>
- * </p>
  *
- * <table border="0" width="80%" cellpadding="10" align="center" bgcolor="#E0E0E0">
+ * <table border="0" width="80%" cellpadding="10" style="text-align: center; background-color: #E0E0E0;" summary="odex redistribution policy">
  * <tr><td>Copyright (c) 2004, Ernst Hairer</td></tr>
  *
  * <tr><td>Redistribution and use in source and binary forms, with or

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5634d8c4/src/main/java/org/apache/commons/math4/ode/nonstiff/MidpointStepInterpolator.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ode/nonstiff/MidpointStepInterpolator.java b/src/main/java/org/apache/commons/math4/ode/nonstiff/MidpointStepInterpolator.java
index 96446b2..85fb59b 100644
--- a/src/main/java/org/apache/commons/math4/ode/nonstiff/MidpointStepInterpolator.java
+++ b/src/main/java/org/apache/commons/math4/ode/nonstiff/MidpointStepInterpolator.java
@@ -37,7 +37,7 @@ import org.apache.commons.math4.ode.sampling.StepInterpolator;
  *
  * where &theta; belongs to [0 ; 1] and where y'<sub>1</sub> and y'<sub>2</sub> are the two
  * evaluations of the derivatives already computed during the
- * step.</p>
+ * step.
  *
  * @see MidpointIntegrator
  * @since 1.2

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5634d8c4/src/main/java/org/apache/commons/math4/ode/nonstiff/ThreeEighthesFieldStepInterpolator.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ode/nonstiff/ThreeEighthesFieldStepInterpolator.java b/src/main/java/org/apache/commons/math4/ode/nonstiff/ThreeEighthesFieldStepInterpolator.java
index 17d41cd..d9ec7a2 100644
--- a/src/main/java/org/apache/commons/math4/ode/nonstiff/ThreeEighthesFieldStepInterpolator.java
+++ b/src/main/java/org/apache/commons/math4/ode/nonstiff/ThreeEighthesFieldStepInterpolator.java
@@ -50,7 +50,7 @@ import org.apache.commons.math4.ode.FieldODEStateAndDerivative;
  *
  * where &theta; belongs to [0 ; 1] and where y'<sub>1</sub> to y'<sub>4</sub> are the four
  * evaluations of the derivatives already computed during the
- * step.</p>
+ * step.
  *
  * @see ThreeEighthesFieldIntegrator
  * @param <T> the type of the field elements

http://git-wip-us.apache.org/repos/asf/commons-math/blob/5634d8c4/src/main/java/org/apache/commons/math4/ode/nonstiff/ThreeEighthesStepInterpolator.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/ode/nonstiff/ThreeEighthesStepInterpolator.java b/src/main/java/org/apache/commons/math4/ode/nonstiff/ThreeEighthesStepInterpolator.java
index b94b61c..a9d6361 100644
--- a/src/main/java/org/apache/commons/math4/ode/nonstiff/ThreeEighthesStepInterpolator.java
+++ b/src/main/java/org/apache/commons/math4/ode/nonstiff/ThreeEighthesStepInterpolator.java
@@ -47,7 +47,7 @@ import org.apache.commons.math4.ode.sampling.StepInterpolator;
  *
  * where &theta; belongs to [0 ; 1] and where y'<sub>1</sub> to y'<sub>4</sub> are the four
  * evaluations of the derivatives already computed during the
- * step.</p>
+ * step.
  *
  * @see ThreeEighthesIntegrator
  * @since 1.2

[03/15] [math] Fix javadoc issues

Posted by ra...@apache.org.
Fix javadoc issues

Project: http://git-wip-us.apache.org/repos/asf/commons-math/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-math/commit/f2eaada9
Tree: http://git-wip-us.apache.org/repos/asf/commons-math/tree/f2eaada9
Diff: http://git-wip-us.apache.org/repos/asf/commons-math/diff/f2eaada9

Branch: refs/heads/master
Commit: f2eaada92d2f1391ede472b1bf468d99ebb92497
Parents: e94dbfd
Author: Ray DeCampo <ra...@decampo.org>
Authored: Sat May 13 09:21:02 2017 -0400
Committer: Ray DeCampo <ra...@decampo.org>
Committed: Sat May 13 09:21:02 2017 -0400

----------------------------------------------------------------------
 .../commons/math4/geometry/euclidean/threed/FieldRotation.java | 6 +++---
 .../commons/math4/geometry/euclidean/threed/Rotation.java      | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-math/blob/f2eaada9/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/FieldRotation.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/FieldRotation.java b/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/FieldRotation.java
index d3853c0..d4c7a18 100644
--- a/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/FieldRotation.java
+++ b/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/FieldRotation.java
@@ -234,7 +234,7 @@ public class FieldRotation<T extends RealFieldElement<T>> implements Serializabl
      * <p>If the angular separation between u<sub>1</sub> and u<sub>2</sub> is
      * not the same as the angular separation between v<sub>1</sub> and
      * v<sub>2</sub>, then a corrected v'<sub>2</sub> will be used rather than
-     * v<sub>2</sub>, the corrected vector will be in the (&pm;v<sub>1</sub>,
+     * v<sub>2</sub>, the corrected vector will be in the (&plusmn;v<sub>1</sub>,
      * +v<sub>2</sub>) half-plane.</p>
 
      * @param u1 first vector of the origin pair
@@ -1637,9 +1637,9 @@ public class FieldRotation<T extends RealFieldElement<T>> implements Serializabl
      * or very different. It is mathematically defined as the angle of
      * the rotation r that prepended to one of the rotations gives the other
      * one:</p>
-     * <pre>
+     * <div style="white-space: pre"><code>
      *        r<sub>1</sub>(r) = r<sub>2</sub>
-     * </pre>
+     * </code></div>
      * <p>This distance is an angle between 0 and &pi;. Its value is the smallest
      * possible upper bound of the angle in radians between r<sub>1</sub>(v)
      * and r<sub>2</sub>(v) for all possible vectors v. This upper bound is

http://git-wip-us.apache.org/repos/asf/commons-math/blob/f2eaada9/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/Rotation.java
----------------------------------------------------------------------
diff --git a/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/Rotation.java b/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/Rotation.java
index a14eb6f..59517ba 100644
--- a/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/Rotation.java
+++ b/src/main/java/org/apache/commons/math4/geometry/euclidean/threed/Rotation.java
@@ -262,7 +262,7 @@ public class Rotation implements Serializable {
    * <p>If the angular separation between u<sub>1</sub> and u<sub>2</sub> is
    * not the same as the angular separation between v<sub>1</sub> and
    * v<sub>2</sub>, then a corrected v'<sub>2</sub> will be used rather than
-   * v<sub>2</sub>, the corrected vector will be in the (&pm;v<sub>1</sub>,
+   * v<sub>2</sub>, the corrected vector will be in the (&plusmn;v<sub>1</sub>,
    * +v<sub>2</sub>) half-plane.</p>
 
    * @param u1 first vector of the origin pair
@@ -1399,9 +1399,9 @@ public class Rotation implements Serializable {
    * or very different. It is mathematically defined as the angle of
    * the rotation r that prepended to one of the rotations gives the other
    * one:</p>
-   * <pre>
+   * <div style="white-space: pre"><code>
    *        r<sub>1</sub>(r) = r<sub>2</sub>
-   * </pre>
+   * </code></div>
    * <p>This distance is an angle between 0 and &pi;. Its value is the smallest
    * possible upper bound of the angle in radians between r<sub>1</sub>(v)
    * and r<sub>2</sub>(v) for all possible vectors v. This upper bound is