fix up javadoc for SqlScriptCommandExtractor and friends

Author: gavinking

hibernate-core/src/main/java/org/hibernate/cfg/SchemaToolingSettings.java

@@ -216,14 +216,15 @@ public interface SchemaToolingSettings {
 	 * <p>
 	 * The correct extractor to use depends on the format of the SQL script:
 	 * <ul>
-	 * <li>if the script has one complete SQL statement per line, use
+	 * <li>if the script has one complete SQL statement per line, use {@code single-line} or
 	 *     {@link org.hibernate.tool.schema.internal.script.SingleLineSqlScriptExtractor}, or
-	 * <li>if a script contains statements spread over multiple lines, use
+	 * <li>if a script contains statements spread over multiple lines, use {@code multi-line} or
 	 *     {@link org.hibernate.tool.schema.internal.script.MultiLineSqlScriptExtractor}.
 	 * </ul>
 	 *
 	 * @settingDefault {@code org.hibernate.tool.schema.internal.script.SingleLineSqlScriptExtractor}.
 	 *
+	 * @see org.hibernate.tool.schema.spi.SqlScriptCommandExtractor
 	 * @see org.hibernate.tool.schema.internal.script.SingleLineSqlScriptExtractor
 	 * @see org.hibernate.tool.schema.internal.script.MultiLineSqlScriptExtractor
 	 */

hibernate-core/src/main/java/org/hibernate/tool/schema/internal/script/MultiLineSqlScriptExtractor.java

@@ -26,11 +26,14 @@
 import org.antlr.v4.runtime.misc.ParseCancellationException;
 
 /**
- * Class responsible for extracting SQL statements from import script. Supports instructions/comments and quoted
- * strings spread over multiple lines. Each statement must end with semicolon.
+ * Class responsible for extracting SQL statements from an import script.
+ * Supports instructions/comments and quoted strings spread over multiple lines.
+ * Each statement must end with a semicolon.
  *
  * @author Lukasz Antoniak
  * @author Steve Ebersole
+ *
+ * @see org.hibernate.cfg.SchemaToolingSettings#HBM2DDL_IMPORT_FILES_SQL_EXTRACTOR
  */
 public class MultiLineSqlScriptExtractor implements SqlScriptCommandExtractor {
 	public static final String SHORT_NAME = "multi-line";

hibernate-core/src/main/java/org/hibernate/tool/schema/internal/script/SingleLineSqlScriptExtractor.java

@@ -15,11 +15,14 @@
 import org.hibernate.tool.schema.spi.SqlScriptException;
 
 /**
- * Class responsible for extracting SQL statements from import script. Treats each line as a complete SQL statement.
- * Comment lines shall start with {@code --}, {@code //} or {@code /*} character sequence.
+ * Class responsible for extracting SQL statements from an import script.
+ * Treats each line as a complete SQL statement.
+ * Comment lines must start with {@code --}, {@code //}, or {@code /*}.
  *
  * @author Lukasz Antoniak
  * @author Steve Ebersole
+ *
+ * @see org.hibernate.cfg.SchemaToolingSettings#HBM2DDL_IMPORT_FILES_SQL_EXTRACTOR
  */
 public class SingleLineSqlScriptExtractor implements SqlScriptCommandExtractor {
 	public static final String SHORT_NAME = "single-line";

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

@@ -12,13 +12,20 @@
 
 /**
  * Contract for extracting statements from source/import/init scripts.
+ * <p>
+ * A concrete implementation may be selected via
+ * {@value org.hibernate.cfg.SchemaToolingSettings#HBM2DDL_IMPORT_FILES_SQL_EXTRACTOR}.
  *
  * @author Lukasz Antoniak
  *
- * @see org.hibernate.cfg.AvailableSettings#HBM2DDL_IMPORT_FILES
- * @see org.hibernate.cfg.AvailableSettings#JAKARTA_HBM2DDL_LOAD_SCRIPT_SOURCE
- * @see org.hibernate.cfg.AvailableSettings#JAKARTA_HBM2DDL_CREATE_SCRIPT_SOURCE
- * @see org.hibernate.cfg.AvailableSettings#JAKARTA_HBM2DDL_DROP_SCRIPT_SOURCE
+ * @see org.hibernate.cfg.SchemaToolingSettings#HBM2DDL_IMPORT_FILES_SQL_EXTRACTOR
+ * @see org.hibernate.tool.schema.internal.script.SingleLineSqlScriptExtractor
+ * @see org.hibernate.tool.schema.internal.script.MultiLineSqlScriptExtractor
+ *
+ * @see org.hibernate.cfg.SchemaToolingSettings#HBM2DDL_IMPORT_FILES
+ * @see org.hibernate.cfg.SchemaToolingSettings#JAKARTA_HBM2DDL_LOAD_SCRIPT_SOURCE
+ * @see org.hibernate.cfg.SchemaToolingSettings#JAKARTA_HBM2DDL_CREATE_SCRIPT_SOURCE
+ * @see org.hibernate.cfg.SchemaToolingSettings#JAKARTA_HBM2DDL_DROP_SCRIPT_SOURCE
  */
 public interface SqlScriptCommandExtractor extends Service {
 	/**