update Java version

Author: peteroupc

api/com.upokecenter.util.BigInteger.md

@@ -19,7 +19,7 @@ Use EInteger from PeterO.Numbers/com.upokecenter.numbers.
  Deprecated.  Finds the minimum number of bits needed to represent this object's
  value, except for its sign.
 * `int compareTo(BigInteger other)`<br>
- Deprecated.  Not documented yet.
+ Deprecated.  Compares this value to another.
 * `boolean equals(Object obj)`<br>
  Deprecated.  Determines whether this object and another object are equal.
 * `static BigInteger fromBytes(byte[] bytes,
@@ -244,8 +244,9 @@ Deprecated.&nbsp;
 
 **Parameters:**
 
-* <code>other</code> - The parameter <code>other</code> is a BigInteger object.
+* <code>other</code> - The parameter <code>other</code> is an arbitrary-precision integer.
 
 **Returns:**
 
-* A 32-bit signed integer.
+* Less than 0 if this value is less than, 0 if equal to, or greater
+ than 0 if greater than the other value.

api/com.upokecenter.util.ExtendedDecimal.md

@@ -34,7 +34,7 @@ Use EDecimal from PeterO.Numbers/com.upokecenter.numbers.
 ## Methods
 
 * `int compareTo(ExtendedDecimal other)`<br>
- Deprecated.  Not documented yet.
+ Deprecated.  Compares this extended decimal to another.
 * `static ExtendedDecimal Create(BigInteger mantissa,
       BigInteger exponent)`<br>
  Deprecated.  Creates a number with the value exponent*10^mantissa.
@@ -295,7 +295,8 @@ Deprecated.&nbsp;
 
 **Returns:**
 
-* A 32-bit signed integer.
+* Less than 0 if this value is less than, 0 if equal to, or greater
+ than 0 if greater than the other extended decimal.
 
 ### signum
     @Deprecated public final int signum()

api/com.upokecenter.util.ExtendedFloat.md

@@ -38,7 +38,7 @@ Use EFloat from PeterO.Numbers/com.upokecenter.numbers.
 ## Methods
 
 * `int compareTo(ExtendedFloat other)`<br>
- Deprecated.  Not documented yet.
+ Deprecated.  Compares this extended float to another.
 * `static ExtendedFloat Create(BigInteger mantissa,
       BigInteger exponent)`<br>
  Deprecated.  Creates a number with the value exponent*2^mantissa.
@@ -58,7 +58,7 @@ Use EFloat from PeterO.Numbers/com.upokecenter.numbers.
 Use EFloat from PeterO.Numbers/com.upokecenter.numbers.
  Use EFloat from PeterO.Numbers/com.upokecenter.numbers.
 * `static ExtendedFloat FromString(String str)`<br>
- Deprecated.  Not documented yet.
+ Deprecated.  Creates a binary float from a text string that represents a number.
 * `static ExtendedFloat FromString(String str,
           int offset,
           int length,
@@ -289,11 +289,11 @@ Deprecated.&nbsp;
 
 **Parameters:**
 
-* <code>str</code> - The parameter <code>str</code> is not documented yet.
+* <code>str</code> - A text string containing the number to convert.
 
 **Returns:**
 
-* An ExtendedFloat object.
+* The parsed number, converted to arbitrary-precision binary float.
 
 ### toString
     public String toString()
@@ -383,7 +383,8 @@ Deprecated.&nbsp;
 
 **Returns:**
 
-* A 32-bit signed integer.
+* Less than 0 if this value is less than, 0 if equal to, or greater
+ than 0 if greater than the other value.
 
 ### signum
     @Deprecated public final int signum()

api/com.upokecenter.util.ExtendedRational.md

@@ -39,17 +39,17 @@ Use ERational from PeterO.Numbers/com.upokecenter.numbers.
 ## Methods
 
 * `int compareTo(ExtendedRational other)`<br>
- Deprecated.  Not documented yet.
+ Deprecated.  Compares this value to another.
 * `static ExtendedRational Create(BigInteger numerator,
       BigInteger denominator)`<br>
  Deprecated.  Creates a rational number with the given numerator and denominator.
 * `static ExtendedRational Create(int numeratorSmall,
       int denominatorSmall)`<br>
  Deprecated.  Creates a rational number with the given numerator and denominator.
 * `boolean equals(ExtendedRational other)`<br>
- Deprecated.  Not documented yet.
+ Deprecated.  Checks whether this and another value are equal.
 * `boolean equals(Object obj)`<br>
- Deprecated.  Not documented yet.
+ Deprecated.  Checks whether this and another value are equal.
 * `BigInteger getDenominator()`<br>
  Deprecated.  Gets this object's denominator.
 * `BigInteger getNumerator()`<br>
@@ -228,7 +228,8 @@ Deprecated.&nbsp;
 
 **Returns:**
 
-* A 32-bit signed integer.
+* Less than 0 if this value is less than, 0 if equal to, or greater
+ than 0 if greater than the other value.
 
 ### equals
     public boolean equals(ExtendedRational other)
@@ -240,7 +241,7 @@ Deprecated.&nbsp;
 
 **Returns:**
 
-* either <code>true</code> or <code>false</code>.
+* Either <code>true</code> or <code>false</code>.
 
 ### equals
     public boolean equals(Object obj)
@@ -256,7 +257,7 @@ Deprecated.&nbsp;
 
 **Returns:**
 
-* either <code>true</code> or <code>false</code>.
+* Either <code>true</code> or <code>false</code>.
 
 ### hashCode
     public int hashCode()

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

@@ -4623,7 +4623,7 @@ private static List<Object> WriteChildObject(
           WriteObjectMap(child.AsMap(), outputStream, stack, options);
           stack.remove(stack.size() - 1);
         } else {
-          child.WriteTo(outputStream);
+          child.WriteTo(outputStream, options);
         }
       }
       return stack;

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

@@ -225,7 +225,8 @@ public CBORObject ReadForFirstByte(
                 throw new CBORException("Length" + ToUnsignedBigInteger(len) +
                   " is bigger than supported ");
               }
-              if (nextByte != 0x40) {  // NOTE: 0x40 means the empty byte String
+              if (nextByte != 0x40) {
+  // NOTE: 0x40 means the empty byte String
                 ReadByteData(this.stream, len, ms);
               }
             }
@@ -278,7 +279,8 @@ public CBORObject ReadForFirstByte(
               throw new CBORException("Length" + ToUnsignedBigInteger(len) +
                 " is bigger than supported");
             }
-            if (nextByte != 0x60) {  // NOTE: 0x60 means the empty String
+            if (nextByte != 0x60) {
+  // NOTE: 0x60 means the empty String
               if (PropertyMap.ExceedsKnownLength(this.stream, len)) {
                 throw new CBORException("Premature end of data");
               }

src/main/java/com/upokecenter/util/BigInteger.java

@@ -211,9 +211,10 @@ public String toRadixString(int radix) {
     }
 
     /**
-     * Not documented yet.
-     * @param other The parameter {@code other} is a BigInteger object.
-     * @return A 32-bit signed integer.
+     * Compares this value to another.
+     * @param other The parameter {@code other} is an arbitrary-precision integer.
+     * @return Less than 0 if this value is less than, 0 if equal to, or greater
+     * than 0 if greater than the other value.
      */
     public int compareTo(BigInteger other) {
       return this.getEi().compareTo(other == null ? null : other.getEi());

src/main/java/com/upokecenter/util/ExtendedDecimal.java

@@ -364,9 +364,10 @@ public boolean IsQuietNaN() {
     }
 
     /**
-     * Not documented yet.
+     * Compares this extended decimal to another.
      * @param other The parameter {@code other} is an ExtendedDecimal object.
-     * @return A 32-bit signed integer.
+     * @return Less than 0 if this value is less than, 0 if equal to, or greater
+     * than 0 if greater than the other extended decimal.
      */
     public int compareTo(ExtendedDecimal other) {
       return this.getEd().compareTo(other == null ? null : other.getEd());

src/main/java/com/upokecenter/util/ExtendedFloat.java

@@ -244,9 +244,9 @@ public static ExtendedFloat FromString(
     }
 
     /**
-     * Not documented yet.
-     * @param str The parameter {@code str} is not documented yet.
-     * @return An ExtendedFloat object.
+     * Creates a binary float from a text string that represents a number.
+     * @param str A text string containing the number to convert.
+     * @return The parsed number, converted to arbitrary-precision binary float.
      */
     public static ExtendedFloat FromString(String str) {
       return new ExtendedFloat(EFloat.FromString(str));
@@ -398,9 +398,10 @@ public boolean IsSignalingNaN() {
     }
 
     /**
-     * Not documented yet.
+     * Compares this extended float to another.
      * @param other The parameter {@code other} is not documented yet.
-     * @return A 32-bit signed integer.
+     * @return Less than 0 if this value is less than, 0 if equal to, or greater
+     * than 0 if greater than the other value.
      */
     public int compareTo(ExtendedFloat other) {
       return this.getEf().compareTo(other == null ? null : other.getEf());

src/main/java/com/upokecenter/util/ExtendedRational.java

@@ -243,27 +243,28 @@ private static ExtendedRational FromBigIntegerInternal(BigInteger bigint) {
     }
 
     /**
-     * Not documented yet.
+     * Compares this value to another.
      * @param other The parameter {@code other} is an ExtendedRational object.
-     * @return A 32-bit signed integer.
+     * @return Less than 0 if this value is less than, 0 if equal to, or greater
+     * than 0 if greater than the other value.
      */
     public int compareTo(ExtendedRational other) {
       return this.getEr().compareTo(other == null ? null : other.getEr());
     }
 
     /**
-     * Not documented yet.
+     * Checks whether this and another value are equal.
      * @param other The parameter {@code other} is an ExtendedRational object.
-     * @return either {@code true} or {@code false}.
+     * @return Either {@code true} or {@code false}.
      */
     public boolean equals(ExtendedRational other) {
       return this.getEr().equals(other == null ? null : other.getEr());
     }
 
     /**
-     * Not documented yet.
+     * Checks whether this and another value are equal.
      * @param obj The parameter {@code obj} is an arbitrary object.
-     * @return either {@code true} or {@code false}.
+     * @return Either {@code true} or {@code false}.
      */
     @Override public boolean equals(Object obj) {
       ExtendedRational other = ((obj instanceof ExtendedRational) ? (ExtendedRational)obj : null);