improve IteratorOfXXX documentation #838

src/main/java/org/cactoos/iterator/IteratorOf.java

@@ -28,7 +28,7 @@
 import java.util.concurrent.atomic.AtomicInteger;
 
 /**
- * Iterator that returns the set of elements.
+ * {@link Iterator} that returns the elements.
  *
  * <p>There is no thread-safety guarantee.</p>
  *

src/main/java/org/cactoos/iterator/IteratorOfBooleans.java

@@ -28,7 +28,7 @@
 import java.util.concurrent.atomic.AtomicInteger;
 
 /**
- * Iterator that returns the set of booleans.
+ * {@link Iterator} that returns the {@code boolean}s as {@link Boolean}s.
  *
  * <p>There is no thread-safety guarantee.</p>
  *

src/main/java/org/cactoos/iterator/IteratorOfChars.java

@@ -28,7 +28,7 @@
 import java.util.concurrent.atomic.AtomicInteger;
 
 /**
- * Iterator that returns the set of chars.
+ * {@link Iterator} that returns the {@code char}s as {@link Character}s.
  *
  * <p>There is no thread-safety guarantee.</p>
  *

src/main/java/org/cactoos/iterator/IteratorOfFloats.java

@@ -28,7 +28,7 @@
 import java.util.concurrent.atomic.AtomicInteger;
 
 /**
- * Iterator that returns the set of floats.
+ * {@link Iterator} that returns the {@code float}s as {@link Float}s.
  *
  * <p>There is no thread-safety guarantee.</p>
  *

src/main/java/org/cactoos/iterator/IteratorOfInts.java

@@ -28,7 +28,7 @@
 import java.util.concurrent.atomic.AtomicInteger;
 
 /**
- * Iterator that returns the set of integers.
+ * {@link Iterator} that returns the {@code int}s as {@link Integer}s.
  *
  * <p>There is no thread-safety guarantee.</p>
  *

src/test/java/org/cactoos/iterator/IteratorOfBooleansTest.java

@@ -29,9 +29,7 @@
 import org.junit.Test;
 
 /**
- * Iterator that returns the set of booleans.
- *
- * <p>There is no thread-safety guarantee.</p>
+ * Tests for {@link IteratorOfBooleans}.
  *
  * @since 0.32
  * @checkstyle JavadocMethodCheck (500 lines)

src/test/java/org/cactoos/iterator/IteratorOfCharsTest.java

@@ -29,9 +29,7 @@
 import org.junit.Test;
 
 /**
- * Iterator that returns the set of chars.
- *
- * <p>There is no thread-safety guarantee.</p>
+ * Tests for {@link IteratorOfChars}.
  *
  * @since 0.32
  * @checkstyle JavadocMethodCheck (500 lines)

src/test/java/org/cactoos/iterator/IteratorOfFloatsTest.java

@@ -31,8 +31,6 @@
 /**
  * Tests for {@link IteratorOfFloats}.
  *
- * <p>There is no thread-safety guarantee.</p>
- *
  * @since 0.32
  * @checkstyle JavadocMethodCheck (500 lines)
  */

src/test/java/org/cactoos/iterator/IteratorOfIntsTest.java

@@ -31,8 +31,6 @@
 /**
  * Tests for {@link IteratorOfInts}.
  *
- * <p>There is no thread-safety guarantee.</p>
- *
  * @since 0.32
  * @checkstyle JavadocMethodCheck (500 lines)
  */