update Java version

Author: peteroupc

api/Home.md

@@ -30,9 +30,9 @@ Holds converters to customize the serialization and deserialization behavior
 Includes options to control how CBOR objects are converted to JSON.
 
 * [com.upokecenter.cbor.PODOptions](com.upokecenter.cbor.PODOptions.md) -
-Options for controlling how certain.NET or Java objects, such as so-called
-  "plain old data" objects (better known as POCOs in.NET or POJOs in
- Java), are converted to CBOR objects.
+Options for controlling how certain DotNET or Java objects, such as
+  so-called "plain old data" objects (better known as POCOs in DotNET or
+ POJOs in Java), are converted to CBOR objects.
 
 * [com.upokecenter.cbor.CBORNumber.NumberKind](com.upokecenter.cbor.CBORNumber.NumberKind.md) -
 Specifies the underlying form of this CBOR number object.

api/com.upokecenter.cbor.CBORObject.md

@@ -1872,13 +1872,14 @@ Converts this CBOR object to an object of an arbitrary type. See the
  in which the rules regarding the number of days in each month and
  which years are leap years are the same for all years as they were
  in 1970 (including without regard to transitions from other
- calendars to the Gregorian). For tag 1, CBOR objects that express
- infinity or not-a-number (NaN) are treated as invalid by this
- method.</li> <li>If the type is <code>java.net.URI</code> (or <code>URI</code> in Java),
- returns a URI object if possible.</li> <li>If the type is
- <code>java.util.UUID</code> (or <code>UUID</code> in Java), returns a UUID object if
- possible.</li> <li>Plain-Old-Data deserialization: If the object is
- a type not specially handled above, the type includes a
+ calendars to the Gregorian). The string format used in tag 0
+ supports only years up to 4 decimal digits long. For tag 1, CBOR
+ objects that express infinity or not-a-number (NaN) are treated as
+ invalid by this method.</li> <li>If the type is <code>java.net.URI</code> (or
+ <code>URI</code> in Java), returns a URI object if possible.</li> <li>If
+ the type is <code>java.util.UUID</code> (or <code>UUID</code> in Java), returns a UUID
+ object if possible.</li> <li>Plain-Old-Data deserialization: If the
+ object is a type not specially handled above, the type includes a
  zero-parameter constructor (default or not), this CBOR object is a
   CBOR map, and the "mapper" parameter (if any) allows this type to be
  eligible for Plain-Old-Data deserialization, then this method checks
@@ -4521,8 +4522,8 @@ Converts this object to a text string in JavaScript object Notation (JSON)
  untagged text strings are converted to JSON strings before writing
   them out (for example, <code>22("Test")</code> is converted to
   <code>"Test"</code> and <code>true</code> is converted to <code>"true"</code>). After
- such conversion, if two or more map keys are identical, this method
- throws a CBORException. The example code given in
+ such conversion, if two or more keys for the same map are identical,
+ this method throws a CBORException. The example code given in
  <b>PeterO.Cbor.CBORObject.ToJSONString(PeterO.Cbor.JSONOptions)</b>
  can be used to write out certain keys of a CBOR map in a given order
  to a JSON string, or to write out a CBOR object as part of a JSON
@@ -4557,18 +4558,18 @@ Converts this object to a text string in JavaScript object Notation (JSON)
  was created using the NewOrderedMap method. Map keys other than
  untagged text strings are converted to JSON strings before writing
   them out (for example, <code>22("Test")</code> is converted to
-  <code>"Test"</code> and <code>true</code> is converted to <code>"true"</code>). If,
- after such conversion, two or more map keys are identical, this
- method throws a CBORException.</li> <li>If a number in the form of
- an arbitrary-precision binary floating-point number has a very high
- binary exponent, it will be converted to a double before being
+  <code>"Test"</code> and <code>true</code> is converted to <code>"true"</code>). After
+ such conversion, if two or more keys for the same map are identical,
+ this method throws a CBORException.</li> <li>If a number in the form
+ of an arbitrary-precision binary floating-point number has a very
+ high binary exponent, it will be converted to a double before being
  converted to a JSON string. (The resulting double could overflow to
  infinity, in which case the arbitrary-precision binary
  floating-point number is converted to null.)</li> <li>The string
  will not begin with a byte-order mark (U+FEFF); RFC 8259 (the JSON
  specification) forbids placing a byte-order mark at the beginning of
  a JSON string.</li> <li>Byte strings are converted to Base64 URL
- without whitespace or padding by default (see section 4.1 of RFC
+ without whitespace or padding by default (see section 3.4.5.3 of RFC
  8949). A byte string will instead be converted to traditional base64
  without whitespace and with padding if it has tag 22, or base16 for
  tag 23. (To create a CBOR object with a given tag, call the

api/com.upokecenter.cbor.PODOptions.md

@@ -2,9 +2,9 @@
 
     public class PODOptions extends java.lang.Object
 
-Options for controlling how certain.NET or Java objects, such as so-called
-  "plain old data" objects (better known as POCOs in.NET or POJOs in
- Java), are converted to CBOR objects.
+Options for controlling how certain DotNET or Java objects, such as
+  so-called "plain old data" objects (better known as POCOs in DotNET or
+ POJOs in Java), are converted to CBOR objects.
 
 ## Fields
 

src/main/java/com/upokecenter/cbor/CBORJsonWriter.java

@@ -25,9 +25,6 @@ static void WriteJSONStringUnquoted(
         sb.WriteString(str, 0, i);
         return;
       }
-      // int bufferlen = Math.min(Math.max(4, str.length()), 64);
-      // byte[] buffer = new byte[bufferlen];
-      // int bufferpos = 0;
       for (; i < str.length(); ++i) {
         char c = str.charAt(i);
         if (c == '\\' || c == '"') {

src/main/java/com/upokecenter/cbor/CBORObject.java

@@ -1501,13 +1501,14 @@ public <T> T ToObject(java.lang.reflect.Type t, PODOptions options) {
      * in which the rules regarding the number of days in each month and
      * which years are leap years are the same for all years as they were
      * in 1970 (including without regard to transitions from other
-     * calendars to the Gregorian). For tag 1, CBOR objects that express
-     * infinity or not-a-number (NaN) are treated as invalid by this
-     * method.</li> <li>If the type is <code>java.net.URI</code> (or <code>URI</code> in Java),
-     * returns a URI object if possible.</li> <li>If the type is
-     * <code>java.util.UUID</code> (or <code>UUID</code> in Java), returns a UUID object if
-     * possible.</li> <li>Plain-Old-Data deserialization: If the object is
-     * a type not specially handled above, the type includes a
+     * calendars to the Gregorian). The string format used in tag 0
+     * supports only years up to 4 decimal digits long. For tag 1, CBOR
+     * objects that express infinity or not-a-number (NaN) are treated as
+     * invalid by this method.</li> <li>If the type is <code>java.net.URI</code> (or
+     * <code>URI</code> in Java), returns a URI object if possible.</li> <li>If
+     * the type is <code>java.util.UUID</code> (or <code>UUID</code> in Java), returns a UUID
+     * object if possible.</li> <li>Plain-Old-Data deserialization: If the
+     * object is a type not specially handled above, the type includes a
      * zero-parameter constructor (default or not), this CBOR object is a
      *  CBOR map, and the "mapper" parameter (if any) allows this type to be
      * eligible for Plain-Old-Data deserialization, then this method checks
@@ -5499,8 +5500,8 @@ public CBORObject Set(Object key, Object valueOb) {
      * untagged text strings are converted to JSON strings before writing
      *  them out (for example, <code>22("Test")</code> is converted to
      *  <code>"Test"</code> and <code>true</code> is converted to <code>"true"</code>). After
-     * such conversion, if two or more map keys are identical, this method
-     * throws a CBORException. The example code given in
+     * such conversion, if two or more keys for the same map are identical,
+     * this method throws a CBORException. The example code given in
      * <b>PeterO.Cbor.CBORObject.ToJSONString(PeterO.Cbor.JSONOptions)</b>
      * can be used to write out certain keys of a CBOR map in a given order
      * to a JSON string, or to write out a CBOR object as part of a JSON
@@ -5535,18 +5536,18 @@ public String ToJSONString() {
      * was created using the NewOrderedMap method. Map keys other than
      * untagged text strings are converted to JSON strings before writing
      *  them out (for example, <code>22("Test")</code> is converted to
-     *  <code>"Test"</code> and <code>true</code> is converted to <code>"true"</code>). If,
-     * after such conversion, two or more map keys are identical, this
-     * method throws a CBORException.</li> <li>If a number in the form of
-     * an arbitrary-precision binary floating-point number has a very high
-     * binary exponent, it will be converted to a double before being
+     *  <code>"Test"</code> and <code>true</code> is converted to <code>"true"</code>). After
+     * such conversion, if two or more keys for the same map are identical,
+     * this method throws a CBORException.</li> <li>If a number in the form
+     * of an arbitrary-precision binary floating-point number has a very
+     * high binary exponent, it will be converted to a double before being
      * converted to a JSON string. (The resulting double could overflow to
      * infinity, in which case the arbitrary-precision binary
      * floating-point number is converted to null.)</li> <li>The string
      * will not begin with a byte-order mark (U+FEFF); RFC 8259 (the JSON
      * specification) forbids placing a byte-order mark at the beginning of
      * a JSON string.</li> <li>Byte strings are converted to Base64 URL
-     * without whitespace or padding by default (see section 4.1 of RFC
+     * without whitespace or padding by default (see section 3.4.5.3 of RFC
      * 8949). A byte string will instead be converted to traditional base64
      * without whitespace and with padding if it has tag 22, or base16 for
      * tag 23. (To create a CBOR object with a given tag, call the

src/main/java/com/upokecenter/cbor/PODOptions.java

@@ -1,9 +1,9 @@
 package com.upokecenter.cbor;
 
   /**
-   * Options for controlling how certain.NET or Java objects, such as so-called
-   *  "plain old data" objects (better known as POCOs in.NET or POJOs in
-   * Java), are converted to CBOR objects.
+   * Options for controlling how certain DotNET or Java objects, such as
+   *  so-called "plain old data" objects (better known as POCOs in DotNET or
+   * POJOs in Java), are converted to CBOR objects.
    */
   public class PODOptions {
     /**