javadoc improvements to an SPI

Author: gavinking

hibernate-core/src/main/java/org/hibernate/LockOptions.java

@@ -481,7 +481,6 @@ public LockOptions setTimeOut(int timeout) {
 		return setTimeout( Timeouts.interpretMilliSeconds( timeout ) );
 	}
 
-
 	/**
 	 * The current lock scope:
 	 * <ul>

hibernate-core/src/main/java/org/hibernate/jpa/spi/NativeQueryConstructorTransformer.java

@@ -8,10 +8,16 @@
 import org.hibernate.query.TupleTransformer;
 
 import java.lang.reflect.Constructor;
-import java.util.List;
 
 /**
- * A {@link TupleTransformer} for handling {@link List} results from native queries.
+ * A {@link TupleTransformer} which packages each native query result in
+ * an instance of the result class by calling an appropriate constructor.
+ *
+ * @implNote The result type must have exactly one constructor with the
+ * correct number of parameters. Constructors cannot be disambiguated by
+ * parameter type.
+ *
+ * @since 6.3
  *
  * @author Gavin King
  */

hibernate-core/src/main/java/org/hibernate/jpa/spi/NativeQueryListTransformer.java

@@ -11,6 +11,8 @@
 /**
  * A {@link TupleTransformer} for handling {@link List} results from native queries.
  *
+ * @since 6.3
+ *
  * @author Gavin King
  */
 public class NativeQueryListTransformer implements TupleTransformer<List<Object>> {

hibernate-core/src/main/java/org/hibernate/jpa/spi/NativeQueryMapTransformer.java

@@ -14,6 +14,8 @@
 /**
  * A {@link TupleTransformer} for handling {@link Map} results from native queries.
  *
+ * @since 6.3
+ *
  * @author Gavin King
  */
 public class NativeQueryMapTransformer implements TupleTransformer<Map<String,Object>> {