Resolve Javadoc quality issues (#334)

version/src/main/java/io/smallrye/common/version/AbstractVersionIterator.java

@@ -11,20 +11,40 @@
  * version strings which are greater than 4095 characters in length.
  */
 public abstract class AbstractVersionIterator implements VersionIterator {
+    /**
+     * The version string being iterated.
+     */
     protected final String string;
     long cookie;
 
     /**
      * The current state of iteration.
      */
     protected enum TokenType {
+        /**
+         * The initial state.
+         */
         INITIAL,
+        /**
+         * A part of the version string which is an alpha part.
+         */
         PART_ALPHA,
+        /**
+         * A part of the version string which is a numeric part.
+         */
         PART_NUMBER,
+        /**
+         * A separator character.
+         */
         SEP_EMPTY,
+        /**
+         * A non-empty separator character.
+         */
         SEP,
-        INVALID,
-        ;
+        /**
+         * An invalid state.
+         */
+        INVALID;
 
         static TokenType[] values = values();
     }

version/src/main/java/io/smallrye/common/version/VersionScheme.java

@@ -149,7 +149,7 @@ default Predicate<String> fromRangeString(String range) {
     /**
      * Parse a range specification and return it as a predicate.
      * Version ranges are governed by the following general syntax:
-     * <code><pre>
+     * <code>
 range ::= range-spec ',' range
         | range-spec
 
@@ -163,7 +163,7 @@ default Predicate<String> fromRangeString(String range) {
 max-version ::= version ']'
               | version ')'
               | ')'
-</pre></code>
+     </code>
      * This is aligned with the syntax used by Maven, however it can be applied to any
      * supported version scheme.
      * <p>