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 <martin.desruisse...@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