Update javadoc comments

The javadoc CLI included with OpenJDK 8 is OK with literal less than ">"
characters in comments. However, OpenJDK 11 is not. So, I changed these
all to entities.

Also added additional information to a couple of field javadocs.

Also cleaned up a couple of broken @link targets.

Author: dmaccormack

example/example1/src/test/java/org/jsonurl/example1/Example1Test.java

@@ -22,14 +22,14 @@ void test() throws JsonException, IOException {
         JsonArray value = Main.getExampleValue();
 
         //
-        // turn that into JSON->URL text
+        // turn that into JSON->URL text
         //
         JsonUrlStringBuilder text = new JsonUrlStringBuilder();
         JsonUrlWriter.write(text, value);
         String jsonUrlText = text.build();
 
         //
-        // parse the JSON->URL text and build a JsonArray
+        // parse the JSON->URL text and build a JsonArray
         //
         JsonUrlParser p = new JsonUrlParser();
         JsonValue parsedValue = p.parse(jsonUrlText);

module/jsonurl-core/src/main/java/org/jsonurl/JsonUrl.java

@@ -34,10 +34,10 @@
 import java.nio.charset.MalformedInputException;
 
 /**
- * The reference implementation of JSON->URL.
+ * The reference implementation of JSON->URL.
  * 
  * <p>This class provides static methods for performing a number of
- * actions on JSON->URL text.
+ * actions on JSON-&gt;URL text.
  * 
  * @author jsonurl.org
  * @author David MacCormack
@@ -72,7 +72,7 @@ private static final int percentDecode(
         /**
          * parse true, false, and null literals.
          *
-         * @return true if the string matches one of the following JSON->URL
+         * @return true if the string matches one of the following JSON-&gt;URL
          *      literal values: true, false, null.
          */
         @SuppressWarnings("PMD")
@@ -208,7 +208,7 @@ private static final String string(
         /**
          * parse a literal value.
          * 
-         * <p>This will parse a literal value from JSON->URL text and return
+         * <p>This will parse a literal value from JSON-&gt;URL text and return
          * it as a java.lang.String (as opposed to a ValueFactory String).
          * It will perform input validation and string literal decoding.
          *
@@ -253,7 +253,7 @@ static final String literalToJavaString(
         /**
          * parse a literal value
          * 
-         * <p>This will parse a literal value from JSON->URL text. You may use
+         * <p>This will parse a literal value from JSON-&gt;URL text. You may use
          * {@link org.jsonurl.JsonUrl#parseLiteralLength(CharSequence, int, int)
          * parseLiteralLength} to calculate the stop index.
          *

module/jsonurl-core/src/main/java/org/jsonurl/JsonUrlStringBuilder.java

@@ -18,7 +18,7 @@
  */
 
 /**
- * A JsonUrlTextAppender that appends JSON->URL text to a StringBuilder.
+ * A JsonUrlTextAppender that appends JSON->URL text to a StringBuilder.
  *
  * @author jsonurl.org
  * @author David MacCormack

module/jsonurl-core/src/main/java/org/jsonurl/JsonUrlTextAppender.java

@@ -22,7 +22,7 @@
 import java.math.BigInteger;
 
 /**
- * A JsonTextBuilder that appends JSON->URL text to any Appendable.
+ * A JsonTextBuilder that appends JSON->URL text to any Appendable.
  * @param <A> Accumulator type
  * @param <R> Result type
  *
@@ -41,7 +41,7 @@ public abstract class JsonUrlTextAppender<A extends Appendable, R>
     /**
      * Create a new JsonUrlTextAppender.
      *
-     * @param out JSON->URL text destination
+     * @param out JSON-&gt;URL text destination
      */
     public JsonUrlTextAppender(A out) {
         this.out = out;

module/jsonurl-core/src/main/java/org/jsonurl/NumberBuilder.java

@@ -25,9 +25,9 @@
 import java.math.BigInteger;
 
 /**
- * A NumberBuilder implements the builder pattern for JSON->URL numbers.
+ * A NumberBuilder implements the builder pattern for JSON->URL numbers.
  *
- * <p>An instance of this class may be used to parse JSON->URL number
+ * <p>An instance of this class may be used to parse JSON-&gt;URL number
  * values from text and create J2SE8 Numbers.
  *
  * @author jsonurl.org
@@ -322,7 +322,7 @@ public boolean parse(CharSequence s, int start, int stop) {
     }
 
     /**
-     * Determine if the given CharSequence is a valid JSON->URL number.
+     * Determine if the given CharSequence is a valid JSON-&gt;URL number.
      *
      *<p>Convenience for {@link #isNumber(CharSequence, int, int)
      * isNumber(s, 0, s.length())}.
@@ -332,12 +332,12 @@ public static boolean isNumber(CharSequence s) {
     }
 
     /**
-     * Determine if the given CharSequence is a valid JSON->URL number.
+     * Determine if the given CharSequence is a valid JSON-&gt;URL number.
      * 
      * @param s a valid CharSequence
      * @param start an index
      * @param stop an index
-     * @return true if the CharSequence is a JSON->URL number
+     * @return true if the CharSequence is a JSON-&gt;URL number
      */
     @SuppressWarnings("PMD")
     public static boolean isNumber(CharSequence s, int start, int stop) {

module/jsonurl-core/src/main/java/org/jsonurl/NumberText.java

@@ -18,7 +18,7 @@
  */
 
 /**
- * NumberText provides access to a parsed JSON->URL number literal.
+ * NumberText provides access to a parsed JSON->URL number literal.
  *
  * <p>The text of a number is broken down into three parts: integer part,
  * decimal part, and exponent. These parts may be accessed via start and stop

module/jsonurl-core/src/main/java/org/jsonurl/ParseException.java

@@ -18,7 +18,7 @@
  */
 
 /**
- * An exception that occurs while parsing JSON->URL text.
+ * An exception that occurs while parsing JSON->URL text.
  */
 public class ParseException extends RuntimeException {
 
@@ -72,7 +72,7 @@ protected String typeDescription() {
     public String toString() {
         StringBuilder sb = new StringBuilder(64);
 
-        sb.append("JSON->URL ")
+        sb.append("JSON->URL ")
             .append(typeDescription())
             .append(": ")
             .append(getMessage());

module/jsonurl-core/src/main/java/org/jsonurl/Parser.java

@@ -36,9 +36,9 @@
 import java.util.LinkedList;
 
 /**
- * A JSON->URL parser.
+ * A JSON->URL parser.
  * 
- * <p>An instance of this class may be used to parse JSON->URL text and
+ * <p>An instance of this class may be used to parse JSON-&gt;URL text and
  * instantiate JVM heap objects. The interface allows you to control the
  * types and values of the Objects created.
  *
@@ -185,7 +185,7 @@ public V parse(CharSequence s) {
     /**
      * Parse a character sequence.
      *
-     * <p>Parse the given JSON->URL text and return a typed value.
+     * <p>Parse the given JSON-&gt;URL text and return a typed value.
      * @param s the text to be parsed
      * @param off offset of the first character to be parsed
      * @param length the number of characters to be parsed

module/jsonurl-core/src/main/java/org/jsonurl/SyntaxException.java

@@ -18,7 +18,7 @@
  */
 
 /**
- * A syntax error in JSON->URL text. 
+ * A syntax error in JSON->URL text. 
  */
 public class SyntaxException extends ParseException {
 

module/jsonurl-core/src/main/java/org/jsonurl/ValueFactory.java

@@ -20,19 +20,19 @@
 /**
  * A ValueFactory allows {@link org.jsonurl.Parser Parser}
  * to be implementation independent. A ValueFactory provides
- * implementation-defined values for JSON->URL
+ * implementation-defined values for JSON->URL
  * objects, arrays, and literals.
  * 
- * @param V value type (any JSON value)
- * @param C composite type (array or object)
- * @param AB array builder type
- * @param A array type
- * @param JB object builder type
- * @param J object type
- * @param B boolean type
- * @param M number type
- * @param N null type
- * @param S string type
+ * @param <V> value type (any JSON value)
+ * @param <C> composite type (array or object)
+ * @param <ABT> array builder type
+ * @param <A> array type
+ * @param <JBT> object builder type
+ * @param <J> object type
+ * @param <B> boolean type
+ * @param <M> number type
+ * @param <N> null type
+ * @param <S> string type
  *
  * @author jsonurl.org
  * @author David MacCormack
@@ -110,7 +110,7 @@ default J newObject(J builder) {
      *
      * <p>This is usually a singleton. It's a value which represents
      * the empty composite (i.e. array/object) as defined in the
-     * JSON->URL spec.
+     * JSON-&gt;URL spec.
      * @return a valid composite instance
      */
     public C getEmptyComposite();
@@ -215,7 +215,7 @@ default S getString(String s) {
     /**
      * Get a number value for the given parsed text.
      *
-     * @param text the parsed text of a JSON->URL number literal 
+     * @param text the parsed text of a JSON-&gt;URL number literal 
      * @return a number object for the given text
      */
     public M getNumber(NumberText text);