Typographic changes

src/main/java/org/libj/lang/AnnotationParameterException.java

@@ -50,6 +50,6 @@ public AnnotationParameterException(final Annotation annotation, final String me
    * @return The {@link Annotation} that is the subject of this exception.
    */
   public Annotation annotation() {
-    return this.annotation;
+    return annotation;
   }
 }

src/main/java/org/libj/lang/Classes.java

@@ -660,8 +660,7 @@ public static Field getDeclaredFieldDeep(Class<?> cls, final String name) {
    */
   @SuppressWarnings("unchecked")
   public static <T> Constructor<T> getConstructor(final Class<T> cls, final Class<?> ... parameterTypes) {
-    final Constructor<?>[] constructors = cls.getConstructors();
-    for (final Constructor<?> constructor : constructors) // [A]
+    for (final Constructor<?> constructor : cls.getConstructors()) // [A]
       if (isMatch(constructor, parameterTypes))
         return (Constructor<T>)constructor;
 
@@ -688,8 +687,7 @@ public static <T> Constructor<T> getConstructor(final Class<T> cls, final Class<
    */
   @SuppressWarnings("unchecked")
   public static <T> Constructor<T> getConstructor(final Class<T> cls) {
-    final Constructor<?>[] constructors = cls.getConstructors();
-    for (final Constructor<?> constructor : constructors) // [A]
+    for (final Constructor<?> constructor : cls.getConstructors()) // [A]
       if (constructor.getParameterCount() == 0)
         return (Constructor<T>)constructor;
 
@@ -717,8 +715,7 @@ public static <T> Constructor<T> getConstructor(final Class<T> cls) {
    */
   @SuppressWarnings("unchecked")
   public static <T> Constructor<T> getCompatibleConstructor(final Class<T> cls, final Class<?> ... parameterTypes) {
-    final Constructor<?>[] constructors = cls.getConstructors();
-    for (final Constructor<?> constructor : constructors) // [A]
+    for (final Constructor<?> constructor : cls.getConstructors()) // [A]
       if (isCompatible(constructor.getParameterTypes(), parameterTypes))
         return (Constructor<T>)constructor;
 
@@ -748,8 +745,7 @@ public static <T> Constructor<T> getCompatibleConstructor(final Class<T> cls, fi
    */
   @SuppressWarnings("unchecked")
   public static <T> Constructor<T> getDeclaredConstructor(final Class<T> cls, final Class<?> ... parameterTypes) {
-    final Constructor<?>[] constructors = cls.getDeclaredConstructors();
-    for (final Constructor<?> constructor : constructors) // [A]
+    for (final Constructor<?> constructor : cls.getDeclaredConstructors()) // [A]
       if (isMatch(constructor, parameterTypes))
         return (Constructor<T>)constructor;
 
@@ -778,8 +774,7 @@ public static <T> Constructor<T> getDeclaredConstructor(final Class<T> cls, fina
    */
   @SuppressWarnings("unchecked")
   public static <T> Constructor<T> getDeclaredConstructor(final Class<T> cls) {
-    final Constructor<?>[] constructors = cls.getDeclaredConstructors();
-    for (final Constructor<?> constructor : constructors) // [A]
+    for (final Constructor<?> constructor : cls.getDeclaredConstructors()) // [A]
       if (constructor.getParameterCount() == 0)
         return (Constructor<T>)constructor;
 

src/main/java/org/libj/lang/EnumerationIterator.java

@@ -20,9 +20,20 @@
 import java.util.Iterator;
 import java.util.Objects;
 
+/**
+ * An {@link Iterator} over an {@link Enumeration}.
+ *
+ * @param <E> The type parameter of the {@link Enumeration}.
+ */
 public class EnumerationIterator<E> implements Iterator<E> {
   private final Enumeration<E> enumeration;
 
+  /**
+   * Creates a new {@link EnumerationIterator} with the provided {@link Enumeration}.
+   *
+   * @param enumeration The {@link Enumeration} backing this {@link EnumerationIterator}.
+   * @throws NullPointerException If {@code enumeration} is null.
+   */
   public EnumerationIterator(final Enumeration<E> enumeration) {
     this.enumeration = Objects.requireNonNull(enumeration);
   }
@@ -37,6 +48,9 @@ public E next() {
     return enumeration.nextElement();
   }
 
+  /**
+   * Throws {@link UnsupportedOperationException}, because removing elements from an {@link Enumeration} is not supported.
+   */
   @Override
   public void remove() {
     throw new UnsupportedOperationException();

src/main/java/org/libj/lang/Enumerations.java

@@ -174,6 +174,7 @@ public void forEachRemaining(final Consumer<? super T> action) {
    * @param enumeration The {@link Enumeration}.
    * @return The size of the provided {@link Enumeration}.
    * @throws NullPointerException If {@code enumeration} is null.
+   * @implNote After the execution of this method, the provided {@link Enumeration} will be fully consumed.
    */
   public static int getSize(final Enumeration<?> enumeration) {
     int size = 0;

src/main/java/org/libj/lang/IllegalAnnotationException.java

@@ -51,6 +51,6 @@ public IllegalAnnotationException(final Annotation annotation, final String mess
    * @return The {@link Annotation} that is the subject of this exception.
    */
   public Annotation annotation() {
-    return this.annotation;
+    return annotation;
   }
 }

src/test/java/org/libj/lang/DeclarativeOrderTest.java

@@ -26,10 +26,10 @@ public class DeclarativeOrderTest {
   private static void test(final DeclarativeOrderPolicy declarativeOrderPolicy) throws ClassNotFoundException {
     final Method[] methods = declarativeOrderPolicy.getMethods(DeclarativeOrderTest0.class, Test.class);
     assertTrue(Classes.sortDeclarativeOrder(methods, declarativeOrderPolicy.isSuperFirst()));
-    for (int i = 0, i$ = methods.length; i < i$; ++i) {
+    for (int i = 0; i < methods.length; ++i) { // [A]
       final Method method = methods[i];
       final ExpectOrders expectOrders = method.getAnnotation(ExpectOrders.class);
-      for (final ExpectOrder expectOrder : expectOrders.value())
+      for (final ExpectOrder expectOrder : expectOrders.value()) // [A]
         if (expectOrder.policy() == declarativeOrderPolicy)
           assertEquals(i + "  " + method.getDeclaringClass().getName() + ":" + method.getName() + " " + expectOrder.order(), expectOrder.order(), i);
     }

src/test/java/org/libj/lang/DeclarativeOrderTest2.java

@@ -33,7 +33,7 @@ void assertIndex(final String sig) throws NoSuchMethodException {
     final StackTraceElement[] stackTraceElements = Thread.currentThread().getStackTrace();
     final Method method = getClass().getMethod(stackTraceElements[2].getMethodName());
     final ExpectOrders expectOrders = method.getAnnotation(ExpectOrders.class);
-    for (final ExpectOrder expectOrder : expectOrders.value())
+    for (final ExpectOrder expectOrder : expectOrders.value()) // [A]
       if (expectOrder.policy() == PUBLIC_SUPER_FIRST)
         assertEquals(index + "  " + method.getDeclaringClass().getName() + ":" + method.getName() + " " + expectOrder.order(), expectOrder.order(), index);