Clarify Javadoc of Customizer interfaces about overriding behavior

The previous wording suggested that customizations always retain
default auto-configuration. Rephrased to indicate that configuration
can be fine-tuned, which more accurately reflects that some builder
methods may override or replace defaults.

See gh-46938

Signed-off-by: Seokjae Lee <[email protected]>

Author: doljae

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/batch/BatchConversionServiceCustomizer.java

@@ -23,7 +23,7 @@
  * Callback interface that can be implemented by beans wishing to customize the
  * {@link ConfigurableConversionService} that is
  * {@link DefaultBatchConfiguration#getConversionService provided by
- * DefaultBatchConfiguration} while retaining its default auto-configuration.
+ * DefaultBatchConfiguration} to fine-tune its auto-configuration.
  *
  * @author Claudio Nave
  * @since 3.1.0

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/cassandra/CqlSessionBuilderCustomizer.java

@@ -21,8 +21,8 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link CqlSession} through a {@link CqlSessionBuilder} whilst retaining default
- * auto-configuration.
+ * {@link CqlSession} through a {@link CqlSessionBuilder} to fine-tune
+ * its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 2.3.0

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/cassandra/DriverConfigLoaderBuilderCustomizer.java

@@ -21,8 +21,8 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link DriverConfigLoader} through a {@link DriverConfigLoaderBuilderCustomizer} whilst
- * retaining default auto-configuration.
+ * {@link DriverConfigLoader} through a {@link DriverConfigLoaderBuilderCustomizer}
+ * to fine-tune its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 2.3.0

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/couchbase/ClusterEnvironmentBuilderCustomizer.java

@@ -21,8 +21,8 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link ClusterEnvironment} through a {@link Builder ClusterEnvironment.Builder} whilst
- * retaining default auto-configuration.
+ * {@link ClusterEnvironment} through a {@link Builder ClusterEnvironment.Builder}
+ * to fine-tune its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 2.3.0

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/data/redis/ClientResourcesBuilderCustomizer.java

@@ -21,8 +21,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to customize the
- * {@link ClientResources} through a {@link Builder} whilst retaining default
- * auto-configuration.
+ * {@link ClientResources} through a {@link Builder} to fine-tune its auto-configuration.
  *
  * @author Stephane Nicoll
  * @since 2.6.0

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/data/redis/JedisClientConfigurationBuilderCustomizer.java

@@ -22,8 +22,8 @@
 /**
  * Callback interface that can be implemented by beans wishing to customize the
  * {@link JedisClientConfiguration} through a {@link JedisClientConfigurationBuilder
- * JedisClientConfiguration.JedisClientConfigurationBuilder} whilst retaining default
- * auto-configuration.
+ * JedisClientConfiguration.JedisClientConfigurationBuilder} to fine-tune
+ * its auto-configuration.
  *
  * @author Mark Paluch
  * @since 2.0.0

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/data/redis/LettuceClientConfigurationBuilderCustomizer.java

@@ -22,8 +22,8 @@
 /**
  * Callback interface that can be implemented by beans wishing to customize the
  * {@link LettuceClientConfiguration} through a {@link LettuceClientConfigurationBuilder
- * LettuceClientConfiguration.LettuceClientConfigurationBuilder} whilst retaining default
- * auto-configuration. To customize only the
+ * LettuceClientConfiguration.LettuceClientConfigurationBuilder} to fine-tune
+ * its auto-configuration. To customize only the
  * {@link LettuceClientConfiguration#getClientOptions() client options} of the
  * configuration, use {@link LettuceClientOptionsBuilderCustomizer} instead.
  *

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/data/redis/LettuceClientOptionsBuilderCustomizer.java

@@ -24,7 +24,7 @@
 /**
  * Callback interface that can be implemented by beans wishing to customize the
  * {@link ClientOptions} of the {@link LettuceClientConfiguration} through a
- * {@link Builder} whilst retaining default auto-configuration. To customize the entire
+ * {@link Builder} to fine-tune its auto-configuration. To customize the entire
  * configuration, use {@link LettuceClientConfigurationBuilderCustomizer} instead.
  *
  * @author Soohyun Lim

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/graphql/GraphQlSourceBuilderCustomizer.java

@@ -21,7 +21,7 @@
 /**
  * Callback interface that can be implemented by beans wishing to customize properties of
  * {@link org.springframework.graphql.execution.GraphQlSource.SchemaResourceBuilder
- * Builder} whilst retaining default auto-configuration.
+ * Builder} to fine-tune its auto-configuration.
  *
  * @author Rossen Stoyanchev
  * @since 2.7.0

spring-boot-project/spring-boot-autoconfigure/src/main/java/org/springframework/boot/autoconfigure/gson/GsonBuilderCustomizer.java

@@ -21,7 +21,7 @@
 
 /**
  * Callback interface that can be implemented by beans wishing to further customize the
- * {@link Gson} through {@link GsonBuilder} retaining its default auto-configuration.
+ * {@link Gson} through {@link GsonBuilder} to fine-tune its auto-configuration.
  *
  * @author Ivan Golovko
  * @since 2.0.0