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 c3dd223b8c8cffb4b3bfb44e1ce9cdd0672c1055..42314996b939cf7bf9bcaa85cd2901d2c280cdfb 100644 (file)
--- 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