This is an automated email from the ASF dual-hosted git repository.
desruisseaux pushed a commit to branch geoapi-4.0
in repository https://gitbox.apache.org/repos/asf/sis.git
The following commit(s) were added to refs/heads/geoapi-4.0 by this push:
new 8f18768388 Upgrade Apache parent POM. Fix some Javadoc warnings.
8f18768388 is described below
commit 8f187683882e7a031bbf00809f834ecaffeef132
Author: Martin Desruisseaux <[email protected]>
AuthorDate: Thu Jul 20 10:59:08 2023 +0200
Upgrade Apache parent POM.
Fix some Javadoc warnings.
---
.../main/java/org/apache/sis/internal/gui/Resources.java | 2 +-
.../java/org/apache/sis/cloud/aws/internal/Resources.java | 2 +-
.../java/org/apache/sis/feature/ExpressionOperation.java | 5 ++++-
.../src/main/java/org/apache/sis/image/ImageProcessor.java | 7 ++++---
.../sis/internal/coverage/j2d/ColorModelBuilder.java | 4 ++--
.../org/apache/sis/internal/coverage/j2d/FillValues.java | 1 +
.../apache/sis/internal/coverage/j2d/TilePlaceholder.java | 6 ++++--
.../org/apache/sis/internal/coverage/j2d/TiledImage.java | 2 +-
.../java/org/apache/sis/internal/feature/Geometries.java | 2 +-
.../org/apache/sis/internal/feature/GeometryWrapper.java | 2 +-
.../java/org/apache/sis/internal/feature/Resources.java | 2 +-
.../org/apache/sis/internal/feature/esri/package-info.java | 5 +----
.../org/apache/sis/internal/feature/j2d/package-info.java | 5 +----
.../main/java/org/apache/sis/internal/feature/jts/JTS.java | 5 +++--
.../java/org/apache/sis/internal/filter/EditVisitor.java | 2 ++
.../src/main/java/org/apache/sis/internal/filter/Node.java | 2 +-
.../main/java/org/apache/sis/internal/filter/Visitor.java | 4 ++--
.../main/java/org/apache/sis/internal/filter/XPath.java | 2 +-
.../apache/sis/internal/filter/sqlmm/SpatialFunction.java | 3 ++-
.../internal/jaxb/metadata/replace/ServiceParameter.java | 4 ++--
.../java/org/apache/sis/internal/metadata/Resources.java | 2 +-
.../java/org/apache/sis/test/xml/DocumentComparator.java | 2 +-
.../apache/sis/internal/map/coverage/RenderingData.java | 2 +-
.../src/main/java/org/apache/sis/style/package-info.java | 2 +-
.../src/main/java/org/apache/sis/style/se1/Fill.java | 2 +-
.../main/java/org/apache/sis/style/se1/LinePlacement.java | 2 +-
.../src/main/java/org/apache/sis/style/se1/Stroke.java | 2 +-
.../main/java/org/apache/sis/style/se1/package-info.java | 2 +-
.../java/org/apache/sis/internal/gazetteer/Resources.java | 2 +-
.../jaxb/referencing/CC_GeneralOperationParameter.java | 2 +-
.../jaxb/referencing/CC_OperationParameterGroup.java | 2 +-
.../sis/internal/jaxb/referencing/RS_Identifier.java | 2 +-
.../org/apache/sis/internal/referencing/Arithmetic.java | 9 +++++----
.../sis/internal/referencing/DefinitionVerifier.java | 4 ++--
.../java/org/apache/sis/internal/referencing/LazySet.java | 3 +--
.../org/apache/sis/internal/referencing/Resources.java | 2 +-
.../apache/sis/internal/referencing/j2d/AbstractShape.java | 2 +-
.../apache/sis/internal/referencing/j2d/package-info.java | 5 +----
.../internal/referencing/provider/DatumShiftGridFile.java | 12 ++++++++++--
.../internal/referencing/provider/DatumShiftGridGroup.java | 6 +++++-
.../internal/referencing/provider/GeocentricAffine.java | 1 +
.../operation/DefaultCoordinateOperationFactory.java | 2 +-
.../sis/referencing/operation/DefaultOperationMethod.java | 2 +-
.../referencing/operation/projection/AlbersEqualArea.java | 2 +-
.../referencing/operation/transform/ScaleTransform.java | 2 +-
.../operation/transform/SphericalToCartesian.java | 2 +-
.../referencing/operation/DefaultOperationMethodTest.java | 3 +--
.../org/apache/sis/internal/converter/ArrayConverter.java | 6 +++++-
.../sis/internal/converter/CharSequenceConverter.java | 5 ++++-
.../apache/sis/internal/converter/CollectionConverter.java | 5 ++++-
.../org/apache/sis/internal/converter/DateConverter.java | 5 ++++-
.../org/apache/sis/internal/converter/PathConverter.java | 6 +++++-
.../org/apache/sis/internal/converter/StringConverter.java | 5 ++++-
.../java/org/apache/sis/internal/util/CollectionsExt.java | 2 --
.../org/apache/sis/util/ResourceInternationalString.java | 4 ++--
.../main/java/org/apache/sis/util/collection/Cache.java | 2 --
pom.xml | 2 +-
.../java/org/apache/sis/internal/earth/netcdf/GCOM_C.java | 2 +-
.../java/org/apache/sis/internal/earth/netcdf/GCOM_W.java | 2 +-
.../java/org/apache/sis/internal/geotiff/Compression.java | 2 +-
.../java/org/apache/sis/internal/geotiff/Predictor.java | 2 +-
.../java/org/apache/sis/internal/geotiff/Resources.java | 2 +-
.../org/apache/sis/storage/geotiff/GeoIdentifiers.java | 2 +-
.../java/org/apache/sis/storage/geotiff/GeoKeysTest.java | 14 ++++++++++----
.../java/org/apache/sis/internal/netcdf/Resources.java | 2 +-
.../main/java/org/apache/sis/internal/netcdf/Variable.java | 2 +-
.../java/org/apache/sis/internal/sql/feature/Database.java | 2 +-
.../org/apache/sis/internal/sql/feature/Resources.java | 2 +-
.../java/org/apache/sis/internal/sql/postgis/Postgres.java | 2 +-
.../apache/sis/internal/storage/FeatureCatalogBuilder.java | 2 +-
.../apache/sis/internal/storage/GridResourceWrapper.java | 4 +++-
.../org/apache/sis/internal/storage/MemoryFeatureSet.java | 2 +-
.../apache/sis/internal/storage/MemoryGridResource.java | 2 +-
.../java/org/apache/sis/internal/storage/Resources.java | 2 +-
.../apache/sis/internal/storage/wkt/FirstKeywordPeek.java | 6 +++---
.../org/apache/sis/internal/storage/wkt/StoreFormat.java | 1 +
.../org/apache/sis/internal/storage/xml/package-info.java | 2 +-
.../src/main/java/org/apache/sis/storage/FeatureQuery.java | 2 +-
.../org/apache/sis/internal/storage/gpx/WritableStore.java | 2 +-
.../sis/internal/storage/xml/stream/StaxStreamIO.java | 2 +-
80 files changed, 146 insertions(+), 107 deletions(-)
diff --git
a/application/sis-javafx/src/main/java/org/apache/sis/internal/gui/Resources.java
b/application/sis-javafx/src/main/java/org/apache/sis/internal/gui/Resources.java
index b65b4ca7e2..c9a4f33226 100644
---
a/application/sis-javafx/src/main/java/org/apache/sis/internal/gui/Resources.java
+++
b/application/sis-javafx/src/main/java/org/apache/sis/internal/gui/Resources.java
@@ -31,7 +31,7 @@ import org.apache.sis.util.resources.IndexedResourceBundle;
/**
* Messages that are specific to the {@code sis-javafx} module.
* Resources in this file should not be used by any other module. For
resources shared by
- * all modules in the Apache SIS project, see {@link
org.apache.sis.util.resources} package.
+ * all modules in the Apache SIS project, see {@code
org.apache.sis.util.resources} package.
*
* @author Johann Sorel (Geomatys)
* @version 1.4
diff --git
a/cloud/sis-cloud-aws/src/main/java/org/apache/sis/cloud/aws/internal/Resources.java
b/cloud/sis-cloud-aws/src/main/java/org/apache/sis/cloud/aws/internal/Resources.java
index 871b6feb90..ae0d3e93de 100644
---
a/cloud/sis-cloud-aws/src/main/java/org/apache/sis/cloud/aws/internal/Resources.java
+++
b/cloud/sis-cloud-aws/src/main/java/org/apache/sis/cloud/aws/internal/Resources.java
@@ -26,7 +26,7 @@ import org.apache.sis.util.resources.IndexedResourceBundle;
/**
* Warning and error messages that are specific to the {@code sis-cloud-aws}
module.
* Resources in this file should not be used by any other module. For
resources shared by
- * all modules in the Apache SIS project, see {@link
org.apache.sis.util.resources} package.
+ * all modules in the Apache SIS project, see {@code
org.apache.sis.util.resources} package.
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.4
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/feature/ExpressionOperation.java
b/core/sis-feature/src/main/java/org/apache/sis/feature/ExpressionOperation.java
index 4ac9906e60..c767d08f0a 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/feature/ExpressionOperation.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/feature/ExpressionOperation.java
@@ -46,7 +46,10 @@ import org.opengis.filter.ValueReference;
*
* @author Johann Sorel (Geomatys)
* @version 1.4
- * @since 1.4
+ *
+ * @param <V> class of values computed by the operation.
+ *
+ * @since 1.4
*/
final class ExpressionOperation<V> extends AbstractOperation {
/**
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/image/ImageProcessor.java
b/core/sis-feature/src/main/java/org/apache/sis/image/ImageProcessor.java
index 333156b27c..31c4e85696 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/image/ImageProcessor.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/image/ImageProcessor.java
@@ -1100,6 +1100,7 @@ public class ImageProcessor implements Cloneable {
*
* @param colorModel color model of resulting image, or {@code null}.
*/
+ @SuppressWarnings("doclint:missing")
@Deprecated(since="1.4", forRemoval=true)
public synchronized RenderedImage convert(final RenderedImage source,
final NumberRange<?>[] sourceRanges,
MathTransform1D[] converters, final DataType targetType, final
ColorModel colorModel)
@@ -1281,7 +1282,7 @@ public class ImageProcessor implements Cloneable {
* @param colors colors to use for each range of values in the source
image.
* @deprecated Replaced by {@link #visualize(RenderedImage)} with colors
map inferred from the {@link Colorizer}.
*/
- @SuppressWarnings("removal")
+ @SuppressWarnings({"removal", "doclint:missing"})
@Deprecated(since="1.4", forRemoval=true)
public synchronized RenderedImage visualize(final RenderedImage source,
final Map<NumberRange<?>,Color[]> colors) {
/*
@@ -1306,7 +1307,7 @@ public class ImageProcessor implements Cloneable {
* @param ranges description of {@code source} bands, or {@code null} if
none. This is typically
* obtained by {@link
org.apache.sis.coverage.grid.GridCoverage#getSampleDimensions()}.
*/
- @SuppressWarnings("removal")
+ @SuppressWarnings({"removal", "doclint:missing"})
@Deprecated(since="1.4", forRemoval=true)
public RenderedImage visualize(final RenderedImage source, final
List<SampleDimension> ranges) {
ArgumentChecks.ensureNonNull("source", source);
@@ -1460,7 +1461,7 @@ public class ImageProcessor implements Cloneable {
* @param ranges description of {@code source} bands, or {@code null} if
none. This is typically
* obtained by {@link
org.apache.sis.coverage.grid.GridCoverage#getSampleDimensions()}.
*/
- @SuppressWarnings("removal")
+ @SuppressWarnings({"removal", "doclint:missing"})
@Deprecated(since="1.4", forRemoval=true)
public RenderedImage visualize(final RenderedImage source, final Rectangle
bounds, final MathTransform toSource,
final List<SampleDimension> ranges)
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/ColorModelBuilder.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/ColorModelBuilder.java
index 4a7214fca0..4640a3a02f 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/ColorModelBuilder.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/ColorModelBuilder.java
@@ -66,7 +66,7 @@ import org.apache.sis.util.resources.Vocabulary;
* @version 1.4
*
* @see ColorModelType
- * @see ColorModelFactory#createColorModel(int, int, int, Collection)
+ * @see ColorModelFactory#createColorModel(int, int, int)
*
* @since 1.1
*/
@@ -111,7 +111,7 @@ public final class ColorModelBuilder {
/**
* Applies a gray scale to quantitative category and transparent colors to
qualitative categories.
- * This is a possible argument for the {@link
#ColorModelBuilder(Function)} constructor.
+ * This is a possible argument for the {@link #ColorModelBuilder(Function,
ColorModel, boolean)} constructor.
*/
public static final Function<Category,Color[]> GRAYSCALE =
(category) -> category.isQuantitative() ? new Color[]
{Color.BLACK, Color.WHITE} : null;
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/FillValues.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/FillValues.java
index 6422282fa9..382c50b8f2 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/FillValues.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/FillValues.java
@@ -21,6 +21,7 @@ import java.util.Objects;
import java.lang.reflect.Array;
import java.awt.image.DataBuffer;
import java.awt.image.SampleModel;
+import java.awt.image.Raster;
import java.awt.image.WritableRaster;
import java.awt.image.WritableRenderedImage;
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/TilePlaceholder.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/TilePlaceholder.java
index aa168ca50e..6302a2ea70 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/TilePlaceholder.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/TilePlaceholder.java
@@ -25,6 +25,7 @@ import java.awt.image.DataBuffer;
import java.awt.image.Raster;
import java.awt.image.WritableRaster;
import java.awt.image.RenderedImage;
+import java.awt.image.BufferedImage;
import java.lang.ref.WeakReference;
import org.apache.sis.util.Disposable;
import org.apache.sis.util.Workaround;
@@ -48,8 +49,9 @@ public class TilePlaceholder {
* Identifies workaround for two JDK bugs.
*
* <p><a
href="https://bugs.openjdk.java.net/browse/JDK-8166038";>JDK-8166038</a>:
- * If {@link BufferedImage} cannot be used, fallback on {@link
ReshapedImage} at the cost of an image
- * larger than necessary. In such case, the tests need to specify the
sub-region of pixels to verify.</p>
+ * If {@link BufferedImage} cannot be used, fallback on {@link
org.apache.sis.coverage.grid.ReshapedImage}
+ * at the cost of an image larger than necessary. In such case, the tests
need to specify the sub-region
+ * of pixels to verify.</p>
*
* <p><a
href="https://bugs.openjdk.java.net/browse/JDK-8275345";>JDK-8275345</a>:
* call to {@code Graphics2D.drawRenderedImage(…)} fails if the image
contains more than one tile
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/TiledImage.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/TiledImage.java
index 8265fe0b73..cc651f0034 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/TiledImage.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/TiledImage.java
@@ -99,7 +99,7 @@ public class TiledImage extends PlanarImage {
* Verifies whether image layout information and tile coordinates are
consistent.
* This method verifies the size and minimum pixel coordinates of all
tiles.
* If okay, then this method completes the check with all verifications
- * {@linkplain ComputedImage#verify() documented in parent class}
+ * {@linkplain PlanarImage#verify() documented in parent class}
*
* @return {@code null} if image layout information are consistent,
* or the name of inconsistent attribute if a problem is found.
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/Geometries.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/Geometries.java
index d27ed08806..564d4fa847 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/Geometries.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/Geometries.java
@@ -48,7 +48,7 @@ import org.apache.sis.util.resources.Errors;
* <h2>Serialization</h2>
* All fields except {@link #library} should be declared {@code transient}.
* Deserialized {@code Geometries} instances shall be replaced by a unique
instance,
- * which is given by {@link #readResolve()}.
+ * which is given by {@code readResolve()} methods defined in each subclass.
*
* @param <G> the base class of all geometry objects (except point in some
implementations).
*
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/GeometryWrapper.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/GeometryWrapper.java
index 2f7d9a14f3..0a4a95e6bf 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/GeometryWrapper.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/GeometryWrapper.java
@@ -479,7 +479,7 @@ public abstract class GeometryWrapper extends
AbstractGeometry implements Geomet
* If the given CRS is null, then the geometry is returned unchanged.
* If this geometry has no Coordinate Reference System, a {@link
TransformException} is thrown.
*
- * <p>Consider using {@link #transform(CoordinateOperation)} instead of
this method as much as possible,
+ * <p>Consider using {@link #transform(CoordinateOperation, boolean)}
instead of this method as much as possible,
* both for performance reasons and because not all geometry libraries
provide information about the CRS
* of their geometries.</p>
*
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/Resources.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/Resources.java
index 442ac612e1..91227aab81 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/Resources.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/Resources.java
@@ -29,7 +29,7 @@ import org.apache.sis.util.resources.IndexedResourceBundle;
/**
* Warning and error messages that are specific to the {@code sis-feature}
module.
* Resources in this file should not be used by any other module. For
resources shared by
- * all modules in the Apache SIS project, see {@link
org.apache.sis.util.resources} package.
+ * all modules in the Apache SIS project, see {@code
org.apache.sis.util.resources} package.
*
* @author Martin Desruisseaux (IRD, Geomatys)
* @version 1.4
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/esri/package-info.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/esri/package-info.java
index f14631668b..459e307b18 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/esri/package-info.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/esri/package-info.java
@@ -26,9 +26,6 @@
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.4
- *
- * @see org.apache.sis.internal.referencing.j2d
- *
- * @since 1.1
+ * @since 1.1
*/
package org.apache.sis.internal.feature.esri;
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/j2d/package-info.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/j2d/package-info.java
index 820103b222..206ebc33c7 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/j2d/package-info.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/j2d/package-info.java
@@ -26,9 +26,6 @@
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.4
- *
- * @see org.apache.sis.internal.referencing.j2d
- *
- * @since 1.0
+ * @since 1.0
*/
package org.apache.sis.internal.feature.j2d;
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/jts/JTS.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/jts/JTS.java
index 75a8083777..11eeb17904 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/feature/jts/JTS.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/feature/jts/JTS.java
@@ -230,8 +230,9 @@ public final class JTS extends Static {
*
* <p><b>This operation may be slow!</b>
* If many geometries need to be transformed, it is better to fetch the
{@link CoordinateOperation} only once,
- * then invoke {@link #transform(Geometry, CoordinateOperation)} for each
geometry. Alternatively, the geometries
- * can be stored in a single geometry collection in order to invoke this
method only once.</p>
+ * then invoke {@link #transform(Geometry, CoordinateOperation, boolean)}
for each geometry.
+ * Alternatively, the geometries can be stored in a single geometry
collection
+ * in order to invoke this method only once.</p>
*
* @param geometry the geometry to transform, or {@code null}.
* @param targetCRS the target coordinate reference system, or {@code
null}.
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/filter/EditVisitor.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/filter/EditVisitor.java
index 8250d3db0a..50223dbded 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/filter/EditVisitor.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/filter/EditVisitor.java
@@ -16,8 +16,10 @@
*/
package org.apache.sis.internal.filter;
+import org.opengis.filter.Literal;
import org.opengis.filter.FilterFactory;
+
/**
* Visitor used to copy expressions and filters with same parameterized types.
* This class can be used when some filters need to be recreated with the same
types
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/filter/Node.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/filter/Node.java
index 77882fa9c2..847351bfde 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/internal/filter/Node.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/internal/filter/Node.java
@@ -158,7 +158,7 @@ public abstract class Node implements Serializable {
/**
* Creates a name in the "SIS" scope.
- * This is a helper method for {@link #getFunctionName()} implementations.
+ * This is a helper method for {@link Expression#getFunctionName()}
implementations.
*
* @param tip the expression name in SIS namespace.
* @return an expression name in the SIS namespace.
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/filter/Visitor.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/filter/Visitor.java
index 60945dfea5..9ca25ffcc9 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/internal/filter/Visitor.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/internal/filter/Visitor.java
@@ -308,7 +308,7 @@ public abstract class Visitor<R,A> {
* Adds the value to use or throws an exception when there is no action
registered for a given filter type.
* The default implementation throws {@link UnsupportedOperationException}.
*
- * @param type the filter type which has not been found, or
{@code null} if {@coce filter} is null.
+ * @param type the filter type which has not been found, or
{@code null} if {@code filter} is null.
* @param filter the filter (may be {@code null}).
* @param accumulator where to write the result of all actions.
* @throws UnsupportedOperationException if there is no default action.
@@ -321,7 +321,7 @@ public abstract class Visitor<R,A> {
* Adds the value to use or throws an exception when there is no action
registered for a given expression type.
* The default implementation throws {@link UnsupportedOperationException}.
*
- * @param type the expression type which has not been found, or
{@code null} if {@coce expression} is null.
+ * @param type the expression type which has not been found, or
{@code null} if {@code expression} is null.
* @param expression the expression (may be {@code null}).
* @param accumulator where to write the result of all actions.
* @throws UnsupportedOperationException if there is no default value.
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/filter/XPath.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/filter/XPath.java
index aa40ecceba..51dc7b8fb9 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/internal/filter/XPath.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/internal/filter/XPath.java
@@ -25,7 +25,7 @@ import static org.apache.sis.util.CharSequences.*;
/**
- * Basic support of X-Path in {@link PropertyValue} expression.
+ * Basic support of X-Path in {@code ValueReference} expression.
* This is intended to be only a lightweight support, not a replacement for
{@link javax.xml.xpath} implementations.
*
* @author Martin Desruisseaux (Geomatys)
diff --git
a/core/sis-feature/src/main/java/org/apache/sis/internal/filter/sqlmm/SpatialFunction.java
b/core/sis-feature/src/main/java/org/apache/sis/internal/filter/sqlmm/SpatialFunction.java
index 8376241a97..78c368a212 100644
---
a/core/sis-feature/src/main/java/org/apache/sis/internal/filter/sqlmm/SpatialFunction.java
+++
b/core/sis-feature/src/main/java/org/apache/sis/internal/filter/sqlmm/SpatialFunction.java
@@ -111,7 +111,8 @@ abstract class SpatialFunction<R> extends Node implements
FeatureExpression<R,Ob
}
/**
- * Invoked by {@link #getFunctionName()} when a name needs to be created.
+ * Invoked by {@link Expression#getFunctionName()} implementations
+ * when a name needs to be created.
*/
private static ScopedName createName(final SQLMM operation) {
return Names.createScopedName(SCOPE, null, operation.name());
diff --git
a/core/sis-metadata/src/main/java/org/apache/sis/internal/jaxb/metadata/replace/ServiceParameter.java
b/core/sis-metadata/src/main/java/org/apache/sis/internal/jaxb/metadata/replace/ServiceParameter.java
index f60638b183..750a4e1112 100644
---
a/core/sis-metadata/src/main/java/org/apache/sis/internal/jaxb/metadata/replace/ServiceParameter.java
+++
b/core/sis-metadata/src/main/java/org/apache/sis/internal/jaxb/metadata/replace/ServiceParameter.java
@@ -184,9 +184,9 @@ public final class ServiceParameter extends Parameter {
* This method performs the following checks:
*
* <ul>
- * <li>If the {@linkplain DefaultParameterDescriptor#getName() primary
name} is an instance of {@code MemberName},
+ * <li>If the {@linkplain ParameterDescriptor#getName() primary name} is
an instance of {@code MemberName},
* returns that primary name.</li>
- * <li>Otherwise this method searches for the first {@linkplain
DefaultParameterDescriptor#getAlias() alias}
+ * <li>Otherwise this method searches for the first {@linkplain
ParameterDescriptor#getAlias() alias}
* which is an instance of {@code MemberName}. If found, that alias
is returned.</li>
* <li>If no alias is found, then this method tries to build a member
name from the primary name and the
* {@linkplain ParameterDescriptor#getValueType() value type} (if
available) or the
diff --git
a/core/sis-metadata/src/main/java/org/apache/sis/internal/metadata/Resources.java
b/core/sis-metadata/src/main/java/org/apache/sis/internal/metadata/Resources.java
index 7c1c5497fd..54bb089d66 100644
---
a/core/sis-metadata/src/main/java/org/apache/sis/internal/metadata/Resources.java
+++
b/core/sis-metadata/src/main/java/org/apache/sis/internal/metadata/Resources.java
@@ -28,7 +28,7 @@ import
org.apache.sis.util.resources.ResourceInternationalString;
/**
* Warning and error messages that are specific to the {@code sis-metadata}
module.
* Resources in this file should not be used by any other module. For
resources shared by
- * all modules in the Apache SIS project, see {@link
org.apache.sis.util.resources} package.
+ * all modules in the Apache SIS project, see {@code
org.apache.sis.util.resources} package.
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.4
diff --git
a/core/sis-metadata/src/test/java/org/apache/sis/test/xml/DocumentComparator.java
b/core/sis-metadata/src/test/java/org/apache/sis/test/xml/DocumentComparator.java
index 943b317a18..67c118225a 100644
---
a/core/sis-metadata/src/test/java/org/apache/sis/test/xml/DocumentComparator.java
+++
b/core/sis-metadata/src/test/java/org/apache/sis/test/xml/DocumentComparator.java
@@ -523,7 +523,7 @@ public class DocumentComparator {
* @param ignored the set of node or attribute fully qualified names to
ignore.
* @param ns the node or attribute namespace, or {@code null}.
* @param name the node or attribute name.
- * @return {@coce true} if the node or attribute shall be ignored.
+ * @return {@code true} if the node or attribute shall be ignored.
*/
private static boolean isIgnored(final Set<String> ignored, String ns,
final String name) {
if (!ignored.isEmpty()) {
diff --git
a/core/sis-portrayal/src/main/java/org/apache/sis/internal/map/coverage/RenderingData.java
b/core/sis-portrayal/src/main/java/org/apache/sis/internal/map/coverage/RenderingData.java
index e1d83fbd21..834a15e1b2 100644
---
a/core/sis-portrayal/src/main/java/org/apache/sis/internal/map/coverage/RenderingData.java
+++
b/core/sis-portrayal/src/main/java/org/apache/sis/internal/map/coverage/RenderingData.java
@@ -369,7 +369,7 @@ public class RenderingData implements CloneAccess {
* @param sliceExtent a subspace of the grid coverage extent where all
dimensions except two have a size of 1 cell.
* May be {@code null} if this grid coverage has only
two dimensions with a size greater than 1 cell.
* @param force whether to force data loading. Should be {@code
true} if {@code coverage} changed since last call.
- * @return whether the {@linkpalin #data} changed.
+ * @return whether the {@linkplain #data} changed.
* @throws FactoryException if the CRS changed but the transform from old
to new CRS cannot be determined.
* @throws TransformException if an error occurred while transforming
coordinates from old to new CRS.
*/
diff --git
a/core/sis-portrayal/src/main/java/org/apache/sis/style/package-info.java
b/core/sis-portrayal/src/main/java/org/apache/sis/style/package-info.java
index ed8db5cafc..d6a931957b 100644
--- a/core/sis-portrayal/src/main/java/org/apache/sis/style/package-info.java
+++ b/core/sis-portrayal/src/main/java/org/apache/sis/style/package-info.java
@@ -30,7 +30,7 @@
* </ul>
*
* As of June 2023 we have not yet determined how to consolidate above works
in a Java API.
- * The {@link org.apache.sis.style.se1} package, which is derived from SE 1.1
standard,
+ * The {@code org.apache.sis.style.se1} package, which is derived from SE 1.1
standard,
* is used an an interim API.
*
* @author Johann Sorel (Geomatys)
diff --git
a/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/Fill.java
b/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/Fill.java
index 0f8717a441..fa75073da8 100644
--- a/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/Fill.java
+++ b/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/Fill.java
@@ -150,7 +150,7 @@ public class Fill<R> extends StyleElement<R> implements
Translucent<R> {
/**
* Sets the color of the area if it is to be solid-color filled.
- * If this method is never invoked, then the default value is {@link
Fill#GRAY}.
+ * If this method is never invoked, then the default value is gray.
* That default value is standardized by OGC 05-077r4.
*
* <p>Setting a non-null value clears the {@linkplain #getGraphicFill()
graphic fill}
diff --git
a/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/LinePlacement.java
b/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/LinePlacement.java
index 2e6d001ceb..9edc9e3d5e 100644
---
a/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/LinePlacement.java
+++
b/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/LinePlacement.java
@@ -60,7 +60,7 @@ public class LinePlacement<R> extends LabelPlacement<R> {
* Whether the label will be repeatedly drawn along the line, or {@code
null} for the default value.
*
* @see #isRepeated()
- * @see #setRepeated(boolean)
+ * @see #setRepeated(Expression)
*
* @todo Needs an adapter from expression to plain boolean.
*/
diff --git
a/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/Stroke.java
b/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/Stroke.java
index 70f52769f3..cb538ae8cc 100644
--- a/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/Stroke.java
+++ b/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/Stroke.java
@@ -268,7 +268,7 @@ public class Stroke<R> extends StyleElement<R> implements
Translucent<R> {
/**
* Sets the color of the line if it is to be solid-color filled.
- * If this method is never invoked, then the default value is {@link
Fill#BLACK}.
+ * If this method is never invoked, then the default value is black.
* That default value is standardized by OGC 05-077r4.
*
* <p>Setting a non-null value clears the {@linkplain #getGraphicFill()
graphic fill} and the
diff --git
a/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/package-info.java
b/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/package-info.java
index 2f6d89729f..a5d2b787f8 100644
---
a/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/package-info.java
+++
b/core/sis-portrayal/src/main/java/org/apache/sis/style/se1/package-info.java
@@ -28,7 +28,7 @@
*
* <h2>Future evolution</h2>
* This package defines an XML encoding. It is not an abstract model for
sophisticated styling.
- * More generic styling API may be provided in a future Apache SIS version in
the {@link org.apache.sis.style} package.
+ * More generic styling API may be provided in a future Apache SIS version in
the {@code org.apache.sis.style} package.
* That future API may be derived from <cite>ISO 19117:2012 — Portrayal</cite>
and/or from the outcome of OGC standard
* working groups which are currently (as of June 2023) working on new style
API.
*
diff --git
a/core/sis-referencing-by-identifiers/src/main/java/org/apache/sis/internal/gazetteer/Resources.java
b/core/sis-referencing-by-identifiers/src/main/java/org/apache/sis/internal/gazetteer/Resources.java
index 84f0a61480..2abecad1c2 100644
---
a/core/sis-referencing-by-identifiers/src/main/java/org/apache/sis/internal/gazetteer/Resources.java
+++
b/core/sis-referencing-by-identifiers/src/main/java/org/apache/sis/internal/gazetteer/Resources.java
@@ -29,7 +29,7 @@ import
org.apache.sis.util.resources.ResourceInternationalString;
/**
* Warning and error messages that are specific to the {@code
sis-referencing-by-identifiers} module.
* Resources in this file should not be used by any other module. For
resources shared by all modules
- * in the Apache SIS project, see {@link org.apache.sis.util.resources}
package.
+ * in the Apache SIS project, see {@code org.apache.sis.util.resources}
package.
*
* @author Martin Desruisseaux (IRD, Geomatys)
* @version 1.4
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/CC_GeneralOperationParameter.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/CC_GeneralOperationParameter.java
index f626fdd1bb..631dba3e7d 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/CC_GeneralOperationParameter.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/CC_GeneralOperationParameter.java
@@ -226,7 +226,7 @@ public final class CC_GeneralOperationParameter extends
PropertyType<CC_GeneralO
* <li>The descriptor for a {@code <gml:ParameterValue>} element. Those
descriptors are more complete than the
* ones provided by {@code <gml:OperationParameter>} elements alone
because the parameter value allows SIS
* to infer the {@code valueClass}.</li>
- * <li>A predefined parameter descriptor from the {@link
org.apache.sis.internal.referencing.provider} package.</li>
+ * <li>A predefined parameter descriptor from the {@code
org.apache.sis.internal.referencing.provider} package.</li>
* </ul>
*
* @param provided the descriptor unmarshalled from the GML document.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/CC_OperationParameterGroup.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/CC_OperationParameterGroup.java
index 16d02f1209..69e367cf90 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/CC_OperationParameterGroup.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/CC_OperationParameterGroup.java
@@ -107,7 +107,7 @@ public final class CC_OperationParameterGroup extends
PropertyType<CC_OperationP
* {@link ParameterDescriptor#getValueClass()} property, which does not
exist in GML but
* is mandatory for us. However, an exception to this "incompleteness"
happen when SIS has
* been able to match the {@code <gml:OperationMethod>} parent to one of
the predefined
- * operations in the {@link org.apache.sis.internal.referencing.provider}
package.</p>
+ * operations in the {@code org.apache.sis.internal.referencing.provider}
package.</p>
*
* <p>The {@code fromValues} argument gives the descriptors declared in
each {@code <gml:ParameterValue>}
* instances of a {@code <gml:ParameterValueGroup>} or {@code
<gml:AbstractSingleOperation>} element.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/RS_Identifier.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/RS_Identifier.java
index b1d66bd1d2..1ddcc6e6d0 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/RS_Identifier.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/jaxb/referencing/RS_Identifier.java
@@ -24,7 +24,7 @@ import org.opengis.metadata.Identifier;
* JAXB adapter mapping the GeoAPI {@link Identifier} to an implementation
class that can be marshalled.
* See the package documentation for more information about JAXB and
interfaces.
*
- * <p>Note that a class of similar name is defined in the {@link
org.apache.sis.internal.jaxb.metadata} package,
+ * <p>Note that a class of similar name is defined in the {@code
org.apache.sis.internal.jaxb.metadata} package,
* which serve the same purpose (wrapping exactly the same interface) but
using the ISO 19139:2007 syntax instead.
* The ISO 19139 syntax represents the code and codespace as XML elements,
while in this GML representation the code
* is a XML value and the codespace is a XML attribute.</p>
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/Arithmetic.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/Arithmetic.java
index 901d8f0bdc..75f637bc8f 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/Arithmetic.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/Arithmetic.java
@@ -18,6 +18,7 @@ package org.apache.sis.internal.referencing;
import java.util.function.BiFunction;
import java.util.function.BinaryOperator;
+import org.opengis.referencing.operation.Matrix; // For javadoc.
import org.apache.sis.internal.system.Configuration;
import org.apache.sis.internal.util.DoubleDouble;
import org.apache.sis.math.Fraction;
@@ -273,10 +274,10 @@ public enum Arithmetic {
/**
* Returns {@code true} if the given number is one, ignoring {@code
DoubleDouble} error term.
* This method does not check the error terms because those terms are not
visible to the user
- * (they cannot appear in the value returned by {@link #getElement(int,
int)}, and are not shown
- * by {@link #toString()}) - returning {@code false} while the matrix
clearly looks like identity
- * would be confusing for the user. Furthermore, the errors can be
non-zero only on the diagonal,
- * and those values are always smaller than 2.3E-16.
+ * (they cannot appear in the value returned by {@link
Matrix#getElement(int, int)},
+ * and are not shown by {@link #toString()}) — returning {@code false}
while the matrix clearly
+ * looks like identity would be confusing for the user. Furthermore, the
errors can be non-zero
+ * only on the diagonal, and those values are always smaller than 2.3E-16.
*
* <p>Another argument is that the extended precision is for reducing
rounding errors during
* matrix arithmetic. But since the user provided the original data as
{@code double} values,
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/DefinitionVerifier.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/DefinitionVerifier.java
index 3ccfe8f853..c4afcb0099 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/DefinitionVerifier.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/DefinitionVerifier.java
@@ -80,7 +80,7 @@ public final class DefinitionVerifier {
/**
* Recommended CRS. May be the instance given to the {@link #withAuthority
withAuthority(…)} method
* or an instance created from the authority factory. May also be {@code
null} if all CRS given to the
- * {@link #compare(CoordinateReferenceSystem, CoordinateReferenceSystem)
compare(…)} method were null.
+ * {@link #compare(CoordinateReferenceSystem, CoordinateReferenceSystem,
Locale) compare(…)} method were null.
*
* Note that ISO 19162 said <cite>"Should any attributes or values given
in the cited identifier be in conflict
* with attributes or values given explicitly in the WKT description, the
WKT values shall prevail."</cite>
@@ -225,7 +225,7 @@ public final class DefinitionVerifier {
}
/**
- * Implementation of {@link #compare(CoordinateReferenceSystem,
CoordinateReferenceSystem)}
+ * Implementation of {@link #compare(CoordinateReferenceSystem,
CoordinateReferenceSystem, Locale)}
* and final step in {@code forAuthority(…)} methods. The boolean flags
control the behavior
* in case of mismatched axis order or full mismatch.
*
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/LazySet.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/LazySet.java
index c4cb25425f..9595001e45 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/LazySet.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/LazySet.java
@@ -28,8 +28,7 @@ import org.apache.sis.internal.util.SetOfUnknownSize;
* are really unique; we assume that this condition was already verified by
the caller.
*
* <p>Some usages for this class are to prepend some values before the
elements given by the source {@code Iterable},
- * or to replace some values when they are loaded. It may also be used for
creating filtered sets when used together
- * with {@link org.apache.sis.internal.util.CollectionsExt#filter
CollectionsExt.filter(…)}.</p>
+ * or to replace some values when they are loaded.</p>
*
* <h2>Thread-safety</h2>
* This class is thread safe. The synchronization lock is {@code this}.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/Resources.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/Resources.java
index 45440ff4a3..4fa36daefd 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/Resources.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/Resources.java
@@ -29,7 +29,7 @@ import
org.apache.sis.util.resources.ResourceInternationalString;
/**
* Warning and error messages that are specific to the {@code sis-referencing}
module.
* Resources in this file should not be used by any other module. For
resources shared
- * by all modules in the Apache SIS project, see {@link
org.apache.sis.util.resources} package.
+ * by all modules in the Apache SIS project, see {@code
org.apache.sis.util.resources} package.
*
* @author Martin Desruisseaux (IRD, Geomatys)
* @version 1.4
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/AbstractShape.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/AbstractShape.java
index f1d286ca50..ae525ecdca 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/AbstractShape.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/AbstractShape.java
@@ -62,7 +62,7 @@ public abstract class AbstractShape implements Shape {
/**
* Returns {@code true} if the given shape is presumed backed by primitive
{@code float} values.
- * The given object should be an instance of {@link Shape} or {@link
Point2D}.
+ * The given object should be an instance of {@link Shape} or {@link
java.awt.geom.Point2D}.
*
* @param shape the shape for which to determine the backing primitive
type.
* @return {@code true} if the given shape is presumed backed by {@code
float} coordinate values.
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/package-info.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/package-info.java
index 2795ae536c..f49b5ab9c0 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/package-info.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/j2d/package-info.java
@@ -27,9 +27,6 @@
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.4
- *
- * @see org.apache.sis.internal.feature.j2d
- *
- * @since 0.3
+ * @since 0.3
*/
package org.apache.sis.internal.referencing.j2d;
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/DatumShiftGridFile.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/DatumShiftGridFile.java
index 78c8a7ed04..d4ea0ea47a 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/DatumShiftGridFile.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/DatumShiftGridFile.java
@@ -513,7 +513,11 @@ abstract class DatumShiftGridFile<C extends Quantity<C>, T
extends Quantity<T>>
*
* @author Martin Desruisseaux (Geomatys)
* @version 0.7
- * @since 0.7
+ *
+ * @param <C> dimension of the coordinate unit (usually angular).
+ * @param <T> dimension of the translation unit (usually angular or
linear).
+ *
+ * @since 0.7
*/
static final class Float<C extends Quantity<C>, T extends Quantity<T>>
extends DatumShiftGridFile<C,T> {
/**
@@ -629,7 +633,11 @@ abstract class DatumShiftGridFile<C extends Quantity<C>, T
extends Quantity<T>>
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.1
- * @since 1.1
+ *
+ * @param <C> dimension of the coordinate unit (usually angular).
+ * @param <T> dimension of the translation unit (usually angular or
linear).
+ *
+ * @since 1.1
*/
static final class Double<C extends Quantity<C>, T extends Quantity<T>>
extends DatumShiftGridFile<C,T> {
/**
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/DatumShiftGridGroup.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/DatumShiftGridGroup.java
index 7e86ebb069..ccc09c20c7 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/DatumShiftGridGroup.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/DatumShiftGridGroup.java
@@ -58,7 +58,11 @@ import org.apache.sis.util.collection.Containers;
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.4
- * @since 1.1
+ *
+ * @param <C> dimension of the coordinate unit (usually angular).
+ * @param <T> dimension of the translation unit (usually angular or linear).
+ *
+ * @since 1.1
*/
final class DatumShiftGridGroup<C extends Quantity<C>, T extends Quantity<T>>
extends DatumShiftGridFile<C,T> {
/**
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/GeocentricAffine.java
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/GeocentricAffine.java
index f3e4ef1e15..9d2fc36d48 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/GeocentricAffine.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/internal/referencing/provider/GeocentricAffine.java
@@ -69,6 +69,7 @@ public abstract class GeocentricAffine extends
GeodeticOperation {
*
* @see #type
*/
+ @SuppressWarnings("doclint:missing")
protected enum Type {TRANSLATION, SEVEN_PARAM, FRAME_ROTATION, MOLODENSKY,
CONVERSION};
/**
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultCoordinateOperationFactory.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultCoordinateOperationFactory.java
index c17a590e82..32f9dd8b81 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultCoordinateOperationFactory.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultCoordinateOperationFactory.java
@@ -301,7 +301,7 @@ public class DefaultCoordinateOperationFactory extends
AbstractFactory implement
* with any number of dimensions (e.g. <cite>Affine Transform</cite>).
*
* <p>The properties given in argument follow the same rules than for the
- * {@linkplain DefaultOperationMethod#DefaultOperationMethod(Map, Integer,
Integer, ParameterDescriptorGroup)
+ * {@linkplain DefaultOperationMethod#DefaultOperationMethod(Map,
ParameterDescriptorGroup)
* operation method} constructor. The following table is a reminder of
main (not all) properties:</p>
*
* <table class="sis">
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultOperationMethod.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultOperationMethod.java
index c76ee7003a..68c8c3fe49 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultOperationMethod.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/DefaultOperationMethod.java
@@ -90,7 +90,7 @@ import org.apache.sis.io.wkt.FormattableObject;
* but may be missing under some conditions in Apache SIS:
* <ul>
* <li>The {@linkplain #getFormula() formula} if it has not been provided to
the
- * {@linkplain #DefaultOperationMethod(Map, Integer, Integer,
ParameterDescriptorGroup) constructor}, or if it
+ * {@linkplain #DefaultOperationMethod(Map, ParameterDescriptorGroup)
constructor}, or if it
* cannot be {@linkplain #DefaultOperationMethod(MathTransform) inferred
from the given math transform}.</li>
* <li>The {@linkplain #getParameters() parameters} if the {@link
#DefaultOperationMethod(MathTransform)}
* constructor cannot infer them.</li>
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AlbersEqualArea.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AlbersEqualArea.java
index 8133f8bc5d..74e7b4305c 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AlbersEqualArea.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/projection/AlbersEqualArea.java
@@ -61,7 +61,7 @@ public class AlbersEqualArea extends AuthalicConversion {
/**
* Internal coefficients for computation, depending only on eccentricity
and values of standards parallels.
- * This is defined as {@literal n = (m₁² – m₂²) / (α₂ – α₁)} in §1.3.13 of
IOGP Publication 373-7-2 (april 2015).
+ * This is defined as {@literal n = (m₁² – m₂²) / (α₂ – α₁)} in §1.3.13 of
IOGP Publication 373-7-2 (April 2015).
*
* <p>In Apache SIS implementation, we use modified formulas in which the
(1 - ℯ²) factor is omitted in
* {@link #qm(double)} calculation. Consequently, what we get is a
modified value <var>nm</var> which is
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ScaleTransform.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ScaleTransform.java
index 8279749d12..03a16aa9a1 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ScaleTransform.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ScaleTransform.java
@@ -32,7 +32,7 @@ import org.apache.sis.util.ArgumentChecks;
* An affine transform that multiply the coordinate values by constant values,
and optionally drop the last coordinates.
* This is an optimization of {@link ProjectiveTransform} for a common case.
*
- * <h4>Design note</h4>
+ * <h2>Design note</h2>
* We do not provide two-dimensional specialization because
* {@link org.apache.sis.internal.referencing.j2d.AffineTransform2D} should be
used in such case.
*
diff --git
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/SphericalToCartesian.java
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/SphericalToCartesian.java
index c532f36954..6927f5192f 100644
---
a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/SphericalToCartesian.java
+++
b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/SphericalToCartesian.java
@@ -42,7 +42,7 @@ import static java.lang.Math.*;
* It shall also match the order defined by {@code Normalizer} in {@link
org.apache.sis.referencing.cs} package.
* Note that this is <strong>not</strong> the convention used neither in
physics (ISO 80000-2:2009) or in mathematics.
*
- * <h4>Relationship with the convention used in physics</h4>
+ * <h2>Relationship with the convention used in physics</h2>
* The ISO 80000-2 convention is (r,Ω,φ) where φ is like the spherical
longitude, and Ω is measured from
* the Z axis (North pole) instead of from the equator plane. The consequence
in the formulas is that
* {@code sin(Ω)} needs to be replaced by {@code cos(Ω)} and conversely.
diff --git
a/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/DefaultOperationMethodTest.java
b/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/DefaultOperationMethodTest.java
index e2f891c7fb..b77a6e1839 100644
---
a/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/DefaultOperationMethodTest.java
+++
b/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/DefaultOperationMethodTest.java
@@ -90,8 +90,7 @@ public final class DefaultOperationMethodTest extends
TestCase {
}
/**
- * Tests the {@link DefaultOperationMethod#DefaultOperationMethod(Map,
Integer, Integer, ParameterDescriptorGroup)}
- * constructor.
+ * Tests the {@link DefaultOperationMethod#DefaultOperationMethod(Map,
ParameterDescriptorGroup)} constructor.
*/
@Test
public void testConstruction() {
diff --git
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/ArrayConverter.java
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/ArrayConverter.java
index 2238df33c9..5dd3721df8 100644
---
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/ArrayConverter.java
+++
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/ArrayConverter.java
@@ -37,7 +37,11 @@ import org.apache.sis.util.UnconvertibleObjectException;
*
* @author Martin Desruisseaux (Geomatys)
* @version 0.3
- * @since 0.3
+ *
+ * @param <S> the base type of source objects.
+ * @param <T> the base type of converted objects.
+ *
+ * @since 0.3
*/
final class ArrayConverter<S,T> extends SystemConverter<S,T> {
/**
diff --git
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/CharSequenceConverter.java
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/CharSequenceConverter.java
index 170e08afd3..33038aa760 100644
---
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/CharSequenceConverter.java
+++
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/CharSequenceConverter.java
@@ -38,7 +38,10 @@ import org.apache.sis.util.UnconvertibleObjectException;
*
* @author Martin Desruisseaux (Geomatys)
* @version 0.3
- * @since 0.3
+ *
+ * @param <T> the base type of converted objects.
+ *
+ * @since 0.3
*/
final class CharSequenceConverter<T> extends SystemConverter<CharSequence,T> {
/**
diff --git
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/CollectionConverter.java
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/CollectionConverter.java
index fbcefb3a3a..41604dcf16 100644
---
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/CollectionConverter.java
+++
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/CollectionConverter.java
@@ -34,7 +34,10 @@ import org.apache.sis.math.FunctionProperty;
*
* @author Martin Desruisseaux (Geomatys)
* @version 0.3
- * @since 0.3
+ *
+ * @param <T> the base type of converted objects.
+ *
+ * @since 0.3
*/
abstract class CollectionConverter<T> extends SystemConverter<Collection<?>,T>
{
/**
diff --git
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/DateConverter.java
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/DateConverter.java
index e1c8f49d54..3391ab0774 100644
---
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/DateConverter.java
+++
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/DateConverter.java
@@ -39,7 +39,10 @@ import org.apache.sis.math.FunctionProperty;
*
* @author Martin Desruisseaux (Geomatys)
* @version 0.3
- * @since 0.3
+ *
+ * @param <T> the base type of converted objects.
+ *
+ * @since 0.3
*/
abstract class DateConverter<T> extends SystemConverter<Date,T> {
/**
diff --git
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/PathConverter.java
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/PathConverter.java
index e1cc71d8b1..f347bf61f9 100644
---
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/PathConverter.java
+++
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/PathConverter.java
@@ -37,7 +37,11 @@ import org.apache.sis.util.UnconvertibleObjectException;
*
* @author Martin Desruisseaux (Geomatys)
* @version 0.7
- * @since 0.3
+ *
+ * @param <S> the base type of source objects.
+ * @param <T> the base type of converted objects.
+ *
+ * @since 0.3
*/
abstract class PathConverter<S,T> extends SystemConverter<S,T> {
/**
diff --git
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/StringConverter.java
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/StringConverter.java
index 367e5ddfa9..9f1cf6196b 100644
---
a/core/sis-utility/src/main/java/org/apache/sis/internal/converter/StringConverter.java
+++
b/core/sis-utility/src/main/java/org/apache/sis/internal/converter/StringConverter.java
@@ -66,7 +66,10 @@ import org.apache.sis.measure.Units;
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.4
- * @since 0.3
+ *
+ * @param <T> the base type of converted objects.
+ *
+ * @since 0.3
*/
abstract class StringConverter<T> extends SystemConverter<String, T> {
/**
diff --git
a/core/sis-utility/src/main/java/org/apache/sis/internal/util/CollectionsExt.java
b/core/sis-utility/src/main/java/org/apache/sis/internal/util/CollectionsExt.java
index f4970f85df..b193686a84 100644
---
a/core/sis-utility/src/main/java/org/apache/sis/internal/util/CollectionsExt.java
+++
b/core/sis-utility/src/main/java/org/apache/sis/internal/util/CollectionsExt.java
@@ -395,8 +395,6 @@ public final class CollectionsExt extends Static {
* @param <E> the type of elements in the set.
* @param set the set to make unmodifiable, or {@code null}.
* @return a unmodifiable version of the given set, or {@code null} if the
given set was null.
- *
- * @see #compact(Set)
*/
public static <E> Set<E> unmodifiableOrCopy(final Set<E> set) {
if (set == null) {
diff --git
a/core/sis-utility/src/main/java/org/apache/sis/util/ResourceInternationalString.java
b/core/sis-utility/src/main/java/org/apache/sis/util/ResourceInternationalString.java
index 6e813f16a3..288dc9c2e9 100644
---
a/core/sis-utility/src/main/java/org/apache/sis/util/ResourceInternationalString.java
+++
b/core/sis-utility/src/main/java/org/apache/sis/util/ResourceInternationalString.java
@@ -123,8 +123,8 @@ public abstract class ResourceInternationalString extends
AbstractInternationalS
*
* @param locale the desired locale for the string to be returned.
* @return the string in the specified locale, or in a fallback locale.
- * @throws MissingResourceException if no resource can be found for the
base name or for the key
- * specified at {@linkplain #ResourceInternationalString(String,
String) construction time}.
+ * @throws MissingResourceException if no resource can be found for the
key specified
+ * at {@linkplain #ResourceInternationalString(String)
construction time}.
*/
@Override
public String toString(Locale locale) throws MissingResourceException {
diff --git
a/core/sis-utility/src/main/java/org/apache/sis/util/collection/Cache.java
b/core/sis-utility/src/main/java/org/apache/sis/util/collection/Cache.java
index 01c31256c1..fc7c390d87 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/collection/Cache.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/collection/Cache.java
@@ -1361,8 +1361,6 @@ public class Cache<K,V> extends AbstractMap<K,V>
implements ConcurrentMap<K,V> {
*
* @param value the object for which to get an estimation of its cost.
* @return the estimated cost of the given object.
- *
- * @see java.lang.instrument.Instrumentation#getObjectSize(Object)
*/
protected int cost(final V value) {
return 1;
diff --git a/pom.xml b/pom.xml
index 88c7a5615f..2d031c3d29 100644
--- a/pom.xml
+++ b/pom.xml
@@ -39,7 +39,7 @@
<parent>
<groupId>org.apache</groupId>
<artifactId>apache</artifactId>
- <version>29</version>
+ <version>30</version>
</parent>
diff --git
a/profiles/sis-japan-profile/src/main/java/org/apache/sis/internal/earth/netcdf/GCOM_C.java
b/profiles/sis-japan-profile/src/main/java/org/apache/sis/internal/earth/netcdf/GCOM_C.java
index fcd0f68a09..f171960e5f 100644
---
a/profiles/sis-japan-profile/src/main/java/org/apache/sis/internal/earth/netcdf/GCOM_C.java
+++
b/profiles/sis-japan-profile/src/main/java/org/apache/sis/internal/earth/netcdf/GCOM_C.java
@@ -111,7 +111,7 @@ import ucar.nc2.constants.CF;
* All attribute names for missing values have {@code "_DN"} suffix.
* This particularity is handled by {@link #nodataValues(Variable)}.</li>
* <li>The global attributes have different names than CF-Convention.
- * This particularity is handled by {@link
#mapAttributeName(String)}.</li>
+ * This particularity is handled by {@link #mapAttributeName(String,
int)}.</li>
* </ul>
*
* @author Alexis Manin (Geomatys)
diff --git
a/profiles/sis-japan-profile/src/main/java/org/apache/sis/internal/earth/netcdf/GCOM_W.java
b/profiles/sis-japan-profile/src/main/java/org/apache/sis/internal/earth/netcdf/GCOM_W.java
index 1911a7915e..03a0195097 100644
---
a/profiles/sis-japan-profile/src/main/java/org/apache/sis/internal/earth/netcdf/GCOM_W.java
+++
b/profiles/sis-japan-profile/src/main/java/org/apache/sis/internal/earth/netcdf/GCOM_W.java
@@ -63,7 +63,7 @@ import org.apache.sis.util.CharSequences;
* <li>The attributes do not specify the "no data" value. A look in sample
files suggest that -32768 is used.
* This particularity is handled by {@link #nodataValues(Variable)}.</li>
* <li>The global attributes have different names than CF-Convention.
- * This particularity is handled by {@link
#mapAttributeName(String)}.</li>
+ * This particularity is handled by {@link #mapAttributeName(String,
int)}.</li>
* </ul>
*
* @author Martin Desruisseaux (Geomatys)
diff --git
a/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Compression.java
b/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Compression.java
index f9d3f6f9d8..3bb7f59767 100644
---
a/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Compression.java
+++
b/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Compression.java
@@ -20,7 +20,7 @@ import static javax.imageio.plugins.tiff.BaselineTIFFTagSet.*;
/**
- * Possible values for {@link org.apache.sis.storage.geotiff.Tags#Compression}.
+ * Possible values for {@code BaselineTIFFTagSet.TAG_COMPRESSION}.
* Data compression applies only to raster image data. All other TIFF fields
are unaffected.
*
* <p>Except otherwise noted, field names in this class are upper-case variant
of the names
diff --git
a/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Predictor.java
b/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Predictor.java
index f651cea43f..f93e847286 100644
---
a/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Predictor.java
+++
b/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Predictor.java
@@ -20,7 +20,7 @@ import static javax.imageio.plugins.tiff.BaselineTIFFTagSet.*;
/**
- * Possible values for {@link org.apache.sis.storage.geotiff.Tags#Predictor}.
+ * Possible values for {@code BaselineTIFFTagSet.TAG_PREDICTOR}.
* A predictor is a mathematical operator that is applied to the image data
* before an encoding scheme is applied.
*
diff --git
a/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Resources.java
b/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Resources.java
index e2e9be6349..ed68da2323 100644
---
a/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Resources.java
+++
b/storage/sis-geotiff/src/main/java/org/apache/sis/internal/geotiff/Resources.java
@@ -28,7 +28,7 @@ import
org.apache.sis.util.resources.ResourceInternationalString;
/**
* Warning and error messages that are specific to the {@code sis-geotiff}
module.
* Resources in this file should not be used by any other module. For
resources shared by
- * all modules in the Apache SIS project, see {@link
org.apache.sis.util.resources} package.
+ * all modules in the Apache SIS project, see {@code
org.apache.sis.util.resources} package.
*
* @author Martin Desruisseaux (IRD, Geomatys)
* @version 1.4
diff --git
a/storage/sis-geotiff/src/test/java/org/apache/sis/storage/geotiff/GeoIdentifiers.java
b/storage/sis-geotiff/src/test/java/org/apache/sis/storage/geotiff/GeoIdentifiers.java
index 0d1ca4f381..f96b65a1ea 100644
---
a/storage/sis-geotiff/src/test/java/org/apache/sis/storage/geotiff/GeoIdentifiers.java
+++
b/storage/sis-geotiff/src/test/java/org/apache/sis/storage/geotiff/GeoIdentifiers.java
@@ -23,7 +23,7 @@ import java.lang.reflect.Field;
* Identifiers (usually EPSG codes) associated to {@link GeoKeys}.
* Those identifiers do not need to be declared in the main {@code
sis-geotiff} module
* because the GeoTIFF reader uses the EPSG database instead or declare those
identifiers
- * in the {@link org.apache.sis.internal.referencing.provider} package instead.
+ * in the {@code org.apache.sis.internal.referencing.provider} package instead.
* However, those identifiers are useful for verification purposes during
tests.
*
* @author Rémi Maréchal (Geomatys)
diff --git
a/storage/sis-geotiff/src/test/java/org/apache/sis/storage/geotiff/GeoKeysTest.java
b/storage/sis-geotiff/src/test/java/org/apache/sis/storage/geotiff/GeoKeysTest.java
index 596987a60c..1bcebc9e02 100644
---
a/storage/sis-geotiff/src/test/java/org/apache/sis/storage/geotiff/GeoKeysTest.java
+++
b/storage/sis-geotiff/src/test/java/org/apache/sis/storage/geotiff/GeoKeysTest.java
@@ -35,7 +35,7 @@ import static org.junit.Assert.*;
/**
* Compares values declared in the {@link GeoKeys} class with values declared
in Apache SIS operations.
* Despite its name, this class is actually more a verification of GeoTIFF
names and identifiers in the
- * {@link org.apache.sis.internal.referencing.provider} package than a
verification of {@code GeoKeys}.
+ * {@code org.apache.sis.internal.referencing.provider} package than a
verification of {@code GeoKeys}.
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.4
@@ -58,8 +58,12 @@ public final class GeoKeysTest extends TestCase {
}
/**
- * Verifies that GeoTIFF projection aliases registered in the {@link
org.apache.sis.internal.referencing.provider}
- * package match the name of fields listed in {@link GeoIdentifiers} and
that GeoTIFF numerical codes correspond.
+ * Verifies GeoTIFF projection aliases and identifiers. Verification
includes:
+ * <ul>
+ * <li>that GeoTIFF projection aliases registered in the {@code
org.apache.sis.internal.referencing.provider}
+ * package match the name of fields listed in {@link
GeoIdentifiers}, and</li>
+ * <li>that GeoTIFF numerical codes correspond.</li>
+ * </ul>
* This method verifies only projection names and identifiers, not
parameter names.
*/
@Test
@@ -84,7 +88,9 @@ public final class GeoKeysTest extends TestCase {
}
/**
- * Verifies that parameter names registered in the {@link
org.apache.sis.internal.referencing.provider} package
+ * Verifies GeoTIFF projection parameters.
+ * This method verifies that parameter names registered in the
+ * {@code org.apache.sis.internal.referencing.provider} package
* match the name of fields listed in {@link GeoKeys}.
*/
@Test
diff --git
a/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Resources.java
b/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Resources.java
index 70dbeddcb1..c0fc79e2b0 100644
---
a/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Resources.java
+++
b/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Resources.java
@@ -26,7 +26,7 @@ import org.apache.sis.util.resources.IndexedResourceBundle;
/**
* Warning and error messages that are specific to the {@code sis-netcdf}
module.
* Resources in this file should not be used by any other module. For
resources shared by
- * all modules in the Apache SIS project, see {@link
org.apache.sis.util.resources} package.
+ * all modules in the Apache SIS project, see {@code
org.apache.sis.util.resources} package.
*
* @author Martin Desruisseaux (IRD, Geomatys)
* @version 1.4
diff --git
a/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Variable.java
b/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Variable.java
index 6d9055cd91..70c7253cc0 100644
---
a/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Variable.java
+++
b/storage/sis-netcdf/src/main/java/org/apache/sis/internal/netcdf/Variable.java
@@ -302,7 +302,7 @@ public abstract class Variable extends Node {
/**
* Returns the standard name if available, or the unique variable name
otherwise.
- * May be used for {@link RasterResource#getIdentifier()} and {@link
Raster#label}.
+ * May be used for {@link RasterResource#getIdentifier()}.
* Standard name is preferred to variable name when controlled vocabulary
is desired,
* for example for more stable identifier or more consistency between
similar data.
*
diff --git
a/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Database.java
b/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Database.java
index 0afb0ac0fb..4bff8152db 100644
---
a/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Database.java
+++
b/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Database.java
@@ -608,7 +608,7 @@ public class Database<G> extends Syntax {
/**
* Returns the type of components in SQL arrays stored in a column.
- * This method is invoked when {@link #type} = {@link Types#ARRAY}.
+ * This method is invoked when {@link Column#type} = {@link Types#ARRAY}.
* The default implementation returns {@link Types#OTHER} because JDBC
* column metadata does not provide information about component types.
* Database-specific subclasses should override this method if they can
diff --git
a/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Resources.java
b/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Resources.java
index f25d2ec4c4..5a5a23d2a3 100644
---
a/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Resources.java
+++
b/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/feature/Resources.java
@@ -28,7 +28,7 @@ import
org.apache.sis.util.resources.ResourceInternationalString;
/**
* Warning and error messages that are specific to the {@code sis-sqlstore}
module.
* Resources in this file should not be used by any other module. For
resources shared by
- * all modules in the Apache SIS project, see {@link
org.apache.sis.util.resources} package.
+ * all modules in the Apache SIS project, see {@code
org.apache.sis.util.resources} package.
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.4
diff --git
a/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/postgis/Postgres.java
b/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/postgis/Postgres.java
index 9200f2604d..453fa479cd 100644
---
a/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/postgis/Postgres.java
+++
b/storage/sis-sqlstore/src/main/java/org/apache/sis/internal/sql/postgis/Postgres.java
@@ -137,7 +137,7 @@ public final class Postgres<G> extends Database<G> {
/**
* Returns the type of components in SQL arrays stored in a column.
- * This method is invoked when {@link #type} = {@link Types#ARRAY}.
+ * This method is invoked when {@link Column#type} = {@link Types#ARRAY}.
*/
@Override
protected int getArrayComponentType(final Column columnDefinition) {
diff --git
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/FeatureCatalogBuilder.java
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/FeatureCatalogBuilder.java
index 9b9a03db9d..46dddd1c01 100644
---
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/FeatureCatalogBuilder.java
+++
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/FeatureCatalogBuilder.java
@@ -48,7 +48,7 @@ public final class FeatureCatalogBuilder extends
MetadataBuilder {
/**
* The feature types created by the {@code FeatureCatalogBuilder}.
* {@code DataStore} implementations can keep the reference to this {@code
FeatureNaming}
- * after the {@link #build(boolean)} method has been invoked.
+ * after the {@link #build()} method has been invoked.
*/
public final FeatureNaming<FeatureType> features;
diff --git
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/GridResourceWrapper.java
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/GridResourceWrapper.java
index 7439c61d84..eb60713fcc 100644
---
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/GridResourceWrapper.java
+++
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/GridResourceWrapper.java
@@ -39,7 +39,9 @@ import org.opengis.util.GenericName;
*
* <p>The default implementation assumes that the wrapper only delays data
loading,
* without making substantive changes to the data. If the wrapper changes the
data,
- * then {@link DerivedGridCoverageResource} subclass should be used
instead.</p>
+ * then a {@code DerivedGridCoverageResource} subclass should be used
instead.</p>
+ *
+ * @todo Define {@code DerivedGridCoverageResource}.
*
* @author Martin Desruisseaux (Geomatys)
* @version 1.4
diff --git
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/MemoryFeatureSet.java
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/MemoryFeatureSet.java
index 4c3a19aae4..3614e284bc 100644
---
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/MemoryFeatureSet.java
+++
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/MemoryFeatureSet.java
@@ -30,7 +30,7 @@ import org.opengis.feature.FeatureType;
/**
* Set of features stored in memory. Features are specified at construction
time.
- * Metadata can be specified by overriding {@link
#createMetadata(MetadataBuilder)}.
+ * Metadata can be specified by overriding {@link #createMetadata()}.
*
* @author Johann Sorel (Geomatys)
* @author Martin Desruisseaux (Geomatys)
diff --git
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/MemoryGridResource.java
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/MemoryGridResource.java
index f01991fc5d..9af0c45baf 100644
---
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/MemoryGridResource.java
+++
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/MemoryGridResource.java
@@ -35,7 +35,7 @@ import org.apache.sis.util.ArgumentChecks;
/**
* A {@link org.apache.sis.storage.GridCoverageResource} in memory.
* This resource wraps an arbitrary {@link GridCoverage} specified at
construction time.
- * Metadata can be specified by overriding {@link
#createMetadata(MetadataBuilder)}.
+ * Metadata can be specified by overriding {@link #createMetadata()}.
*
* @author Johann Sorel (Geomatys)
* @author Martin Desruisseaux (Geomatys)
diff --git
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/Resources.java
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/Resources.java
index b859d71fbd..6b2de75494 100644
---
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/Resources.java
+++
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/Resources.java
@@ -28,7 +28,7 @@ import
org.apache.sis.util.resources.ResourceInternationalString;
/**
* Warning and error messages that are specific to the {@code sis-storage}
module.
* Resources in this file should not be used by any other module. For
resources shared by
- * all modules in the Apache SIS project, see {@link
org.apache.sis.util.resources} package.
+ * all modules in the Apache SIS project, see {@code
org.apache.sis.util.resources} package.
*
* @author Martin Desruisseaux (IRD, Geomatys)
* @version 1.4
diff --git
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/wkt/FirstKeywordPeek.java
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/wkt/FirstKeywordPeek.java
index 3eaa4a61b2..6f32b56631 100644
---
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/wkt/FirstKeywordPeek.java
+++
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/wkt/FirstKeywordPeek.java
@@ -179,8 +179,8 @@ public abstract class FirstKeywordPeek {
/**
* Returns {@link ProbeResult#SUPPORTED} if the content of given file
begins with an expected keyword.
- * This method can be invoked as an alternative to {@link
#probeContent(StorageConnector)} when the file
- * to test is not the specified storage, but some auxiliary file.
+ * This method can be invoked as an alternative to {@link
#probeContent(DataStoreProvider, StorageConnector)}
+ * when the file to test is not the specified storage, but some auxiliary
file.
*
* @param file the file to partially read.
* @return {@link ProbeResult#SUPPORTED} if the given file seems to be
readable.
@@ -270,7 +270,7 @@ public abstract class FirstKeywordPeek {
protected abstract boolean isPostKeyword(int c);
/**
- * Returns the value to be returned by {@link
#probeContent(StorageConnector)} for the given keyword.
+ * Returns the value to be returned by {@link
#probeContent(DataStoreProvider, StorageConnector)} for the given keyword.
*
* @param keyword the first keyword found in the input. May be {@code
null} if {@code length} is zero.
* @param length number of valid characters in {@code keyword}.
diff --git
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/wkt/StoreFormat.java
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/wkt/StoreFormat.java
index c117db3ba9..8945dc262e 100644
---
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/wkt/StoreFormat.java
+++
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/wkt/StoreFormat.java
@@ -23,6 +23,7 @@ import java.util.logging.Level;
import java.util.logging.LogRecord;
import org.opengis.geometry.Geometry;
import org.opengis.util.FactoryException;
+import org.opengis.util.InternationalString;
import org.opengis.referencing.crs.CoordinateReferenceSystem;
import org.apache.sis.io.wkt.WKTFormat;
import org.apache.sis.io.wkt.Warnings;
diff --git
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/xml/package-info.java
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/xml/package-info.java
index 475b0bc885..53b471be2e 100644
---
a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/xml/package-info.java
+++
b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/xml/package-info.java
@@ -22,7 +22,7 @@
*
* <p>This base package is designed for use with JAXB, which allows this
package to be very small since most of the
* XML (un)marshalling rules are specified in external classes designed for
use with JAXB. However, some classes can
- * also be used in other contexts. In particular, the {@link
org.apache.sis.internal.storage.xml.stream} package in
+ * also be used in other contexts. In particular, the {@code
org.apache.sis.internal.storage.xml.stream} package in
* the {@code sis-xmlstore} module extends this package with classes designed
for use with StAX cursor API.</p>
*
* @author Martin Desruisseaux (Geomatys)
diff --git
a/storage/sis-storage/src/main/java/org/apache/sis/storage/FeatureQuery.java
b/storage/sis-storage/src/main/java/org/apache/sis/storage/FeatureQuery.java
index 8a2d96032a..79cdf16d60 100644
--- a/storage/sis-storage/src/main/java/org/apache/sis/storage/FeatureQuery.java
+++ b/storage/sis-storage/src/main/java/org/apache/sis/storage/FeatureQuery.java
@@ -501,7 +501,7 @@ public class FeatureQuery extends Query implements
Cloneable, Serializable {
* verb tense <i>-ing</i> instead of <i>-ed</i> is for emphasizing
that the data used for computation
* are current (filtered) data instead of past (original) data.</div>
*
- * @see FeatureOperations#expression(Map, Function, AttributeType)
+ * @see FeatureOperations#function(Map, Function, AttributeType)
*/
COMPUTING
}
diff --git
a/storage/sis-xmlstore/src/main/java/org/apache/sis/internal/storage/gpx/WritableStore.java
b/storage/sis-xmlstore/src/main/java/org/apache/sis/internal/storage/gpx/WritableStore.java
index 478a218a13..ab9b9103bb 100644
---
a/storage/sis-xmlstore/src/main/java/org/apache/sis/internal/storage/gpx/WritableStore.java
+++
b/storage/sis-xmlstore/src/main/java/org/apache/sis/internal/storage/gpx/WritableStore.java
@@ -74,7 +74,7 @@ public final class WritableStore extends Store implements
WritableFeatureSet {
/**
* Appends new feature instances in this {@code FeatureSet}.
- * Any feature already present in this {@link FeatureSet} will remain
unmodified.
+ * Any feature already present in this {@link WritableFeatureSet} will
remain unmodified.
*
* @param features feature instances to append in this {@code
FeatureSet}.
* @throws DataStoreException if the feature stream cannot be obtained or
updated.
diff --git
a/storage/sis-xmlstore/src/main/java/org/apache/sis/internal/storage/xml/stream/StaxStreamIO.java
b/storage/sis-xmlstore/src/main/java/org/apache/sis/internal/storage/xml/stream/StaxStreamIO.java
index 53d5b9cab9..179eb619c7 100644
---
a/storage/sis-xmlstore/src/main/java/org/apache/sis/internal/storage/xml/stream/StaxStreamIO.java
+++
b/storage/sis-xmlstore/src/main/java/org/apache/sis/internal/storage/xml/stream/StaxStreamIO.java
@@ -105,7 +105,7 @@ abstract class StaxStreamIO implements AutoCloseable {
}
/**
- * Returns the error resources in the current locale.
+ * {@return the error resources in the current locale}.
*/
protected final Errors errors() {
return Errors.getResources(owner.getLocale());
