Bug 36431400 - [36242646->24.09] javadoc: update the QueryPlus and CacheFactory.main javadoc to indicate that JLine integration is supported

RQ: job.9.20240322051551.22624

[git-p4: depot-paths = "//dev/coherence-ce/main/": change = 107821]

Author: fryp

prj/coherence-core/src/main/java/com/tangosol/coherence/dslquery/QueryPlus.java

@@ -1,12 +1,13 @@
 /*
- * Copyright (c) 2000, 2022, Oracle and/or its affiliates.
+ * Copyright (c) 2000, 2024, Oracle and/or its affiliates.
  *
  * Licensed under the Universal Permissive License v 1.0 as shown at
  * https://oss.oracle.com/licenses/upl.
  */
 package com.tangosol.coherence.dslquery;
 
 import com.oracle.coherence.common.util.Duration;
+
 import com.tangosol.coherence.dslquery.queryplus.AbstractQueryPlusStatementBuilder;
 import com.tangosol.coherence.dslquery.queryplus.CommandsStatementBuilder;
 import com.tangosol.coherence.dslquery.queryplus.ExtendedLanguageStatementBuilder;
@@ -44,6 +45,12 @@
 /**
  * QueryPlus implements a simple command line processor for a sql like
  * language.
+ * <p>
+ * QueryPlus can use JLine for enhanced command-line editing capabilities,
+ * such as having the up and down arrows move through the command history.
+ * However, JLine is not required. QueryPlus supports JLine when the JLine 3.x library
+ * is included in the QueryPlus JVM classpath. If JLine is not found,
+ * a message displays and QueryPlus starts without JLine capabilities.
  *
  * @author djl  2009.08.31
  * @author jk   2014.01.02

prj/coherence-core/src/main/java/com/tangosol/net/CacheFactory.java

@@ -1,18 +1,18 @@
 /*
- * Copyright (c) 2000, 2023, Oracle and/or its affiliates.
+ * Copyright (c) 2000, 2024, Oracle and/or its affiliates.
  *
  * Licensed under the Universal Permissive License v 1.0 as shown at
  * https://oss.oracle.com/licenses/upl.
  */
 
 package com.tangosol.net;
 
-
 import com.oracle.coherence.common.base.Blocking;
 import com.oracle.coherence.common.base.Lockable;
 import com.oracle.coherence.common.base.Logger;
 
 import com.tangosol.net.cache.TypeAssertion;
+
 import com.tangosol.net.security.LocalPermission;
 
 import com.tangosol.run.xml.XmlElement;
@@ -34,9 +34,6 @@
 import java.util.Iterator;
 import java.util.List;
 
-import java.util.function.Supplier;
-
-
 /**
 * Factory for the <b>Coherence&#8482;</b> cache product.
 * <p>
@@ -1068,6 +1065,12 @@ public static void setLoggingLevel(Integer ILevel)
 
     /**
     * Invoke the Coherence command line tool.
+    * <p>
+    * The Coherence command line tool can use JLine for enhanced command-line
+    * editing capabilities, such as having the up and down arrows move through
+    * the command history. However, JLine is not required. The Coherence command
+    * line tool supports JLine when the JLine 3.x library is included in the
+    * tool's JVM classpath.
     */
     public static void main(String[] asArg)
             throws Exception
@@ -1080,7 +1083,6 @@ public static void main(String[] asArg)
         METHOD_MAIN.invoke(null, new Object[] {asArg});
         }
 
-
     // ----- constants ------------------------------------------------------
 
     /**