From cc4cb7ade402aef25187ecae9fddb459e40d3c4a Mon Sep 17 00:00:00 2001
From: hidingmyname <140602238+hidingmyname@users.noreply.github.com>
Date: Fri, 30 Oct 2026 02:32:04 +0800
Subject: [PATCH] Correct stale Javadoc links, parameters, and return
 descriptions

Signed-off-by: hidingmyname <140602238+hidingmyname@users.noreply.github.com>
---
 .../core/src/main/java/org/locationtech/jts/math/DD.java   | 7 ++++---
 .../jts/operation/overlayng/PrecisionUtil.java             | 4 ++--
 .../jts/operation/relateng/RelatePointLocator.java         | 7 ++++---
 .../jts/triangulate/polygon/TriDelaunayImprover.java       | 4 ++--
 4 files changed, 12 insertions(+), 10 deletions(-)
 mode change 100755 => 100644 modules/core/src/main/java/org/locationtech/jts/triangulate/polygon/TriDelaunayImprover.java

diff --git a/modules/core/src/main/java/org/locationtech/jts/math/DD.java b/modules/core/src/main/java/org/locationtech/jts/math/DD.java
index 11e26c069e..12e1c49891 100644
--- a/modules/core/src/main/java/org/locationtech/jts/math/DD.java
+++ b/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)
diff --git a/modules/core/src/main/java/org/locationtech/jts/operation/overlayng/PrecisionUtil.java b/modules/core/src/main/java/org/locationtech/jts/operation/overlayng/PrecisionUtil.java
index 676128df3d..8a1c54b2c7 100644
--- a/modules/core/src/main/java/org/locationtech/jts/operation/overlayng/PrecisionUtil.java
+++ b/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)
diff --git a/modules/core/src/main/java/org/locationtech/jts/operation/relateng/RelatePointLocator.java b/modules/core/src/main/java/org/locationtech/jts/operation/relateng/RelatePointLocator.java
index c6f63680f0..20381ded11 100644
--- a/modules/core/src/main/java/org/locationtech/jts/operation/relateng/RelatePointLocator.java
+++ b/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)
   {
diff --git a/modules/core/src/main/java/org/locationtech/jts/triangulate/polygon/TriDelaunayImprover.java b/modules/core/src/main/java/org/locationtech/jts/triangulate/polygon/TriDelaunayImprover.java
old mode 100755
new mode 100644
index c57d03e278..5acd0cf3b7
--- a/modules/core/src/main/java/org/locationtech/jts/triangulate/polygon/TriDelaunayImprover.java
+++ b/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) {