Document placeholder and Ant-style pattern support for @Enable…Repositories.

See spring-projects/spring-data-commons#3366

Author: mp911de

spring-data-cassandra/src/main/java/org/springframework/data/cassandra/repository/config/EnableCassandraRepositories.java

@@ -56,8 +56,20 @@
 	String[] value() default {};
 
 	/**
-	 * Base packages to scan for annotated components. {@link #value()} is an alias for (and mutually exclusive with) this
-	 * attribute. Use {@link #basePackageClasses()} for a type-safe alternative to String-based package names.
+	 * Base packages to scan for annotated components.
+	 * <p>
+	 * {@link #value} is an alias for (and mutually exclusive with) this attribute.
+	 * <p>
+	 * Supports {@code ${…}} placeholders which are resolved against the {@link org.springframework.core.env.Environment
+	 * Environment} as well as Ant-style package patterns &mdash; for example, {@code "org.example.**"}.
+	 * <p>
+	 * Multiple packages or patterns may be specified, either separately or within a single {@code String} &mdash; for
+	 * example, {@code {"org.example.config", "org.example.service.**"}} or
+	 * {@code "org.example.config, org.example.service.**"}.
+	 * <p>
+	 * Use {@link #basePackageClasses} for a type-safe alternative to String-based package names.
+	 *
+	 * @see org.springframework.context.ConfigurableApplicationContext#CONFIG_LOCATION_DELIMITERS
 	 */
 	String[] basePackages() default {};
 

spring-data-cassandra/src/main/java/org/springframework/data/cassandra/repository/config/EnableReactiveCassandraRepositories.java

@@ -49,14 +49,26 @@
 
 	/**
 	 * Alias for the {@link #basePackages()} attribute. Allows for more concise annotation declarations e.g.:
-	 * {@code @EnableCassandraRepositories("org.my.pkg")} instead of
-	 * {@code @EnableCassandraRepositories(basePackages="org.my.pkg")}.
+	 * {@code @EnableReactiveCassandraRepositories("org.my.pkg")} instead of
+	 * {@code @EnableReactiveCassandraRepositories(basePackages="org.my.pkg")}.
 	 */
 	String[] value() default {};
 
 	/**
-	 * Base packages to scan for annotated components. {@link #value()} is an alias for (and mutually exclusive with) this
-	 * attribute. Use {@link #basePackageClasses()} for a type-safe alternative to String-based package names.
+	 * Base packages to scan for annotated components.
+	 * <p>
+	 * {@link #value} is an alias for (and mutually exclusive with) this attribute.
+	 * <p>
+	 * Supports {@code ${…}} placeholders which are resolved against the {@link org.springframework.core.env.Environment
+	 * Environment} as well as Ant-style package patterns &mdash; for example, {@code "org.example.**"}.
+	 * <p>
+	 * Multiple packages or patterns may be specified, either separately or within a single {@code String} &mdash; for
+	 * example, {@code {"org.example.config", "org.example.service.**"}} or
+	 * {@code "org.example.config, org.example.service.**"}.
+	 * <p>
+	 * Use {@link #basePackageClasses} for a type-safe alternative to String-based package names.
+	 *
+	 * @see org.springframework.context.ConfigurableApplicationContext#CONFIG_LOCATION_DELIMITERS
 	 */
 	String[] basePackages() default {};