improved javadoc

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

src/main/java/org/apache/commons/math3/geometry/partitioning/BoundaryAttribute.java

@@ -21,9 +21,10 @@ import org.apache.commons.math3.geometry.Space;
 /** Class holding boundary attributes.
  * <p>This class is used for the attributes associated with the
  * nodes of region boundary shell trees returned by the {@link
- * Region#getTree Region.getTree}. It contains the
- * parts of the node cut sub-hyperplane that belong to the
- * boundary.</p>
+ * Region#getTree(boolean) Region.getTree(includeBoundaryAttributes)}
+ * when the boolean {@code includeBoundaryAttributes} parameter is
+ * set to {@code true}. It contains the parts of the node cut
+ * sub-hyperplane that belong to the boundary.</p>
  * <p>This class is a simple placeholder, it does not provide any
  * processing methods.</p>
  * @param <S> Type of the space.

src/main/java/org/apache/commons/math3/geometry/partitioning/Region.java

@@ -136,10 +136,10 @@ public interface Region<S extends Space> {
      * all internal nodes are guaranteed to have non-null
      * attributes, however some {@link BoundaryAttribute
      * BoundaryAttribute} instances may have their {@link
-     * BoundaryAttribute#plusInside plusInside} and {@link
-     * BoundaryAttribute#plusOutside plusOutside} fields both null if
-     * the corresponding cut sub-hyperplane does not have any parts
-     * belonging to the boundary.</p>
+     * BoundaryAttribute#getPlusInside() getPlusInside} and {@link
+     * BoundaryAttribute#getPlusOutside() getPlusOutside} methods both
+     * returning null if the corresponding cut sub-hyperplane does not
+     * have any parts belonging to the boundary.</p>
 
      * <p>Since computing the boundary is not always required and can be
      * time-consuming for large trees, these internal nodes attributes

src/main/java/org/apache/commons/math3/geometry/spherical/oned/ArcsSet.java

@@ -889,8 +889,8 @@ public class ArcsSet extends AbstractRegion<Sphere1D, Sphere1D> implements Itera
     /** Specialized exception for inconsistent BSP tree state inconsistency.
      * <p>
      * This exception is thrown at {@link ArcsSet} construction time when the
-     * {@link Location inside/outside} state is not consistent at the 0,
-     * \(2 \pi \) crossing.
+     * {@link org.apache.commons.math3.geometry.partitioning.Region.Location inside/outside}
+     * state is not consistent at the 0, \(2 \pi \) crossing.
      * </p>
      */
     public static class InconsistentStateAt2PiWrapping extends MathIllegalArgumentException {