Add JavaDoc comments

Author: nakamura-to

doma-core/src/main/java/org/seasar/doma/jdbc/Config.java

@@ -226,6 +226,11 @@ default EntityListenerProvider getEntityListenerProvider() {
     return ConfigSupport.defaultEntityListenerProvider;
   }
 
+  /**
+   * Returns the context for SQL builder settings.
+   *
+   * @return the context for SQL builder settings
+   */
   default SqlBuilderSettings getSqlBuilderSettings() {
     return ConfigSupport.defaultSqlBuilderSettings;
   }

doma-core/src/main/java/org/seasar/doma/jdbc/SqlBuilderSettings.java

@@ -1,15 +1,35 @@
 package org.seasar.doma.jdbc;
 
+/** A context for SQL builder settings. */
 public interface SqlBuilderSettings {
 
+  /**
+   * Returns whether the block comment should be removed. The beginning of the {@code comment}
+   * parameter string must always start with "/*".
+   *
+   * @param comment the block comment, never null
+   * @return true if the block comment should be removed
+   */
   default boolean shouldRemoveBlockComment(String comment) {
     return false;
   }
 
+  /**
+   * Returns whether the line comment should be removed. The beginning of the {@code comment}
+   * parameter string must always start with "--".
+   *
+   * @param comment the line comment, never null
+   * @return true if the line comment should be removed
+   */
   default boolean shouldRemoveLineComment(String comment) {
     return false;
   }
 
+  /**
+   * Returns whether the blank lines should be removed.
+   *
+   * @return true if the blank lines should be removed
+   */
   default boolean shouldRemoveBlankLines() {
     return false;
   }