Fix 9 javadoc errors in o.p.p.internal module

Author: jcflack

pljava/src/main/java/org/postgresql/pljava/internal/DualState.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2018-2020 Tada AB and other contributors, as listed below.
+ * Copyright (c) 2018-2025 Tada AB and other contributors, as listed below.
  *
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the The BSD 3-Clause License
@@ -378,9 +378,9 @@ protected Manager initialValue()
 			 * Increment a thread-local count of pins for a DualState object.
 			 * @return null if there was already at least one pin counted for
 			 * the object (that is, no real pin will need to be taken; this is
-			 * a reentrant pin); otherwise, a Supplier<Queue<Thread>> that can
-			 * supply a preallocated queue prepopulated with the current thread,
-			 * in case inflation is needed.
+			 * a reentrant pin); otherwise, a {@code Supplier<Queue<Thread>>}
+			 * that can supply a preallocated queue prepopulated with
+			 * the current thread, in case inflation is needed.
 			 */
 			Supplier<Queue<Thread>> pin(DualState<?> s)
 			{

pljava/src/main/java/org/postgresql/pljava/internal/EntryPoints.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020-2021 Tada AB and other contributors, as listed below.
+ * Copyright (c) 2020-2025 Tada AB and other contributors, as listed below.
  *
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the The BSD 3-Clause License
@@ -170,8 +170,8 @@ private static Object invoke(Invocable<PrivilegedAction<Object>> target)
 	 * as ordinary function calls are, and the {@code ParameterFrame} save and
 	 * restore mechanism relies on those, so it is better for this entry point
 	 * also to be handled specially.
-	 * @param t Invocable carrying the appropriate AccessControlContext (t's
-	 * action is unused and expected to be null)
+	 * @param target Invocable carrying the appropriate AccessControlContext
+	 * (<var>target</var>'s action is unused and expected to be null)
 	 * @param o the UDT instance
 	 * @param stream the SQLOutput stream on which the type's internal
 	 * representation will be written
@@ -269,8 +269,8 @@ private static SQLData udtReadInvoke(
 	 * NUL-terminated storage form, and without being separately wrapped in
 	 * {@code pushInvocation}/{@code popInvocation}, so it gets its own entry
 	 * point here to avoid use of the static parameter area.
-	 * @param mh a MethodHandle to the class's static parse method, which will
-	 * allocate and return an instance.
+	 * @param target a MethodHandle to the class's static parse method, which
+	 * will allocate and return an instance.
 	 * @param textRep the text representation
 	 * @param typeName the SQL type name to be associated with the instance
 	 * @return the allocated and initialized instance

pljava/src/main/java/org/postgresql/pljava/internal/Function.java

@@ -2019,8 +2019,9 @@ else if ( t instanceof TypeBindings )
 
 	/**
 	 * A class recording the bindings made in a ParameterizedType to the type
-	 * parameters in a GenericDeclaration<Class>. Implements {@code Type} so it
-	 * can be added to the {@code pending} queue in {@code specialization}.
+	 * parameters in a {@code GenericDeclaration<Class>}. Implements
+	 * {@code Type} so it can be added to the {@code pending} queue in
+	 * {@code specialization}.
 	 *<p>
 	 * In {@code specialization}, the tree of superclasses/superinterfaces will
 	 * be searched breadth-first, with all of a node's immediate supers enqueued

pljava/src/main/java/org/postgresql/pljava/internal/ObjectPoolImpl.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2004-2020 Tada AB and other contributors, as listed below.
+ * Copyright (c) 2004-2025 Tada AB and other contributors, as listed below.
  *
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the The BSD 3-Clause License
@@ -62,9 +62,6 @@ private ObjectPoolImpl(Class<T> c)
 
 	/**
 	 * Obtain a pool for the given class.
-	 * @param cls
-	 * @return
-	 * @throws SQLException
 	 */
 	@SuppressWarnings("unchecked")
 	public static <T extends PooledObject> ObjectPoolImpl<T>

pljava/src/main/java/org/postgresql/pljava/jdbc/SQLXMLImpl.java

@@ -4215,7 +4215,8 @@ protected Exception exceptions()
 		}
 
 		/**
-		 * Common factor of subclass {@link #lax() lax()} instance methods.
+		 * Common factor of subclass {@link #lax(boolean) lax(boolean)}
+		 * instance methods.
 		 *<p>
 		 * The work is done here, but the instance methods are implemented
 		 * per-subclass to avoid unchecked casting of 'this'.

pljava/src/main/java/org/postgresql/pljava/management/Commands.java

@@ -1237,7 +1237,6 @@ public static void aliasJavaLanguage(
 	 * jar.
 	 * 
 	 * @param jarName The name to check.
-	 * @throws IOException
 	 */
 	private static void assertJarName(String jarName) throws SQLException
 	{
@@ -1406,7 +1405,7 @@ private static int getJarId(String jarName, AclId[] ownerRet)
 	/**
 	 * Returns the Oid for the given Schema.
 	 * 
-	 * @param schemaName The name of the schema.
+	 * @param schema The name of the schema.
 	 * @return The Oid of the given schema or <code>null</code> if no such
 	 *         schema is found.
 	 * @throws SQLException