add missing @since annotations, fix javadoc comment block syntax

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

@@ -233,7 +233,7 @@ public final class Hibernate {
 				: list.get(key);
 	}
 
-	/*
+	/**
 	 * Remove the value associated with the given key by the given persistent
 	 * map, without fetching the state of the map from the database.
 	 *
@@ -250,7 +250,7 @@ public final class Hibernate {
 				: map.remove( key );
 	}
 
-	/*
+	/**
 	 * Remove the specified element of the given persistent set,
 	 * without fetching the state of the set from the database.
 	 *
@@ -266,7 +266,7 @@ public final class Hibernate {
 				: set.remove( element );
 	}
 
-	/*
+	/**
 	 * Remove the specified element of the given persistent list,
 	 * without fetching the state of the list from the database.
 	 *

hibernate-core/src/main/java/org/hibernate/annotations/OnDeleteAction.java

@@ -34,16 +34,22 @@ public enum OnDeleteAction {
 
 	/**
 	 * Prevents deletion of the parent by raising an error immediately.
+	 *
+	 * @since 6.2
 	 */
 	RESTRICT,
 
 	/**
 	 * Set the referencing foreign key to null.
+	 *
+	 * @since 6.2
 	 */
 	SET_NULL,
 
 	/**
 	 * Set the referencing foreign key to its default value.
+	 *
+	 * @since 6.2
 	 */
 	SET_DEFAULT;
 

hibernate-core/src/main/java/org/hibernate/tool/schema/spi/SchemaTruncator.java

@@ -11,6 +11,10 @@ import org.hibernate.boot.Metadata;
 
 /**
  * Service delegate for handling schema truncation.
+ *
+ * @author Gavin King
+ *
+ * @since 6.2
  */
 @Incubating
 public interface SchemaTruncator {