Polishing contribution and Theme deprecation notices

Closes gh-28870

spring-context/src/main/java/org/springframework/ui/context/HierarchicalThemeSource.java

@@ -24,7 +24,7 @@ import org.springframework.lang.Nullable;
  *
  * @author Jean-Pierre Pawlak
  * @author Juergen Hoeller
- * @deprecated as of 6.0, with no concrete replacement
+ * @deprecated as of 6.0 in favor of using CSS, without direct replacement
  */
 @Deprecated(since = "6.0")
 public interface HierarchicalThemeSource extends ThemeSource {

spring-context/src/main/java/org/springframework/ui/context/Theme.java

@@ -28,7 +28,7 @@ import org.springframework.context.MessageSource;
  * @since 17.06.2003
  * @see ThemeSource
  * @see org.springframework.web.servlet.ThemeResolver
- * @deprecated as of 6.0, with no direct replacement
+ * @deprecated as of 6.0 in favor of using CSS, without direct replacement
  */
 @Deprecated(since = "6.0")
 public interface Theme {

spring-context/src/main/java/org/springframework/ui/context/ThemeSource.java

@@ -26,7 +26,7 @@ import org.springframework.lang.Nullable;
  * @author Jean-Pierre Pawlak
  * @author Juergen Hoeller
  * @see Theme
- * @deprecated as of 6.0, with no direct replacement
+ * @deprecated as of 6.0 in favor of using CSS, without direct replacement
  */
 @Deprecated(since = "6.0")
 public interface ThemeSource {

spring-context/src/main/java/org/springframework/ui/context/support/DelegatingThemeSource.java

@@ -31,7 +31,7 @@ import org.springframework.ui.context.ThemeSource;
  * @author Juergen Hoeller
  * @since 1.2.4
  * @see UiApplicationContextUtils
- * @deprecated as of 6.0, with no direct replacement
+ * @deprecated as of 6.0 in favor of using CSS, without direct replacement
  */
 @Deprecated(since = "6.0")
 public class DelegatingThemeSource implements HierarchicalThemeSource {

spring-context/src/main/java/org/springframework/ui/context/support/ResourceBundleThemeSource.java

@@ -42,7 +42,7 @@ import org.springframework.ui.context.ThemeSource;
  * @see #setBasenamePrefix
  * @see java.util.ResourceBundle
  * @see org.springframework.context.support.ResourceBundleMessageSource
- * @deprecated as of 6.0, with no direct replacement
+ * @deprecated as of 6.0 in favor of using CSS, without direct replacement
  */
 @Deprecated(since = "6.0")
 public class ResourceBundleThemeSource implements HierarchicalThemeSource, BeanClassLoaderAware {

spring-context/src/main/java/org/springframework/ui/context/support/SimpleTheme.java

@@ -26,7 +26,7 @@ import org.springframework.util.Assert;
  *
  * @author Juergen Hoeller
  * @since 17.06.2003
- * @deprecated as of 6.0, with no concrete replacement
+ * @deprecated as of 6.0 in favor of using CSS, without direct replacement
  */
 @Deprecated(since = "6.0")
 public class SimpleTheme implements Theme {

spring-context/src/main/java/org/springframework/ui/context/support/UiApplicationContextUtils.java

@@ -31,7 +31,7 @@ import org.springframework.ui.context.ThemeSource;
  * @author Jean-Pierre Pawlak
  * @author Juergen Hoeller
  * @since 17.06.2003
- * @deprecated as of 6.0, with no direct replacement
+ * @deprecated as of 6.0 in favor of using CSS, without direct replacement
  */
 @Deprecated(since = "6.0")
 public abstract class UiApplicationContextUtils {