Correct stale Javadoc links, parameters, and return descriptions

modules/core/src/main/java/org/locationtech/jts/math/DD.java

@@ -1167,13 +1167,14 @@ public String toSciNotation()
 
 
   /**
-   * Extracts the significant digits in the decimal representation of the argument.
+   * Extracts the significant digits in the decimal representation of the absolute value of this number.
    * A decimal point may be optionally inserted in the string of digits
    * (as long as its position lies within the extracted digits
    * - if not, the caller must prepend or append the appropriate zeroes and decimal point).
    * 
-   * @param y the number to extract ( >= 0)
-   * @param decimalPointPos the position in which to insert a decimal point
+   * @param insertDecimalPoint whether to insert a decimal point in the string of digits
+   * @param magnitude a 1-element array which receives the decimal magnitude
+   *   (base-10 exponent) of the number
    * @return the string containing the significant digits and possibly a decimal point
    */
   private String extractSignificantDigits(boolean insertDecimalPoint, int[] magnitude)

modules/core/src/main/java/org/locationtech/jts/operation/overlayng/PrecisionUtil.java

@@ -142,13 +142,13 @@ private static double maxBoundMagnitude(Envelope env) {
    * for 3 digits of precision the scale factor is 1;
    * for 2 digits of precision the scale factor is 0.1. 
    * <p>
-   * Rounding to the scale factor can be performed with {@link PrecisionModel#round}
+   * Rounding to the scale factor can be performed with {@link PrecisionModel#makePrecise(double)}
    * 
    * @param value a number to be rounded
    * @param precisionDigits the number of digits of precision required
    * @return scale factor which provides the required number of digits of precision 
    * 
-   * @see PrecisionModel.round
+   * @see PrecisionModel#makePrecise(Coordinate)
    */
   private static double precisionScale(
       double value, int precisionDigits)

modules/core/src/main/java/org/locationtech/jts/operation/relateng/RelatePointLocator.java

@@ -203,7 +203,7 @@ public int locateNodeWithDim(Coordinate p, Geometry parentPolygonal) {
    * takes into account the SFS Boundary Determination Rule.
    *
    * @param p the point to locate
-   * @return the {@link Location} of the point relative to the input Geometry
+   * @return the {@link DimensionLocation} of the point relative to the input Geometry
    */
   public int locateWithDim(Coordinate p) {
     return locateWithDim(p, false, null);
@@ -219,8 +219,9 @@ public int locateWithDim(Coordinate p) {
    *
    * @param p the coordinate to locate
    * @param isNode whether the coordinate is a node (on an edge) of the geometry
-   * @param polygon 
-   * @return the {@link Location} of the point relative to the input Geometry
+   * @param parentPolygonal the polygon the point is a node of (may be null if isNode is false)
+   * @return the dimension and location of the point relative to the input Geometry,
+   *   as a {@link DimensionLocation} code
    */
   private int locateWithDim(Coordinate p, boolean isNode, Geometry parentPolygonal)
   {

modules/core/src/main/java/org/locationtech/jts/triangulate/polygon/TriDelaunayImprover.java

@@ -86,8 +86,8 @@ private int improveScan(List<Tri> triList) {
   /**
    * Does a flip of the common edge of two Tris if the Delaunay condition is not met.
    * 
-   * @param tri0 a Tri
-   * @param tri1 a Tri
+   * @param tri a Tri
+   * @param index the index of the edge of tri to test
    * @return true if the triangles were flipped
    */
   private boolean improveNonDelaunay(Tri tri, int index) {