Update netty to 4.1.115.Final

Also clean up a number of javadoc warnings from Java 21

Author: gmfeinberg

driver/pom.xml

@@ -46,7 +46,7 @@
     <copyright>Copyright (c) 2011, 2024 Oracle and/or its affiliates. All rights reserved.</copyright>
     <java.apidoc>http://docs.oracle.com/javase/8/docs/api</java.apidoc>
     <maven.deploy.skip>false</maven.deploy.skip>
-    <netty.version>4.1.108.Final</netty.version>
+    <netty.version>4.1.115.Final</netty.version>
     <jackson.version>2.15.2</jackson.version>
    <!-- by default, skip tests; tests require a profile -->
    <maven.test.skip>true</maven.test.skip>
@@ -379,7 +379,7 @@
         <version>3.5.0</version>
         <configuration>
           <quiet>true</quiet>
-          <!-- consider this: <doclint>-missing</doclint> -->
+          <doclint>-missing</doclint>
           <source>8</source>
           <doctitle>${project.name} ${project.version}</doctitle>
           <windowtitle>${project.name} ${project.version}</windowtitle>

driver/src/main/java/oracle/nosql/driver/BatchOperationNumberLimitException.java

@@ -19,8 +19,9 @@ public class BatchOperationNumberLimitException extends ResourceLimitException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the message
+     * @hidden
      */
     public BatchOperationNumberLimitException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/DeploymentException.java

@@ -20,8 +20,9 @@ public class DeploymentException extends ResourceLimitException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public DeploymentException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/DriverMain.java

@@ -14,11 +14,11 @@
 import java.util.jar.Manifest;
 
 /**
- * @hidden
- *
  * A simple main for the driver jar file. At this time it only handles a
  * "version" command. If it ever is extended for other arguments it should
  * be better abstracted for multiple commands
+ *
+ * @hidden
  */
 public class DriverMain {
 

driver/src/main/java/oracle/nosql/driver/EvolutionLimitException.java

@@ -18,9 +18,10 @@ public class EvolutionLimitException extends ResourceLimitException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      *
      * @param msg the exception message
+     * @hidden
      */
     public EvolutionLimitException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/IndexExistsException.java

@@ -16,8 +16,9 @@ public class IndexExistsException extends ResourceExistsException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public IndexExistsException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/IndexLimitException.java

@@ -18,8 +18,9 @@ public class IndexLimitException extends ResourceLimitException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public IndexLimitException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/IndexNotFoundException.java

@@ -16,8 +16,9 @@ public class IndexNotFoundException extends ResourceNotFoundException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public IndexNotFoundException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/InvalidAuthorizationException.java

@@ -16,8 +16,9 @@ public class InvalidAuthorizationException extends NoSQLException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public InvalidAuthorizationException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/JsonParseException.java

@@ -26,17 +26,19 @@ public class JsonParseException extends NoSQLException {
     private JsonLocation location;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public JsonParseException(String msg) {
         super(msg);
     }
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
      * @param location the exception location in the input
+     * @hidden
      */
     public JsonParseException(String msg, JsonLocation location) {
         super(msg);
@@ -79,8 +81,9 @@ public String toString() {
     }
 
     /**
-     * @hidden
+     * Internal use only
      * @return the location of the exception in the input
+     * @hidden
      */
     public JsonLocation getLocation() {
         return location;