Polish @since tags

Closes gh-47779

Author: wilkinsona

core/spring-boot/src/main/java/org/springframework/boot/bootstrap/BootstrapRegistry.java

@@ -105,12 +105,12 @@ interface InstanceSupplier<T> {
 		 * bootstrap instances.
 		 * @return the instance or {@code null}
 		 */
-		@Nullable T get(BootstrapContext context);
+		@Nullable
+		T get(BootstrapContext context);
 
 		/**
 		 * Return the scope of the supplied instance.
 		 * @return the scope
-		 * @since 2.4.2
 		 */
 		default Scope getScope() {
 			return Scope.SINGLETON;
@@ -120,7 +120,6 @@ default Scope getScope() {
 		 * Return a new {@link InstanceSupplier} with an updated {@link Scope}.
 		 * @param scope the new scope
 		 * @return a new {@link InstanceSupplier} instance with the new scope
-		 * @since 2.4.2
 		 */
 		default InstanceSupplier<T> withScope(Scope scope) {
 			Assert.notNull(scope, "'scope' must not be null");
@@ -166,8 +165,6 @@ static <T> InstanceSupplier<T> from(@Nullable Supplier<T> supplier) {
 
 	/**
 	 * The scope of an instance.
-	 *
-	 * @since 2.4.2
 	 */
 	enum Scope {
 

core/spring-boot/src/main/java/org/springframework/boot/context/properties/PropertyMapper.java

@@ -383,7 +383,8 @@ public interface Adapter<T, R> {
 			 * @param value the value to adapt
 			 * @return an adapted value or {@code null}
 			 */
-			@Nullable R adapt(T value);
+			@Nullable
+			R adapt(T value);
 
 		}
 
@@ -502,7 +503,6 @@ private boolean test(T value) {
 			 *
 			 * @param <T> the source type
 			 * @param <R> the result type
-			 * @since 4.0.0
 			 */
 			@FunctionalInterface
 			public interface Adapter<T, R> {
@@ -512,7 +512,8 @@ public interface Adapter<T, R> {
 				 * @param value the value to adapt
 				 * @return an adapted value or {@code null}
 				 */
-				@Nullable R adapt(@Nullable T value);
+				@Nullable
+				R adapt(@Nullable T value);
 
 			}
 
@@ -521,7 +522,6 @@ public interface Adapter<T, R> {
 			 *
 			 * @param <T> the source type
 			 * @param <R> the result type
-			 * @since 4.0.0
 			 */
 			@FunctionalInterface
 			public interface Factory<T, R extends @Nullable Object> {
@@ -541,7 +541,6 @@ public interface Factory<T, R extends @Nullable Object> {
 			 *
 			 * @param <T> the source type
 			 * @param <R> the result type
-			 * @since 4.0.0
 			 */
 			@FunctionalInterface
 			public interface Mapper<R extends @Nullable Object, T> {

core/spring-boot/src/main/java/org/springframework/boot/support/EnvironmentPostProcessorsFactory.java

@@ -81,7 +81,6 @@ static EnvironmentPostProcessorsFactory of(String... classNames) {
 	 * @param classLoader the source class loader
 	 * @param classNames the post processor class names
 	 * @return an {@link EnvironmentPostProcessorsFactory} instance
-	 * @since 2.4.8
 	 */
 	static EnvironmentPostProcessorsFactory of(@Nullable ClassLoader classLoader, String... classNames) {
 		return new ReflectionEnvironmentPostProcessorsFactory(classLoader, classNames);

core/spring-boot/src/main/java/org/springframework/boot/web/servlet/support/ErrorPageFilter.java

@@ -197,7 +197,6 @@ private void forwardToErrorPage(String path, HttpServletRequest request, HttpSer
 	 * description based on the request {@code servletPath} and {@code pathInfo}.
 	 * @param request the source request
 	 * @return the description
-	 * @since 1.5.0
 	 */
 	protected String getDescription(HttpServletRequest request) {
 		String pathInfo = (request.getPathInfo() != null) ? request.getPathInfo() : "";
@@ -356,7 +355,8 @@ private void sendErrorIfNecessary() throws IOException {
 			}
 		}
 
-		@Nullable String getMessage() {
+		@Nullable
+		String getMessage() {
 			return this.message;
 		}
 

core/spring-boot/src/main/java/org/springframework/boot/web/servlet/support/SpringBootServletInitializer.java

@@ -190,7 +190,6 @@ private Log getLogger() {
 	 * the {@link SpringApplication}. The default implementation returns a new
 	 * {@code SpringApplicationBuilder} in its default state.
 	 * @return the {@code SpringApplicationBuilder}.
-	 * @since 1.3.0
 	 */
 	protected SpringApplicationBuilder createSpringApplicationBuilder() {
 		return new SpringApplicationBuilder();

loader/spring-boot-loader-tools/src/main/java/org/springframework/boot/loader/tools/AbstractJarWriter.java

@@ -166,7 +166,6 @@ public void writeNestedLibrary(String location, Library library) throws IOExcept
 	 * @param location the location of the index file
 	 * @param lines the lines to write
 	 * @throws IOException if the write fails
-	 * @since 2.3.0
 	 */
 	public void writeIndexFile(@Nullable String location, Collection<String> lines) throws IOException {
 		if (location != null) {
@@ -363,7 +362,8 @@ interface EntryTransformer {
 		 */
 		EntryTransformer NONE = (jarEntry) -> jarEntry;
 
-		@Nullable JarArchiveEntry transform(JarArchiveEntry jarEntry);
+		@Nullable
+		JarArchiveEntry transform(JarArchiveEntry jarEntry);
 
 	}
 

module/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/web/ManagementContextConfiguration.java

@@ -51,7 +51,6 @@
 	 * Specifies the type of management context that is required for this configuration to
 	 * be applied.
 	 * @return the required management context type
-	 * @since 2.0.0
 	 */
 	ManagementContextType value() default ManagementContextType.ANY;
 
@@ -75,7 +74,7 @@
 	 * "@Bean Lite Mode" (see {@link Bean @Bean's javadoc}). It is therefore behaviorally
 	 * equivalent to removing the {@code @Configuration} stereotype.
 	 * @return whether to proxy {@code @Bean} methods
-	 * @since 2.2
+	 * @since 2.2.0
 	 */
 	@AliasFor(annotation = Configuration.class)
 	boolean proxyBeanMethods() default true;

module/spring-boot-data-cassandra-test/src/main/java/org/springframework/boot/data/cassandra/test/autoconfigure/DataCassandraTest.java

@@ -66,7 +66,6 @@
 	 * Properties in form {@literal key=value} that should be added to the Spring
 	 * {@link Environment} before the test runs.
 	 * @return the properties to add
-	 * @since 2.1.0
 	 */
 	String[] properties() default {};
 

module/spring-boot-data-jpa-test/src/main/java/org/springframework/boot/data/jpa/test/autoconfigure/DataJpaTest.java

@@ -95,7 +95,6 @@
 	 * Properties in form {@literal key=value} that should be added to the Spring
 	 * {@link Environment} before the test runs.
 	 * @return the properties to add
-	 * @since 2.1.0
 	 */
 	String[] properties() default {};
 

module/spring-boot-data-ldap-test/src/main/java/org/springframework/boot/data/ldap/test/autoconfigure/DataLdapTest.java

@@ -69,7 +69,6 @@
 	 * Properties in form {@literal key=value} that should be added to the Spring
 	 * {@link Environment} before the test runs.
 	 * @return the properties to add
-	 * @since 2.1.0
 	 */
 	String[] properties() default {};