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 {

spring-web/src/main/java/org/springframework/web/util/CookieGenerator.java

@@ -29,15 +29,13 @@ import org.springframework.util.Assert;
  * as bean properties and being able to add and remove cookie to/from a
  * given response.
  *
- * <p>Can serve as base class for components that generate specific cookies,
- * such as CookieThemeResolver.
+ * <p>Can serve as base class for components that generate specific cookies.
  *
  * @author Juergen Hoeller
  * @since 1.1.4
  * @see #addCookie
  * @see #removeCookie
- * @see org.springframework.web.servlet.theme.CookieThemeResolver
- * @deprecated since 6.0 in favor of {@link org.springframework.http.ResponseCookie}
+ * @deprecated as of 6.0 in favor of {@link org.springframework.http.ResponseCookie}
  */
 @Deprecated
 public class CookieGenerator {

spring-webmvc/src/main/java/org/springframework/web/servlet/ThemeResolver.java

@@ -45,7 +45,7 @@ import org.springframework.lang.Nullable;
  * @since 17.06.2003
  * @see org.springframework.ui.context.Theme
  * @see org.springframework.ui.context.ThemeSource
- * @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 ThemeResolver {

spring-webmvc/src/main/java/org/springframework/web/servlet/theme/AbstractThemeResolver.java

@@ -25,7 +25,7 @@ import org.springframework.web.servlet.ThemeResolver;
  * @author Juergen Hoeller
  * @author Jean-Pierre Pawlak
  * @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 abstract class AbstractThemeResolver implements ThemeResolver {

spring-webmvc/src/main/java/org/springframework/web/servlet/theme/CookieThemeResolver.java

@@ -39,7 +39,7 @@ import org.springframework.web.util.WebUtils;
  * @author Juergen Hoeller
  * @since 17.06.2003
  * @see #setThemeName
- * @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 CookieThemeResolver extends CookieGenerator implements ThemeResolver {

spring-webmvc/src/main/java/org/springframework/web/servlet/theme/FixedThemeResolver.java

@@ -33,7 +33,7 @@ import org.springframework.lang.Nullable;
  * @author Juergen Hoeller
  * @since 17.06.2003
  * @see #setDefaultThemeName
- * @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 FixedThemeResolver extends AbstractThemeResolver {

spring-webmvc/src/main/java/org/springframework/web/servlet/theme/SessionThemeResolver.java

@@ -36,7 +36,7 @@ import org.springframework.web.util.WebUtils;
  * @author Juergen Hoeller
  * @since 17.06.2003
  * @see #setThemeName
- * @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 SessionThemeResolver extends AbstractThemeResolver {

spring-webmvc/src/main/java/org/springframework/web/servlet/theme/ThemeChangeInterceptor.java

@@ -31,7 +31,7 @@ import org.springframework.web.servlet.support.RequestContextUtils;
  * @author Juergen Hoeller
  * @since 20.06.2003
  * @see org.springframework.web.servlet.ThemeResolver
- * @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 ThemeChangeInterceptor implements HandlerInterceptor {

src/docs/asciidoc/web/webmvc.adoc

@@ -1052,6 +1052,9 @@ application, thereby enhancing user experience. A theme is a collection of stati
 resources, typically style sheets and images, that affect the visual style of the
 application.
 
+WARNING: as of 6.0 support for themes has been deprecated theme in favor of using CSS,
+and without any special support on the server side.
+
 
 [[mvc-themeresolver-defining]]
 ==== Defining a theme