This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-collections.git
The following commit(s) were added to refs/heads/master by this push: new f6b9e3c Javadoc: Close HTML tags and normalize spelling of 'initialize'. f6b9e3c is described below commit f6b9e3cd8e02597ab42d56802519b6f673c97b6e Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Thu Nov 19 21:37:18 2020 -0500 Javadoc: Close HTML tags and normalize spelling of 'initialize'. --- .../org/apache/commons/collections4/MapUtils.java | 2 +- .../collections4/bidimap/AbstractDualBidiMap.java | 2 +- .../bloomfilter/hasher/HashFunctionIdentity.java | 24 ++++++++++++++-------- .../collections4/list/AbstractLinkedList.java | 2 +- .../commons/collections4/list/SetUniqueList.java | 2 +- .../collections4/map/AbstractHashedMap.java | 4 ++-- .../collections4/map/AbstractReferenceMap.java | 4 ++-- .../commons/collections4/set/ListOrderedSet.java | 2 +- .../functors/AbstractPredicateTest.java | 2 +- 9 files changed, 26 insertions(+), 18 deletions(-) diff --git a/src/main/java/org/apache/commons/collections4/MapUtils.java b/src/main/java/org/apache/commons/collections4/MapUtils.java index ee66d23..961e314 100644 --- a/src/main/java/org/apache/commons/collections4/MapUtils.java +++ b/src/main/java/org/apache/commons/collections4/MapUtils.java @@ -1831,7 +1831,7 @@ public class MapUtils { // ------------------------------------------------------------------------- /** - * Gets a new Properties object initialised with the values from a Map. A null input will return an empty properties + * Gets a new Properties object initialized with the values from a Map. A null input will return an empty properties * object. * <p> * A Properties object may only store non-null keys and values, thus if the provided map contains either a key or diff --git a/src/main/java/org/apache/commons/collections4/bidimap/AbstractDualBidiMap.java b/src/main/java/org/apache/commons/collections4/bidimap/AbstractDualBidiMap.java index 672d795..5ade68c 100644 --- a/src/main/java/org/apache/commons/collections4/bidimap/AbstractDualBidiMap.java +++ b/src/main/java/org/apache/commons/collections4/bidimap/AbstractDualBidiMap.java @@ -77,7 +77,7 @@ public abstract class AbstractDualBidiMap<K, V> implements BidiMap<K, V> { transient Set<Map.Entry<K, V>> entrySet = null; /** - * Creates an empty map, initialised by {@code createMap}. + * Creates an empty map, initialized by {@code createMap}. * <p> * This constructor remains in place for deserialization. * All other usage is deprecated in favour of diff --git a/src/main/java/org/apache/commons/collections4/bloomfilter/hasher/HashFunctionIdentity.java b/src/main/java/org/apache/commons/collections4/bloomfilter/hasher/HashFunctionIdentity.java index 96f3b90..0ff2edb 100644 --- a/src/main/java/org/apache/commons/collections4/bloomfilter/hasher/HashFunctionIdentity.java +++ b/src/main/java/org/apache/commons/collections4/bloomfilter/hasher/HashFunctionIdentity.java @@ -35,15 +35,15 @@ public interface HashFunctionIdentity { * {@link HashFunction#apply(byte[], int)}.</dd> * <dt>Cyclic processes</dt> * <dd>Call the underlying hash algorithm using a (buffer, seed) pair passed to - * {@link HashFunction#apply(byte[], int)} to initialise the state. Subsequent + * {@link HashFunction#apply(byte[], int)} to initialize the state. Subsequent * calls can generate hash values without calling the underlying algorithm.</dd> * </dl> */ enum ProcessType { /** * Call the underlying hash algorithm for a (buffer, seed) pair passed to - * {@link HashFunction#apply(byte[], int)} when the state is uninitialised or - * the seed is zero. This initialises the state. Subsequent calls with a non-zero + * {@link HashFunction#apply(byte[], int)} when the state is uninitialized or + * the seed is zero. This initializes the state. Subsequent calls with a non-zero * seed use the state to generate a new value. */ CYCLIC, @@ -71,8 +71,10 @@ public interface HashFunctionIdentity { * The result of {@link HashFunction#apply(byte[], int)} is signed, * thus the sign bit may be set. * - * <p>The result can be used with {@code Math.floorMod(x, y)} to generate a positive + * <p> + * The result can be used with {@code Math.floorMod(x, y)} to generate a positive * value if y is positive. + * </p> * * @see Math#floorMod(int, int) */ @@ -81,8 +83,10 @@ public interface HashFunctionIdentity { * The result of {@link HashFunction#apply(byte[], int)} is unsigned, * thus the sign bit is never set. * - * <p>The result can be used with {@code x % y} to generate a positive + * <p> + * The result can be used with {@code x % y} to generate a positive * value if y is positive. + * </p> */ UNSIGNED } @@ -119,9 +123,11 @@ public interface HashFunctionIdentity { /** * Gets the name of this hash function. - * <p> Hash function should be the common name + * <p> + * Hash function should be the common name * for the hash. This may include indications as to hash length - * </p><p> + * </p> + * <p> * Names are not case specific. Thus, "MD5" and "md5" should be considered as the same. * </p> * @return the Hash name @@ -149,7 +155,9 @@ public interface HashFunctionIdentity { * Gets the signature of this function. The signature is the output of the hash function * when applied to a set of bytes composed using properties of the hash function. * - * <p>Implementations should define the method used to generate the signature. + * <p> + * Implementations should define the method used to generate the signature. + * </p> * * @return the signature of this function. * @see #prepareSignatureBuffer(HashFunctionIdentity) diff --git a/src/main/java/org/apache/commons/collections4/list/AbstractLinkedList.java b/src/main/java/org/apache/commons/collections4/list/AbstractLinkedList.java index 2d8e182..47433f1 100644 --- a/src/main/java/org/apache/commons/collections4/list/AbstractLinkedList.java +++ b/src/main/java/org/apache/commons/collections4/list/AbstractLinkedList.java @@ -93,7 +93,7 @@ public abstract class AbstractLinkedList<E> implements List<E> { * The equivalent of a default constructor, broken out so it can be called * by any constructor and by {@code readObject}. * Subclasses which override this method should make sure they call super, - * so the list is initialised properly. + * so the list is initialized properly. */ protected void init() { header = createHeaderNode(); diff --git a/src/main/java/org/apache/commons/collections4/list/SetUniqueList.java b/src/main/java/org/apache/commons/collections4/list/SetUniqueList.java index ce547ab..2b818f2 100644 --- a/src/main/java/org/apache/commons/collections4/list/SetUniqueList.java +++ b/src/main/java/org/apache/commons/collections4/list/SetUniqueList.java @@ -89,7 +89,7 @@ public class SetUniqueList<E> extends AbstractSerializableListDecorator<E> { /** * Constructor that wraps (not copies) the List and specifies the set to use. * <p> - * The set and list must both be correctly initialised to the same elements. + * The set and list must both be correctly initialized to the same elements. * * @param set the set to decorate, must not be null * @param list the list to decorate, must not be null diff --git a/src/main/java/org/apache/commons/collections4/map/AbstractHashedMap.java b/src/main/java/org/apache/commons/collections4/map/AbstractHashedMap.java index ce00054..b4acad6 100644 --- a/src/main/java/org/apache/commons/collections4/map/AbstractHashedMap.java +++ b/src/main/java/org/apache/commons/collections4/map/AbstractHashedMap.java @@ -1246,7 +1246,7 @@ public class AbstractHashedMap<K, V> extends AbstractMap<K, V> implements Iterab * subclass must be setup before {@code put()} is used. * <p> * Serialization is not one of the JDK's nicest topics. Normal serialization will - * initialise the superclass before the subclass. Sometimes however, this isn't + * initialize the superclass before the subclass. Sometimes however, this isn't * what you want, as in this case the {@code put()} method on read can be * affected by subclass state. * <p> @@ -1276,7 +1276,7 @@ public class AbstractHashedMap<K, V> extends AbstractMap<K, V> implements Iterab * subclass must be setup before {@code put()} is used. * <p> * Serialization is not one of the JDK's nicest topics. Normal serialization will - * initialise the superclass before the subclass. Sometimes however, this isn't + * initialize the superclass before the subclass. Sometimes however, this isn't * what you want, as in this case the {@code put()} method on read can be * affected by subclass state. * <p> diff --git a/src/main/java/org/apache/commons/collections4/map/AbstractReferenceMap.java b/src/main/java/org/apache/commons/collections4/map/AbstractReferenceMap.java index 62d398c..a8c63c8 100644 --- a/src/main/java/org/apache/commons/collections4/map/AbstractReferenceMap.java +++ b/src/main/java/org/apache/commons/collections4/map/AbstractReferenceMap.java @@ -1007,7 +1007,7 @@ public abstract class AbstractReferenceMap<K, V> extends AbstractHashedMap<K, V> * Replaces the superclass method to store the state of this class. * <p> * Serialization is not one of the JDK's nicest topics. Normal serialization will - * initialise the superclass before the subclass. Sometimes however, this isn't + * initialize the superclass before the subclass. Sometimes however, this isn't * what you want, as in this case the {@code put()} method on read can be * affected by subclass state. * <p> @@ -1041,7 +1041,7 @@ public abstract class AbstractReferenceMap<K, V> extends AbstractHashedMap<K, V> * Replaces the superclass method to read the state of this class. * <p> * Serialization is not one of the JDK's nicest topics. Normal serialization will - * initialise the superclass before the subclass. Sometimes however, this isn't + * initialize the superclass before the subclass. Sometimes however, this isn't * what you want, as in this case the {@code put()} method on read can be * affected by subclass state. * <p> diff --git a/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java b/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java index ea19fdb..92fadec 100644 --- a/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java +++ b/src/main/java/org/apache/commons/collections4/set/ListOrderedSet.java @@ -152,7 +152,7 @@ public class ListOrderedSet<E> * Constructor that wraps (not copies) the Set and specifies the list to * use. * <p> - * The set and list must both be correctly initialised to the same elements. + * The set and list must both be correctly initialized to the same elements. * * @param set the set to decorate, must not be null * @param list the list to decorate, must not be null diff --git a/src/test/java/org/apache/commons/collections4/functors/AbstractPredicateTest.java b/src/test/java/org/apache/commons/collections4/functors/AbstractPredicateTest.java index 9ef75cf..e26564c 100644 --- a/src/test/java/org/apache/commons/collections4/functors/AbstractPredicateTest.java +++ b/src/test/java/org/apache/commons/collections4/functors/AbstractPredicateTest.java @@ -27,7 +27,7 @@ public abstract class AbstractPredicateTest { protected Integer cInteger; @Before - public void initialiseTestObjects() throws Exception { + public void initializeTestObjects() throws Exception { cObject = new Object(); cString = "Hello"; cInteger = Integer.valueOf(6);