From: itzTanos29 <tanushnry@gmail.com>
Date: Fri, 10 Jul 2026 16:57:41 +0000 (-0400)
Subject: CURLOPT_HEADERFUNCTION.md: document folded header unfolding
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=fa246bf7f2b6096732ae9f53408363444b5865fe;p=thirdparty%2Fcurl.git

CURLOPT_HEADERFUNCTION.md: document folded header unfolding

Fixes #22296
Closes #22297
---

diff --git a/docs/libcurl/opts/CURLOPT_HEADERFUNCTION.md b/docs/libcurl/opts/CURLOPT_HEADERFUNCTION.md
index e89ec887f2..107e9e524c 100644
--- a/docs/libcurl/opts/CURLOPT_HEADERFUNCTION.md
+++ b/docs/libcurl/opts/CURLOPT_HEADERFUNCTION.md
@@ -92,10 +92,11 @@ curl_easy_header(3).
 
 # LIMITATIONS
 
-libcurl does not unfold HTTP "folded headers" (deprecated since RFC 7230). A
-folded header is a header that continues on a subsequent line and starts with
-a whitespace. Such folds are passed to the header callback as separate ones,
-although strictly they are continuations of the previous lines.
+For legacy HTTP/1 "folded headers" (deprecated since RFC 7230), libcurl
+unfolds the lines before calling the header callback. A folded header is a
+header that continues on a subsequent line and starts with whitespace. The
+callback gets the full single header with one whitespace between the lines.
+This unfolding is done since 8.18.0.
 
 # DEFAULT