Add deprecation notes to the WebMvc config schema

Closes spring-projectsgh-23915

spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/RequestMappingHandlerMapping.java

@@ -63,7 +63,8 @@
  * {@link #setUseRegisteredSuffixPatternMatch(boolean) useRegisteredSuffixPatternMatch}
  * are deprecated in order to discourage use of path extensions for request
  * mapping and for content negotiation (with similar deprecations in
- * {@link ContentNegotiationManager}). For further context, please read issue
+ * {@link org.springframework.web.accept.ContentNegotiationManagerFactoryBean
+ * ContentNegotiationManagerFactoryBean}). For further context, please read issue
  * <a href="https://github.com/spring-projects/spring-framework/issues/24179">#24719</a>.
  *
  * @author Arjen Poutsma

spring-webmvc/src/main/resources/org/springframework/web/servlet/config/spring-mvc.xsd

@@ -36,7 +36,14 @@
 								<xsd:documentation><![CDATA[
 	Whether to use suffix pattern match (".*") when matching patterns to requests. If enabled
 	a method mapped to "/users" also matches to "/users.*".
-	The default value is true.
+
+	In 5.2.4, suffix pattern matching was deprecated in order to discourage use of path
+	extensions for request mapping and for content negotiation (see deprecation notes on
+	org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping and on
+	org.springframework.web.accept.ContentNegotiationManagerFactoryBean and
+	also see https://github.com/spring-projects/spring-framework/issues/24179.
+
+	The default value is true but in 5.3 it changes to false.
 								]]></xsd:documentation>
 							</xsd:annotation>
 						</xsd:attribute>
@@ -56,6 +63,13 @@
 	explicitly registered when you configure content negotiation.
 	This is generally recommended to reduce ambiguity and to
 	avoid issues such as when a "." appears in the path for other reasons.
+
+	In 5.2.4, suffix pattern matching was deprecated in order to discourage use of path
+	extensions for request mapping and for content negotiation (see deprecation notes on
+	org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping and on
+	org.springframework.web.accept.ContentNegotiationManagerFactoryBean and
+	also see https://github.com/spring-projects/spring-framework/issues/24179.
+
 	The default value is false.
 								]]></xsd:documentation>
 							</xsd:annotation>