diff --git a/src/main/java/org/apache/commons/collections/bag/AbstractBagDecorator.java b/src/main/java/org/apache/commons/collections/bag/AbstractBagDecorator.java
index eaff36921..37e82a290 100644
--- a/src/main/java/org/apache/commons/collections/bag/AbstractBagDecorator.java
+++ b/src/main/java/org/apache/commons/collections/bag/AbstractBagDecorator.java
@@ -24,7 +24,7 @@ import org.apache.commons.collections.collection.AbstractCollectionDecorator;
/**
* Decorates another Bag
to provide additional behaviour.
*
- * Methods are forwarded directly to the decorated bag.
+ * Methods are forwarded directly to the decorated bag. * * @since Commons Collections 3.0 * @version $Revision$ diff --git a/src/main/java/org/apache/commons/collections/bag/AbstractMapBag.java b/src/main/java/org/apache/commons/collections/bag/AbstractMapBag.java index 12460728f..c81a279c9 100644 --- a/src/main/java/org/apache/commons/collections/bag/AbstractMapBag.java +++ b/src/main/java/org/apache/commons/collections/bag/AbstractMapBag.java @@ -35,7 +35,7 @@ import org.apache.commons.collections.set.UnmodifiableSet; ** Subclasses specify a Map implementation to use as the internal storage. The * map will be used to map bag elements to a number; the number represents the - * number of occurrences of that element in the bag.
+ * number of occurrences of that element in the bag. * * @since Commons Collections 3.0 (previously DefaultMapBag v2.0) * @version $Revision$ diff --git a/src/main/java/org/apache/commons/collections/bag/AbstractSortedBagDecorator.java b/src/main/java/org/apache/commons/collections/bag/AbstractSortedBagDecorator.java index 1abb55985..b3ac08a05 100644 --- a/src/main/java/org/apache/commons/collections/bag/AbstractSortedBagDecorator.java +++ b/src/main/java/org/apache/commons/collections/bag/AbstractSortedBagDecorator.java @@ -23,7 +23,7 @@ import org.apache.commons.collections.SortedBag; /** * Decorates anotherSortedBag
to provide additional behaviour.
* - * Methods are forwarded directly to the decorated bag.
+ * Methods are forwarded directly to the decorated bag. * * @since Commons Collections 3.0 * @version $Revision$ diff --git a/src/main/java/org/apache/commons/collections/bag/HashBag.java b/src/main/java/org/apache/commons/collections/bag/HashBag.java index 7caa435ed..c5214f8d3 100644 --- a/src/main/java/org/apache/commons/collections/bag/HashBag.java +++ b/src/main/java/org/apache/commons/collections/bag/HashBag.java @@ -33,7 +33,7 @@ import org.apache.commons.collections.Bag; * count of occurrences. Extra methods on the interface allow multiple copies * of an object to be added or removed at once. It is important to read the * interface javadoc carefully as several methods violate the - *Collection
interface specification.
+ * Collection
interface specification.
*
* @since Commons Collections 3.0 (previously in main package v2.0)
* @version $Revision$
diff --git a/src/main/java/org/apache/commons/collections/bag/PredicatedBag.java b/src/main/java/org/apache/commons/collections/bag/PredicatedBag.java
index a1c92f3ee..5df6a3a76 100644
--- a/src/main/java/org/apache/commons/collections/bag/PredicatedBag.java
+++ b/src/main/java/org/apache/commons/collections/bag/PredicatedBag.java
@@ -28,12 +28,12 @@ import org.apache.commons.collections.collection.PredicatedCollection;
* * This bag exists to provide validation for the decorated bag. * It is normally created to decorate an empty bag. - * If an object cannot be added to the bag, an IllegalArgumentException is thrown.
+ * If an object cannot be added to the bag, an IllegalArgumentException is thrown. ** One usage would be to ensure that no null entries are added to the bag. - *
Bag bag = PredicatedBag.decorate(new HashBag(), NotNullPredicate.INSTANCE);+ *
Bag bag = PredicatedBag.decorate(new HashBag(), NotNullPredicate.INSTANCE);*
- * This class is Serializable from Commons Collections 3.1.
+ * This class is Serializable from Commons Collections 3.1. * * @since Commons Collections 3.0 * @version $Revision$ @@ -51,7 +51,7 @@ public class PredicatedBag* If there are any elements already in the bag being decorated, they - * are validated.
+ * are validated. * * @param* If there are any elements already in the bag being decorated, they - * are validated.
+ * are validated. * * @param bag the bag to decorate, must not be null * @param predicate the predicate to use for validation, must not be null diff --git a/src/main/java/org/apache/commons/collections/bag/PredicatedSortedBag.java b/src/main/java/org/apache/commons/collections/bag/PredicatedSortedBag.java index 834d7a272..49d1a7f22 100644 --- a/src/main/java/org/apache/commons/collections/bag/PredicatedSortedBag.java +++ b/src/main/java/org/apache/commons/collections/bag/PredicatedSortedBag.java @@ -27,12 +27,12 @@ import org.apache.commons.collections.SortedBag; ** This bag exists to provide validation for the decorated bag. * It is normally created to decorate an empty bag. - * If an object cannot be added to the bag, an IllegalArgumentException is thrown.
+ * If an object cannot be added to the bag, an IllegalArgumentException is thrown. ** One usage would be to ensure that no null entries are added to the bag. - *
SortedBag bag = PredicatedSortedBag.decorate(new TreeBag(), NotNullPredicate.INSTANCE);+ *
SortedBag bag = PredicatedSortedBag.decorate(new TreeBag(), NotNullPredicate.INSTANCE);*
- * This class is Serializable from Commons Collections 3.1.
+ * This class is Serializable from Commons Collections 3.1. * * @since Commons Collections 3.0 * @version $Revision$ @@ -50,7 +50,7 @@ public class PredicatedSortedBag* If there are any elements already in the bag being decorated, they - * are validated.
+ * are validated. * * @paramIf there are any elements already in the bag being decorated, they - * are validated.
+ * are validated. * * @param bag the bag to decorate, must not be null * @param predicate the predicate to use for validation, must not be null diff --git a/src/main/java/org/apache/commons/collections/bag/SynchronizedBag.java b/src/main/java/org/apache/commons/collections/bag/SynchronizedBag.java index a79b03a6e..18d905f2a 100644 --- a/src/main/java/org/apache/commons/collections/bag/SynchronizedBag.java +++ b/src/main/java/org/apache/commons/collections/bag/SynchronizedBag.java @@ -27,9 +27,9 @@ import org.apache.commons.collections.set.SynchronizedSet; * for a multi-threaded environment. ** Methods are synchronized, then forwarded to the decorated bag. - * Iterators must be separately synchronized around the loop.
+ * Iterators must be separately synchronized around the loop. *- * This class is Serializable from Commons Collections 3.1.
+ * This class is Serializable from Commons Collections 3.1. * * @since Commons Collections 3.0 * @version $Revision$ diff --git a/src/main/java/org/apache/commons/collections/bag/SynchronizedSortedBag.java b/src/main/java/org/apache/commons/collections/bag/SynchronizedSortedBag.java index 4d7a508ba..f14a18be4 100644 --- a/src/main/java/org/apache/commons/collections/bag/SynchronizedSortedBag.java +++ b/src/main/java/org/apache/commons/collections/bag/SynchronizedSortedBag.java @@ -26,9 +26,9 @@ import org.apache.commons.collections.SortedBag; * for a multi-threaded environment. ** Methods are synchronized, then forwarded to the decorated bag. - * Iterators must be separately synchronized around the loop.
+ * Iterators must be separately synchronized around the loop. *- * This class is Serializable from Commons Collections 3.1.
+ * This class is Serializable from Commons Collections 3.1. * * @since Commons Collections 3.0 * @version $Revision$ diff --git a/src/main/java/org/apache/commons/collections/bag/TransformedBag.java b/src/main/java/org/apache/commons/collections/bag/TransformedBag.java index b70cde3f4..1515c0318 100644 --- a/src/main/java/org/apache/commons/collections/bag/TransformedBag.java +++ b/src/main/java/org/apache/commons/collections/bag/TransformedBag.java @@ -29,9 +29,9 @@ import org.apache.commons.collections.set.TransformedSet; * The add methods are affected by this class. * Thus objects must be removed or searched for using their transformed form. * For example, if the transformation converts Strings to Integers, you must - * use the Integer form to remove objects. + * use the Integer form to remove objects. *- * This class is Serializable from Commons Collections 3.1.
+ * This class is Serializable from Commons Collections 3.1. * * @since Commons Collections 3.0 * @version $Revision$ @@ -48,7 +48,7 @@ public class TransformedBag* If there are any elements already in the bag being decorated, they - * are NOT transformed. Contrast this with {@link #transformedBag(Bag, Transformer)}.
+ * are NOT transformed. Contrast this with {@link #transformedBag(Bag, Transformer)}. * * @param* If there are any elements already in the bag being decorated, they * will be transformed by this method. - * Contrast this with {@link #transformingBag(Bag, Transformer)}.
+ * Contrast this with {@link #transformingBag(Bag, Transformer)}. * * @param* If there are any elements already in the bag being decorated, they - * are NOT transformed.
+ * are NOT transformed. * * @param bag the bag to decorate, must not be null * @param transformer the transformer to use for conversion, must not be null diff --git a/src/main/java/org/apache/commons/collections/bag/TransformedSortedBag.java b/src/main/java/org/apache/commons/collections/bag/TransformedSortedBag.java index ae6750784..96aa8e3aa 100644 --- a/src/main/java/org/apache/commons/collections/bag/TransformedSortedBag.java +++ b/src/main/java/org/apache/commons/collections/bag/TransformedSortedBag.java @@ -27,9 +27,9 @@ import org.apache.commons.collections.Transformer; * The add methods are affected by this class. * Thus objects must be removed or searched for using their transformed form. * For example, if the transformation converts Strings to Integers, you must - * use the Integer form to remove objects. + * use the Integer form to remove objects. *- * This class is Serializable from Commons Collections 3.1.
+ * This class is Serializable from Commons Collections 3.1. * * @since Commons Collections 3.0 * @version $Revision$ @@ -46,7 +46,7 @@ public class TransformedSortedBag* If there are any elements already in the bag being decorated, they - * are NOT transformed. Contrast this with {@link #transformedSortedBag(SortedBag, Transformer)}.
+ * are NOT transformed. Contrast this with {@link #transformedSortedBag(SortedBag, Transformer)}. * * @param* If there are any elements already in the bag being decorated, they * will be transformed by this method. - * Contrast this with {@link #transformingSortedBag(SortedBag, Transformer)}.
+ * Contrast this with {@link #transformingSortedBag(SortedBag, Transformer)}. * * @param* If there are any elements already in the bag being decorated, they - * are NOT transformed.
+ * are NOT transformed. * * @param bag the bag to decorate, must not be null * @param transformer the transformer to use for conversion, must not be null diff --git a/src/main/java/org/apache/commons/collections/bag/UnmodifiableBag.java b/src/main/java/org/apache/commons/collections/bag/UnmodifiableBag.java index 4fa5403b4..f99d82115 100644 --- a/src/main/java/org/apache/commons/collections/bag/UnmodifiableBag.java +++ b/src/main/java/org/apache/commons/collections/bag/UnmodifiableBag.java @@ -32,9 +32,9 @@ import org.apache.commons.collections.set.UnmodifiableSet; /** * Decorates anotherBag
to ensure it can't be altered.
* - * This class is Serializable from Commons Collections 3.1.
+ * This class is Serializable from Commons Collections 3.1. *- * Attempts to modify it will result in an UnsupportedOperationException.
+ * Attempts to modify it will result in an UnsupportedOperationException. * * @since Commons Collections 3.0 * @version $Revision$ @@ -50,7 +50,7 @@ public final class UnmodifiableBag- * If the bag passed in is already unmodifiable, it is returned.
+ * If the bag passed in is already unmodifiable, it is returned. * * @paramSortedBag
to ensure it can't be altered.
* - * This class is Serializable from Commons Collections 3.1.
+ * This class is Serializable from Commons Collections 3.1. *- * Attempts to modify it will result in an UnsupportedOperationException.
+ * Attempts to modify it will result in an UnsupportedOperationException. * * @since Commons Collections 3.0 * @version $Revision$ @@ -50,7 +50,7 @@ public final class UnmodifiableSortedBag- * If the bag passed in is already unmodifiable, it is returned.
+ * If the bag passed in is already unmodifiable, it is returned. * * @param