From e919d0adcce45625154e73d3d54fa59ebe18fbe6 Mon Sep 17 00:00:00 2001
From: Brian Clozel <brian.clozel@broadcom.com>
Date: Mon, 18 Nov 2024 11:49:52 +0100
Subject: [PATCH] Reflect well-known MediaTypes intent in Javadoc

Closes gh-33754
---
 .../src/main/java/org/springframework/http/MediaType.java     | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/spring-web/src/main/java/org/springframework/http/MediaType.java b/spring-web/src/main/java/org/springframework/http/MediaType.java
index f2fa5b61ed..ff27cb0ea3 100644
--- a/spring-web/src/main/java/org/springframework/http/MediaType.java
+++ b/spring-web/src/main/java/org/springframework/http/MediaType.java
@@ -39,6 +39,10 @@ import org.springframework.util.StringUtils;
  * A subclass of {@link MimeType} that adds support for quality parameters
  * as defined in the HTTP specification.
  *
+ * <p>This class is meant to reference media types supported by Spring Framework.
+ * If your application or library relies on other media types defined in RFCs,
+ * please use {@link #parseMediaType(String)} or a custom utility class.
+ *
  * @author Arjen Poutsma
  * @author Juergen Hoeller
  * @author Rossen Stoyanchev