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

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

diff --git a/spring-web/src/main/java/org/springframework/http/HttpHeaders.java b/spring-web/src/main/java/org/springframework/http/HttpHeaders.java
index 7ac9a382ca..5d895e4a36 100644
--- a/spring-web/src/main/java/org/springframework/http/HttpHeaders.java
+++ b/spring-web/src/main/java/org/springframework/http/HttpHeaders.java
@@ -83,6 +83,10 @@ import org.springframework.util.StringUtils;
  * over the old instance's {@code entrySet()} and using
  * {@link #addAll(String, List)} rather than {@link #put(String, List)}.
  *
+ * <p>This class is meant to reference "well-known" headers supported by Spring
+ * Framework. If your application or library relies on other headers defined in RFCs,
+ * please use methods that accept the header name as a parameter.
+ *
  * @author Arjen Poutsma
  * @author Sebastien Deleuze
  * @author Brian Clozel