From: Daniel Stenberg <daniel@haxx.se>
Date: Tue, 13 Jan 2026 12:29:30 +0000 (+0100)
Subject: curl_easy_nextheader.md: a new transfer invalidates 'prev'
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=236c7d3c4d115795f87eb58aff3958bfb81e951e;p=thirdparty%2Fcurl.git

curl_easy_nextheader.md: a new transfer invalidates 'prev'

Closes #20285
---

diff --git a/docs/libcurl/curl_easy_nextheader.md b/docs/libcurl/curl_easy_nextheader.md
index c3dd223b8c..42314996b9 100644
--- a/docs/libcurl/curl_easy_nextheader.md
+++ b/docs/libcurl/curl_easy_nextheader.md
@@ -61,6 +61,10 @@ The memory for the struct this points to, is owned and managed by libcurl and
 is associated with the easy handle. Applications must copy the data if they
 want it to survive subsequent API calls or the life-time of the easy handle.
 
+The *prev* pointer is only valid until another transfer is done using the
+*easy* handle. Once a new transfer has started, a new *prev* must be retrieved
+by calling curl_easy_nextheader(3) again with NULL as the fourth argument.
+
 # %PROTOCOLS%
 
 # EXAMPLE