Doc: complementary info regarding GDAL_HTTP_HEADER_FILE

OSGeo · Mar 28, 2024 · a6c3b04 · a6c3b04
1 parent 98b61ea
commit a6c3b04
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 2 deletions.
diff --git a/doc/source/user/configoptions.rst b/doc/source/user/configoptions.rst
@@ -665,7 +665,8 @@ Networking options
       :choices: <filename>
       :since: 2.3
 
-      Filename of a text file with "key: value" HTTP headers.
+      Filename of a text file with "key: value" HTTP headers. The content of the
+      file is not cached, and thus it is read again before issuing each HTTP request.
 
 -  .. config:: GDAL_HTTP_CONNECTTIMEOUT
       :choices: <seconds>

diff --git a/port/cpl_http.cpp b/port/cpl_http.cpp
@@ -926,7 +926,8 @@ int CPLHTTPPopFetchCallback(void)
  * <li>HEADERS=val, where val is an extra header to use when getting a web page.
  *                  For example "Accept: application/x-ogcwkt"</li>
  * <li>HEADER_FILE=filename: filename of a text file with "key: value" headers.
- *     (GDAL >= 2.2)</li>
+ *     The content of the file is not cached, and thus it is read again before
+ *     issuing each HTTP request. (GDAL >= 2.2)</li>
  * <li>HTTPAUTH=[BASIC/NTLM/NEGOTIATE/ANY/ANYSAFE/BEARER] to specify an
  * authentication scheme to use.</li>
  * <li>USERPWD=userid:password to specify a user and password for