You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sis.apache.org by de...@apache.org on 2022/12/03 22:44:08 UTC
[sis] 01/02: Minor documentation fixes.
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
commit b7d5da1cc1740dffd6ae40048a5118e183229d14
Author: Martin Desruisseaux <ma...@geomatys.com>
AuthorDate: Sat Dec 3 11:04:10 2022 +0100
Minor documentation fixes.
---
.../src/main/java/org/apache/sis/internal/doclet/Preformat.java | 2 +-
.../src/main/java/org/apache/sis/internal/maven/Filenames.java | 2 +-
.../apache/sis/internal/coverage/j2d/MultiBandsIndexColorModel.java | 2 +-
.../src/main/java/org/apache/sis/internal/feature/Resources.java | 2 +-
.../src/main/java/org/apache/sis/metadata/PropertyAccessor.java | 4 ++--
.../src/main/java/org/apache/sis/metadata/TreeNodeChildren.java | 2 +-
.../src/main/java/org/apache/sis/util/iso/DefaultNameFactory.java | 2 +-
.../src/main/java/org/apache/sis/util/iso/DefaultNameSpace.java | 2 +-
.../src/main/java/org/apache/sis/xml/ValueConverter.java | 2 +-
.../src/test/java/org/apache/sis/metadata/iso/MarshallingTest.java | 2 +-
core/sis-metadata/src/test/java/org/apache/sis/xml/XLinkTest.java | 2 +-
.../src/main/java/org/apache/sis/internal/gazetteer/Resources.java | 4 ++--
.../src/main/java/org/apache/sis/geometry/AbstractEnvelope.java | 2 +-
.../src/main/java/org/apache/sis/geometry/Envelope2D.java | 2 +-
.../main/java/org/apache/sis/internal/referencing/Resources.java | 4 ++--
.../apache/sis/referencing/operation/CoordinateOperationFinder.java | 2 +-
.../apache/sis/referencing/operation/matrix/AffineTransforms2D.java | 4 ++--
.../sis/referencing/operation/transform/AbstractMathTransform.java | 2 +-
.../sis/referencing/operation/transform/ConcatenatedTransform.java | 2 +-
.../referencing/operation/transform/ConcatenatedTransform2D.java | 2 +-
.../operation/transform/ConcatenatedTransformDirect2D.java | 2 +-
.../sis/referencing/operation/transform/LinearTransform1D.java | 2 +-
.../src/test/java/org/apache/sis/referencing/crs/HardCodedCRS.java | 6 +++---
.../referencing/operation/transform/ConcatenatedTransformTest.java | 4 ++--
.../sis/referencing/operation/transform/MathTransformWrapper.java | 2 +-
.../main/java/org/apache/sis/util/logging/MonolineFormatter.java | 2 +-
.../src/main/java/org/apache/sis/util/resources/Errors.java | 2 +-
.../java/org/apache/sis/util/resources/IndexedResourceBundle.java | 2 +-
.../src/main/java/org/apache/sis/util/resources/Messages.java | 2 +-
.../src/main/java/org/apache/sis/util/resources/Vocabulary.java | 2 +-
.../src/main/java/org/apache/sis/storage/netcdf/AttributeNames.java | 4 ++--
.../org/apache/sis/internal/shapefile/jdbc/sql/ClauseResolver.java | 2 +-
.../java/org/apache/sis/internal/storage/image/FormatFinder.java | 2 +-
.../main/java/org/apache/sis/internal/storage/io/IOUtilities.java | 2 +-
.../src/main/java/org/apache/sis/storage/StorageConnector.java | 2 +-
35 files changed, 43 insertions(+), 43 deletions(-)
diff --git a/core/sis-build-helper/src/main/java/org/apache/sis/internal/doclet/Preformat.java b/core/sis-build-helper/src/main/java/org/apache/sis/internal/doclet/Preformat.java
index 560ebc1fac..0ca8c07a00 100644
--- a/core/sis-build-helper/src/main/java/org/apache/sis/internal/doclet/Preformat.java
+++ b/core/sis-build-helper/src/main/java/org/apache/sis/internal/doclet/Preformat.java
@@ -50,7 +50,7 @@ public final class Preformat extends Taglet {
* Special characters to replace by HTML entities.
*/
private static final String[] SPECIAL_CHARS = new String[] {
- "@", "@", // Because we can't use @ directly in {@preformat}.
+ "@", "@", // Because we cannot use @ directly in {@preformat}.
"&", "&",
"<", "<",
">", ">"
diff --git a/core/sis-build-helper/src/main/java/org/apache/sis/internal/maven/Filenames.java b/core/sis-build-helper/src/main/java/org/apache/sis/internal/maven/Filenames.java
index 27a144d430..317f0d10e5 100644
--- a/core/sis-build-helper/src/main/java/org/apache/sis/internal/maven/Filenames.java
+++ b/core/sis-build-helper/src/main/java/org/apache/sis/internal/maven/Filenames.java
@@ -104,7 +104,7 @@ final class Filenames {
final File outDirectory = new File(new File(rootDirectory, TARGET_DIRECTORY), DISTRIBUTION_DIRECTORY);
if (!outDirectory.isDirectory()) {
if (!outDirectory.mkdir()) {
- throw new MojoExecutionException("Can't create the \"" + DISTRIBUTION_DIRECTORY + "\" directory.");
+ throw new MojoExecutionException("Cannot create the \"" + DISTRIBUTION_DIRECTORY + "\" directory.");
}
}
return new File(outDirectory, filename);
diff --git a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/MultiBandsIndexColorModel.java b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/MultiBandsIndexColorModel.java
index 11885f3243..43eb231687 100644
--- a/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/MultiBandsIndexColorModel.java
+++ b/core/sis-feature/src/main/java/org/apache/sis/internal/coverage/j2d/MultiBandsIndexColorModel.java
@@ -35,7 +35,7 @@ import java.awt.image.SinglePixelPackedSampleModel;
*
* <p><b>Reminder:</b> {@link #getNumComponents()} will return 3 or 4 no matter
* how many bands were specified to the constructor. This is not specific to this class;
- * {@code IndexColorModel} behave that way. So we can't rely on this method for checking
+ * {@code IndexColorModel} behave that way. So we cannot rely on this method for checking
* the number of bands.</p>
*
* @author Martin Desruisseaux (IRD, Geomatys)
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 63115fde43..af18fe363f 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
@@ -504,7 +504,7 @@ public final class Resources extends IndexedResourceBundle {
*
* @param properties the map of properties, or {@code null} if none.
* @return resources in the given locale.
- * @throws MissingResourceException if resources can't be found.
+ * @throws MissingResourceException if resources cannot be found.
*
* @since 0.4
*/
diff --git a/core/sis-metadata/src/main/java/org/apache/sis/metadata/PropertyAccessor.java b/core/sis-metadata/src/main/java/org/apache/sis/metadata/PropertyAccessor.java
index 66d591fd63..cd2825b9cf 100644
--- a/core/sis-metadata/src/main/java/org/apache/sis/metadata/PropertyAccessor.java
+++ b/core/sis-metadata/src/main/java/org/apache/sis/metadata/PropertyAccessor.java
@@ -969,7 +969,7 @@ class PropertyAccessor {
Object newValue = newValues[0];
Class<?> targetType = getter.getReturnType();
if (newValue == null) {
- // Can't test elementType, because it has been converted to the wrapper class.
+ // Cannot test elementType, because it has been converted to the wrapper class.
if (targetType.isPrimitive()) {
newValues[0] = Numbers.valueOfNil(targetType);
}
@@ -1073,7 +1073,7 @@ class PropertyAccessor {
*
* @param elements the array which contains element to convert.
* @param targetType the base type of target elements.
- * @throws ClassCastException if an element can't be converted.
+ * @throws ClassCastException if an element cannot be converted.
*/
@SuppressWarnings({"unchecked","rawtypes"})
private void convert(final Object[] elements, final Class<?> targetType) throws ClassCastException {
diff --git a/core/sis-metadata/src/main/java/org/apache/sis/metadata/TreeNodeChildren.java b/core/sis-metadata/src/main/java/org/apache/sis/metadata/TreeNodeChildren.java
index 1199670c68..8ccfed083b 100644
--- a/core/sis-metadata/src/main/java/org/apache/sis/metadata/TreeNodeChildren.java
+++ b/core/sis-metadata/src/main/java/org/apache/sis/metadata/TreeNodeChildren.java
@@ -123,7 +123,7 @@ final class TreeNodeChildren extends AbstractCollection<TreeTable.Node> {
/**
* Modification count, incremented when the content of this collection is modified. This check
- * is done on a <cite>best effort basis</cite> only, since we can't not track the changes which
+ * is done on a <cite>best effort basis</cite> only, since we cannot not track the changes which
* are done independently in the {@linkplain #metadata} object.
*/
int modCount;
diff --git a/core/sis-metadata/src/main/java/org/apache/sis/util/iso/DefaultNameFactory.java b/core/sis-metadata/src/main/java/org/apache/sis/util/iso/DefaultNameFactory.java
index e0e690f796..f7a20de0e8 100644
--- a/core/sis-metadata/src/main/java/org/apache/sis/util/iso/DefaultNameFactory.java
+++ b/core/sis-metadata/src/main/java/org/apache/sis/util/iso/DefaultNameFactory.java
@@ -365,7 +365,7 @@ public class DefaultNameFactory extends AbstractFactory implements NameFactory {
* @param value the object to cast into an array of generic names, or {@code null}.
* @return the generic names, or {@code null} if the given {@code value} was null.
* Note that it may be the {@code value} reference itself casted to {@code GenericName[]}.
- * @throws ClassCastException if {@code value} can't be casted.
+ * @throws ClassCastException if {@code value} cannot be casted.
*
* @since 0.5
*/
diff --git a/core/sis-metadata/src/main/java/org/apache/sis/util/iso/DefaultNameSpace.java b/core/sis-metadata/src/main/java/org/apache/sis/util/iso/DefaultNameSpace.java
index a8d2eade67..99ef3143be 100644
--- a/core/sis-metadata/src/main/java/org/apache/sis/util/iso/DefaultNameSpace.java
+++ b/core/sis-metadata/src/main/java/org/apache/sis/util/iso/DefaultNameSpace.java
@@ -443,7 +443,7 @@ public class DefaultNameSpace implements NameSpace, Serializable {
{
child = new DefaultNameSpace(this, name, headSeparator, separator);
/*
- * Do not cache that instance. Actually we can't guess if that instance
+ * Do not cache that instance. Actually we cannot guess if that instance
* would be more appropriate for caching purpose than the old one. We
* just assume that keeping the oldest one is more conservative.
*/
diff --git a/core/sis-metadata/src/main/java/org/apache/sis/xml/ValueConverter.java b/core/sis-metadata/src/main/java/org/apache/sis/xml/ValueConverter.java
index f5b8d3974b..420e05cbc5 100644
--- a/core/sis-metadata/src/main/java/org/apache/sis/xml/ValueConverter.java
+++ b/core/sis-metadata/src/main/java/org/apache/sis/xml/ValueConverter.java
@@ -98,7 +98,7 @@ public class ValueConverter {
*
* @param <T> the compile-time type of the {@code sourceType} argument.
* @param context context (GML version, locale, <i>etc.</i>) of the (un)marshalling process.
- * @param value the value that can't be converted.
+ * @param value the value that cannot be converted.
* @param sourceType the base type of the value to convert. This is determined by the argument type of the method
* that caught the exception. For example, the source type is always {@code URI.class}
* if the exception has been caught by the {@link #toURL(MarshalContext, URI)} method.
diff --git a/core/sis-metadata/src/test/java/org/apache/sis/metadata/iso/MarshallingTest.java b/core/sis-metadata/src/test/java/org/apache/sis/metadata/iso/MarshallingTest.java
index 2b110691d3..ddf453bd58 100644
--- a/core/sis-metadata/src/test/java/org/apache/sis/metadata/iso/MarshallingTest.java
+++ b/core/sis-metadata/src/test/java/org/apache/sis/metadata/iso/MarshallingTest.java
@@ -644,7 +644,7 @@ public final class MarshallingTest extends TestUsingFile implements Filter {
/**
* Invoked when a warning occurred while marshalling a test XML fragment. Expected warnings are
- * "Can't find resource for bundle {@code java.util.PropertyResourceBundle}, key <cite>Foo</cite>".
+ * "Cannot find resource for bundle {@code java.util.PropertyResourceBundle}, key <cite>Foo</cite>".
* When marshalling legacy XML only, additional warnings may occur.
*
* @param warning the warning.
diff --git a/core/sis-metadata/src/test/java/org/apache/sis/xml/XLinkTest.java b/core/sis-metadata/src/test/java/org/apache/sis/xml/XLinkTest.java
index fd701adc51..53ad676fc8 100644
--- a/core/sis-metadata/src/test/java/org/apache/sis/xml/XLinkTest.java
+++ b/core/sis-metadata/src/test/java/org/apache/sis/xml/XLinkTest.java
@@ -77,7 +77,7 @@ public final strictfp class XLinkTest extends TestCase {
assertFalse("Hash code cannot be zero.", hashCode == 0);
link.setShow(XLink.Show.NEW);
- assertNull("Can't be Type.SIMPLE if a label is defined.", link.getType());
+ assertNull("Cannot be Type.SIMPLE if a label is defined.", link.getType());
assertEquals("XLink[href=\"org:apache:sis:href\", role=\"org:apache:sis:role\", title=\"Some title\", show=\"new\", label=\"SomeLabel\"]", link.toString());
assertFalse("Hash code should have changed.", hashCode == (hashCode = link.hashCode()));
assertFalse("Hash code cannot be zero.", hashCode == 0);
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 53b9bb2343..1e4efb5ade 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
@@ -166,7 +166,7 @@ public final class Resources extends IndexedResourceBundle {
*
* @param locale the locale, or {@code null} for the default locale.
* @return resources in the given locale.
- * @throws MissingResourceException if resources can't be found.
+ * @throws MissingResourceException if resources cannot be found.
*/
public static Resources forLocale(final Locale locale) throws MissingResourceException {
return getBundle(Resources.class, locale);
@@ -179,7 +179,7 @@ public final class Resources extends IndexedResourceBundle {
*
* @param properties the map of properties, or {@code null} if none.
* @return resources in the given locale.
- * @throws MissingResourceException if resources can't be found.
+ * @throws MissingResourceException if resources cannot be found.
*/
public static Resources forProperties(final Map<?,?> properties) throws MissingResourceException {
return forLocale(getLocale(properties));
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/geometry/AbstractEnvelope.java b/core/sis-referencing/src/main/java/org/apache/sis/geometry/AbstractEnvelope.java
index 3a04dd63f7..db823c6fad 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/geometry/AbstractEnvelope.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/geometry/AbstractEnvelope.java
@@ -535,7 +535,7 @@ public abstract class AbstractEnvelope extends FormattableObject implements Enve
* @param unit the unit for the return value.
* @return the span in terms of the given unit.
* @throws IndexOutOfBoundsException if the given index is out of bounds.
- * @throws IncommensurableException if the length can't be converted to the specified units.
+ * @throws IncommensurableException if the length cannot be converted to the specified units.
*/
public double getSpan(final int dimension, final Unit<?> unit)
throws IndexOutOfBoundsException, IncommensurableException
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/geometry/Envelope2D.java b/core/sis-referencing/src/main/java/org/apache/sis/geometry/Envelope2D.java
index ec9805fb8b..e9d8a34c6e 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/geometry/Envelope2D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/geometry/Envelope2D.java
@@ -40,7 +40,7 @@ import static org.apache.sis.math.MathFunctions.isNegativeZero;
import static org.apache.sis.util.ArgumentChecks.ensureDimensionMatches;
import static org.apache.sis.internal.referencing.Formulas.isPoleToPole;
-// Following imports are needed because we can't extend AbstractEnvelope.
+// Following imports are needed because we cannot extend AbstractEnvelope.
// We want to write this class as if it was an AbstractEnvelope subclass.
import static org.apache.sis.geometry.AbstractEnvelope.getAxis;
import static org.apache.sis.geometry.AbstractEnvelope.getCommonCRS;
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 f469d3d014..e971562b92 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
@@ -618,7 +618,7 @@ public final class Resources extends IndexedResourceBundle {
*
* @param locale the locale, or {@code null} for the default locale.
* @return resources in the given locale.
- * @throws MissingResourceException if resources can't be found.
+ * @throws MissingResourceException if resources cannot be found.
*/
public static Resources forLocale(final Locale locale) throws MissingResourceException {
return getBundle(Resources.class, locale);
@@ -631,7 +631,7 @@ public final class Resources extends IndexedResourceBundle {
*
* @param properties the map of properties, or {@code null} if none.
* @return resources in the given locale.
- * @throws MissingResourceException if resources can't be found.
+ * @throws MissingResourceException if resources cannot be found.
*/
public static Resources forProperties(final Map<?,?> properties) throws MissingResourceException {
return forLocale(getLocale(properties));
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/CoordinateOperationFinder.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/CoordinateOperationFinder.java
index d535142f81..8ef1e80388 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/CoordinateOperationFinder.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/CoordinateOperationFinder.java
@@ -1091,7 +1091,7 @@ public class CoordinateOperationFinder extends CoordinateOperationRegistry {
* @param step1 the first step, or {@code null} for the identity operation.
* @param step2 the second step, or {@code null} for the identity operation.
* @return a concatenated operation, or {@code null} if all arguments were null.
- * @throws FactoryException if the operation can't be constructed.
+ * @throws FactoryException if the operation cannot be constructed.
*/
private CoordinateOperation concatenate(final CoordinateOperation step1,
final CoordinateOperation step2)
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/AffineTransforms2D.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/AffineTransforms2D.java
index 9a910a5209..768058e244 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/AffineTransforms2D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/matrix/AffineTransforms2D.java
@@ -268,7 +268,7 @@ public final class AffineTransforms2D extends Static {
* this rectangle will not be modified except if {@code dest} references the same object.
* @param dest rectangle in which to place the result. If {@code null}, a new rectangle will be created.
* @return the inverse transform of the {@code bounds} rectangle, or {@code null} if {@code bounds} was null.
- * @throws NoninvertibleTransformException if the affine transform can't be inverted.
+ * @throws NoninvertibleTransformException if the affine transform cannot be inverted.
*/
public static Rectangle2D inverseTransform(final AffineTransform transform,
final Rectangle2D bounds, final Rectangle2D dest) throws NoninvertibleTransformException
@@ -307,7 +307,7 @@ public final class AffineTransforms2D extends Static {
* this point will not be modified except if {@code dest} references the same object.
* @param dest point in which to place the result. If {@code null}, a new point will be created.
* @return the inverse transform of the {@code vector}, or {@code null} if {@code source} was null.
- * @throws NoninvertibleTransformException if the affine transform can't be inverted.
+ * @throws NoninvertibleTransformException if the affine transform cannot be inverted.
*/
public static Point2D inverseDeltaTransform(final AffineTransform transform,
final Point2D vector, final Point2D dest) throws NoninvertibleTransformException
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform.java
index 8ad28d4391..917a028f12 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/AbstractMathTransform.java
@@ -527,7 +527,7 @@ public abstract class AbstractMathTransform extends FormattableObject
* May be the same than {@code srcPts}.
* @param dstOff the offset to the location of the first transformed point that is stored in the destination array.
* @param numPts the number of point objects to be transformed.
- * @throws TransformException if a point can't be transformed. Some implementations will stop at the first failure,
+ * @throws TransformException if a point cannot be transformed. Some implementations will stop at the first failure,
* wile some other implementations will fill the un-transformable points with {@link Float#NaN} values,
* continue and throw the exception only at end. Implementations that fall in the latter case should set
* the {@linkplain TransformException#getLastCompletedTransform last completed transform} to {@code this}.
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform.java
index 2d6084806d..db143e9bc2 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform.java
@@ -848,7 +848,7 @@ class ConcatenatedTransform extends AbstractMathTransform implements Serializabl
*
* @param point the position where to evaluate the derivative.
* @return the derivative at the specified point (never {@code null}).
- * @throws TransformException if the derivative can't be evaluated at the specified point.
+ * @throws TransformException if the derivative cannot be evaluated at the specified point.
*/
@Override
public Matrix derivative(final DirectPosition point) throws TransformException {
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform2D.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform2D.java
index 5d1532765f..ed225f27d0 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform2D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransform2D.java
@@ -95,7 +95,7 @@ final class ConcatenatedTransform2D extends ConcatenatedTransform implements Mat
*
* @param point the position where to evaluate the derivative.
* @return the derivative at the specified point as a 2×2 matrix.
- * @throws TransformException if the derivative can't be evaluated at the specified point.
+ * @throws TransformException if the derivative cannot be evaluated at the specified point.
*/
@Override
public Matrix derivative(final Point2D point) throws TransformException {
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformDirect2D.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformDirect2D.java
index 9a8761e5a0..83c8aef745 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformDirect2D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformDirect2D.java
@@ -87,7 +87,7 @@ final class ConcatenatedTransformDirect2D extends ConcatenatedTransformDirect im
*
* @param point the position where to evaluate the derivative.
* @return the derivative at the specified point (never {@code null}).
- * @throws TransformException if the derivative can't be evaluated at the specified point.
+ * @throws TransformException if the derivative cannot be evaluated at the specified point.
*/
@Override
public Matrix derivative(final Point2D point) throws TransformException {
diff --git a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/LinearTransform1D.java b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/LinearTransform1D.java
index 2e40cbb9b8..6b9c7577d0 100644
--- a/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/LinearTransform1D.java
+++ b/core/sis-referencing/src/main/java/org/apache/sis/referencing/operation/transform/LinearTransform1D.java
@@ -372,7 +372,7 @@ class LinearTransform1D extends AbstractMathTransform1D implements LinearTransfo
* NOTE: 'LinearTransform1D' and 'ConstantTransform1D' are heavily used by 'Category'
* from 'org.apache.sis.coverage' package. It is essential for Cateory to differenciate
* various NaN values. Because 'equals' is used by WeakHashSet.unique(Object) (which
- * is used by 'DefaultMathTransformFactory'), test for equality can't use the non-raw
+ * is used by 'DefaultMathTransformFactory'), test for equality cannot use the non-raw
* doubleToLongBits method because it collapse all NaN into a single canonical value.
* The 'doubleToRawLongBits' method instead provides the needed functionality.
*/
diff --git a/core/sis-referencing/src/test/java/org/apache/sis/referencing/crs/HardCodedCRS.java b/core/sis-referencing/src/test/java/org/apache/sis/referencing/crs/HardCodedCRS.java
index af947fefcb..4717314852 100644
--- a/core/sis-referencing/src/test/java/org/apache/sis/referencing/crs/HardCodedCRS.java
+++ b/core/sis-referencing/src/test/java/org/apache/sis/referencing/crs/HardCodedCRS.java
@@ -234,7 +234,7 @@ public final strictfp class HardCodedCRS {
/**
* A two-dimensional Cartesian coordinate reference system with (x,y) axes in metres.
* By default, this CRS has no transformation path to any other CRS (i.e. a map using
- * this CS can't be reprojected to a geographic coordinate reference system for example).
+ * this CS cannot be reprojected to a geographic coordinate reference system for example).
*/
public static final DefaultEngineeringCRS CARTESIAN_2D = new DefaultEngineeringCRS(
getProperties(HardCodedCS.CARTESIAN_2D), HardCodedDatum.UNKNOWN, HardCodedCS.CARTESIAN_2D);
@@ -242,7 +242,7 @@ public final strictfp class HardCodedCRS {
/**
* A two-dimensional Cartesian coordinate reference system with (x,y,z) axes in metres.
* By default, this CRS has no transformation path to any other CRS (i.e. a map using
- * this CS can't be reprojected to a geographic coordinate reference system for example).
+ * this CS cannot be reprojected to a geographic coordinate reference system for example).
*/
public static final DefaultEngineeringCRS CARTESIAN_3D = new DefaultEngineeringCRS(
getProperties(HardCodedCS.CARTESIAN_3D), HardCodedDatum.UNKNOWN, HardCodedCS.CARTESIAN_3D);
@@ -339,7 +339,7 @@ public final strictfp class HardCodedCRS {
/**
* A two-dimensional Cartesian coordinate reference system with (column, row) axes.
* By default, this CRS has no transformation path to any other CRS (i.e. a map using
- * this CS can't be reprojected to a geographic coordinate reference system for example).
+ * this CS cannot be reprojected to a geographic coordinate reference system for example).
*
* <p>The {@code PixelInCell} attribute of the associated {@code ImageDatum}
* is set to {@link PixelInCell#CELL_CENTER}.</p>
diff --git a/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformTest.java b/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformTest.java
index 07319b98fe..da29f2ed6c 100644
--- a/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformTest.java
+++ b/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/ConcatenatedTransformTest.java
@@ -74,11 +74,11 @@ public final strictfp class ConcatenatedTransformTest extends MathTransformTestC
validate();
verifyTransform(source, target);
- // Direct for general case - can't be validated.
+ // Direct for general case - cannot be validated.
transform = new ConcatenatedTransformDirect(first, second);
verifyTransform(source, target);
- // Most general case - can't be validated.
+ // Most general case - cannot be validated.
transform = new ConcatenatedTransform(first, second);
verifyTransform(source, target);
diff --git a/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/MathTransformWrapper.java b/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/MathTransformWrapper.java
index 17336573d6..e2564b1135 100644
--- a/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/MathTransformWrapper.java
+++ b/core/sis-referencing/src/test/java/org/apache/sis/referencing/operation/transform/MathTransformWrapper.java
@@ -192,7 +192,7 @@ public strictfp class MathTransformWrapper extends FormattableObject implements
/**
* Returns a <cite>Well Known Text</cite> (WKT) for this transform.
*
- * @throws UnsupportedOperationException if this object can't be formatted as WKT.
+ * @throws UnsupportedOperationException if this object cannot be formatted as WKT.
*/
@Override
public final String toWKT() throws UnsupportedOperationException {
diff --git a/core/sis-utility/src/main/java/org/apache/sis/util/logging/MonolineFormatter.java b/core/sis-utility/src/main/java/org/apache/sis/util/logging/MonolineFormatter.java
index d35f3da7f6..97bd7adc04 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/logging/MonolineFormatter.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/logging/MonolineFormatter.java
@@ -151,7 +151,7 @@ public class MonolineFormatter extends Formatter {
* A comparator for logging level. This comparator sorts finest levels first and severe levels last.
*/
private static final Comparator<Level> COMPARATOR = (final Level l1, final Level l2) -> {
- // We can't just return (i1 - i2) because some levels are
+ // We cannot just return (i1 - i2) because some levels are
// Integer.MIN_VALUE or Integer.MAX_VALUE, which cause overflow.
final int i1 = l1.intValue();
final int i2 = l2.intValue();
diff --git a/core/sis-utility/src/main/java/org/apache/sis/util/resources/Errors.java b/core/sis-utility/src/main/java/org/apache/sis/util/resources/Errors.java
index 35e81a1c00..22316a1a01 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/resources/Errors.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/resources/Errors.java
@@ -1111,7 +1111,7 @@ public final class Errors extends IndexedResourceBundle {
*
* @param properties the map of properties, or {@code null} if none.
* @return resources in the given locale.
- * @throws MissingResourceException if resources can't be found.
+ * @throws MissingResourceException if resources cannot be found.
*
* @since 0.4
*/
diff --git a/core/sis-utility/src/main/java/org/apache/sis/util/resources/IndexedResourceBundle.java b/core/sis-utility/src/main/java/org/apache/sis/util/resources/IndexedResourceBundle.java
index 5cc87e623c..5beaaf851d 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/resources/IndexedResourceBundle.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/resources/IndexedResourceBundle.java
@@ -154,7 +154,7 @@ public class IndexedResourceBundle extends ResourceBundle implements Localized {
* @param base the resource bundle class.
* @param locale the locale, or {@code null} for the default locale.
* @return resources in the given locale.
- * @throws MissingResourceException if resources can't be found.
+ * @throws MissingResourceException if resources cannot be found.
*
* @see Vocabulary#getResources(Locale)
* @see Errors#getResources(Locale)
diff --git a/core/sis-utility/src/main/java/org/apache/sis/util/resources/Messages.java b/core/sis-utility/src/main/java/org/apache/sis/util/resources/Messages.java
index e13cacf163..58fad5df53 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/resources/Messages.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/resources/Messages.java
@@ -258,7 +258,7 @@ public final class Messages extends IndexedResourceBundle {
*
* @param locale the locale, or {@code null} for the default locale.
* @return resources in the given locale.
- * @throws MissingResourceException if resources can't be found.
+ * @throws MissingResourceException if resources cannot be found.
*/
public static Messages getResources(final Locale locale) throws MissingResourceException {
return getBundle(Messages.class, locale);
diff --git a/core/sis-utility/src/main/java/org/apache/sis/util/resources/Vocabulary.java b/core/sis-utility/src/main/java/org/apache/sis/util/resources/Vocabulary.java
index 4a50e661f6..4f82def088 100644
--- a/core/sis-utility/src/main/java/org/apache/sis/util/resources/Vocabulary.java
+++ b/core/sis-utility/src/main/java/org/apache/sis/util/resources/Vocabulary.java
@@ -1435,7 +1435,7 @@ public final class Vocabulary extends IndexedResourceBundle {
*
* @param locale the locale, or {@code null} for the default locale.
* @return resources in the given locale.
- * @throws MissingResourceException if resources can't be found.
+ * @throws MissingResourceException if resources cannot be found.
*/
public static Vocabulary getResources(final Locale locale) throws MissingResourceException {
return getBundle(Vocabulary.class, locale);
diff --git a/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/AttributeNames.java b/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/AttributeNames.java
index 777156f777..4df0a85eab 100644
--- a/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/AttributeNames.java
+++ b/storage/sis-netcdf/src/main/java/org/apache/sis/storage/netcdf/AttributeNames.java
@@ -58,7 +58,7 @@ import org.opengis.metadata.extent.GeographicDescription;
* The attributes recognized by SIS are listed below:
*
* <blockquote><table class="compact">
- * <caption>List of all netCDF attributes</caption>
+ * <caption>List of all netCDF attributes mapped by Apache SIS to ISO 19115 metadata</caption>
* <tr style="vertical-align:top"><td style="width: 25%">
* {@value #ACCESS_CONSTRAINT}<br>
* {@value #ACKNOWLEDGEMENT}<br>
@@ -135,7 +135,7 @@ import org.opengis.metadata.extent.GeographicDescription;
*
* <h2>References</h2>
* <ul>
- * <li><a href="http://wiki.esipfed.org/index.php/Category:Attribute_Conventions_Dataset_Discovery">NetCDF
+ * <li><a href="https://wiki.esipfed.org/Category:Attribute_Conventions_Dataset_Discovery">NetCDF
* Attribute Convention for Dataset Discovery</a> wiki</li>
* </ul>
*
diff --git a/storage/sis-shapefile/src/main/java/org/apache/sis/internal/shapefile/jdbc/sql/ClauseResolver.java b/storage/sis-shapefile/src/main/java/org/apache/sis/internal/shapefile/jdbc/sql/ClauseResolver.java
index fa92bd2d20..f978ff3c36 100644
--- a/storage/sis-shapefile/src/main/java/org/apache/sis/internal/shapefile/jdbc/sql/ClauseResolver.java
+++ b/storage/sis-shapefile/src/main/java/org/apache/sis/internal/shapefile/jdbc/sql/ClauseResolver.java
@@ -228,7 +228,7 @@ public abstract class ClauseResolver extends AutoChecker {
return compare(rs, value1, value2);
else
{
- // if one value doesn't match to a type, we can't perform the comparison.
+ // if one value doesn't match to a type, we cannot perform the comparison.
if ((w1 == false && b1 == false) || (w2 == false && b2 == false))
return null;
else {
diff --git a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/image/FormatFinder.java b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/image/FormatFinder.java
index 72a63613bf..971f6a197b 100644
--- a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/image/FormatFinder.java
+++ b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/image/FormatFinder.java
@@ -291,7 +291,7 @@ final class FormatFinder implements AutoCloseable {
*
* <h4>Rational</h4>
* As of Java 18, above-cited methods systematically catch all {@link IOException}s and wrap
- * them in an {@link IIOException} with <cite>"Can't create cache file!"</cite> error message.
+ * them in an {@link IIOException} with <cite>"Cannot create cache file!"</cite> error message.
* This is conform to Image I/O specification but misleading if the stream provider throws an
* {@link IOException} for another reason. Even when the failure is really caused by a problem
* with cache file, we want to propagate the original exception to user because its message
diff --git a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/io/IOUtilities.java b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/io/IOUtilities.java
index 7be19a3d6c..3df8039a40 100644
--- a/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/io/IOUtilities.java
+++ b/storage/sis-storage/src/main/java/org/apache/sis/internal/storage/io/IOUtilities.java
@@ -475,7 +475,7 @@ public final class IOUtilities extends Static {
* then {@code null}. This argument is ignored if the given path does not need
* to be converted from URL to {@code File}.
* @return the path as a {@link File} if possible, or a {@link URL} otherwise.
- * @throws IOException if the given path is not a file and can't be parsed as a URL.
+ * @throws IOException if the given path is not a file and cannot be parsed as a URL.
*/
public static Object toFileOrURL(final String path, final String encoding) throws IOException {
if (path == null) {
diff --git a/storage/sis-storage/src/main/java/org/apache/sis/storage/StorageConnector.java b/storage/sis-storage/src/main/java/org/apache/sis/storage/StorageConnector.java
index a5e1d5851d..c5619f6e55 100644
--- a/storage/sis-storage/src/main/java/org/apache/sis/storage/StorageConnector.java
+++ b/storage/sis-storage/src/main/java/org/apache/sis/storage/StorageConnector.java
@@ -1616,7 +1616,7 @@ public class StorageConnector implements Serializable {
*
* <h4>Rational</h4>
* As of Java 18, above-cited methods systematically catch all {@link IOException}s and wrap
- * them in an {@link IIOException} with <cite>"Can't create cache file!"</cite> error message.
+ * them in an {@link IIOException} with <cite>"Cannot create cache file!"</cite> error message.
* This is conform to Image I/O specification but misleading if the stream provider throws an
* {@link IOException} for another reason. Even when the failure is really caused by a problem
* with cache file, we want to propagate the original exception to user because its message